Home › Volt Accounts › Virtual Accounts › Activate and deactivate

Activate a Virtual Account

Once Volt confirms successful registration of your Virtual Accounts, you can start to use them to receive funds.  In order to fetch and activate a new Virtual Account number, please use the following

Request

PATCH /api/accounts/identification-set/:accountId/fetch

Where the :accountId is the ID of the Volt Account that the received funds will be credited to – we will provide you with this ID.

Response

The response will look like the following:

PATCH /api/accounts/identification-set/:accountId/fetch 
{
    "identificationSetId": "fbe8bd5d-13a4-4f73-aff4-1847005c3768",
    "name": "fbe8bd5d-13a4-4f73-aff4-1847005c3768",
    "defaultIdentificationId": "ee740b95-31ba-4237-b9e8-6f6c87fd0fb2",
    "accountIdentifications": [
        {
            "id": "b79dee05-365c-434a-ba67-7b5e5211da99",
            "identifications": {
                "iban": "DE40202208000050999999"
            }
        },
        {
            "id": "c38647ef-8dca-4f3d-8853-7195ebb83994",
            "identifications": {
                "iban": "DK6089000050999999"
            }
        },
        {
            "id": "ee740b95-31ba-4237-b9e8-6f6c87fd0fb2",
            "identifications": {
                "iban": "GB64SAPY60838250999999"
            }
        },
        {
            "id": "ee750b95-31ba-42b7-b9e8-6f6c87fd0fb3",
            "identifications": {
                "iban": "LU70408000005999999"
            }
        }
    ]
}
Key fields
  • identificationSetId – the ID we assigned to this identification set. Store it in your system for reconciliation purposes outlined below. This is what we refer to as a vIBAN.
  • name – defaulted to the same ID now, however in the future we might create the functionality to name Virtual Accounts
  • defaultIdentificationId – will be the “main” identifier used for this Virtual Account from the list below. This doesn’t impact processing in any way.
  • accountIdentifications – a set of an ID and all of the reference numbers assigned to the Virtual Account. Those will mostly be in the IBAN format, but can also be account numbers, sort codes or any other routing information used in your local market.
Important note

Once a Virtual Account is retrieved from this endpoint, it is marked as active by Volt. Any setup or monthly fee will take effect from this moment. It is therefore advised to fetch them dynamically, when needed.

On your end, you can now simply assign a given identificationSetId to your customer.  You will also need to decide which of the specific Virtual Account numbers to provide to the user.  If your customer is located in one of the 4 countries above we recommend you provide them with the corresponding number.  If not, it is recommended to use a DE or DK vIBAN.

Deactivate a Virtual Account

In cases where a user closes their account with you and you do not want to repurpose the Virtual Account number for future accounts, you can deactivate a Virtual Account.  Please be aware that if you end up receiving credits to this Virtual Account anyway we will automatically return them and charge you an additional rejection fee specified in your contract.

In order to do this you need to use the following endpoint:

PATCH /api/accounts/identification-set/:id/deactivate

Where: id – is the id of the identification-set you wish to deactivate

← Previous Introduction to Virtual Accounts
Next → Reconciling credits