Activating a Virtual Account

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

Request

PATCH /accounts/ACCOUNT-ID/virtual-accounts/activate

Where the :accountId is the ID of the Volt Account that the received funds will be credited to.

Response

The response will look like the following:

PATCH /api/accounts/identification-set/:accountId/fetch
{
    "id": "65a4c575-df83-41f6-8333-21068b2a6864"
    "currencies": {
        "EUR" : {
            "accountIdentifiers":[
                {
                   "iban": "DK2450517187342686",
                },
                {
                   "iban": "DE2450517187342686",
                },
                {
                   "iban": "LU70408000005999999",
                },
                {
                   "iban": "GB64SAPY60838250999999",
                }
            ]
        }
    },
    "name": "Test Virtual Account",
    "customerId": "245c3f12-cdad-45a7-a73a-8060822af9da",
    "accountId": "4b5ca2ac-4388-49e6-8439-de2c80a62e3f",
    "status": "active/deactivated/inactive"
}
Field Type Notes
id uuid Id of the Virtual Account
currencies object Currency of the Volt Account & Virtual Account
accountIdentifiers.iban string IBAN of the Virtual Account
name string Name of the Virtual Account
customerId uuid Your Volt Id
accountId uuid Volt Account Id
status string

Active: The Virtual Account is fully functional and able to receive incoming payments.

Deactivated: The Virtual Account was previously active but is now disabled and cannot accept payments.

Inactive: The Virtual Account has not yet been activated and is not currently set up to receive payments.
This endpoint should always return
active.

As we continue to enhance this functionality, please reach out to support@volt.io for the latest detailed information.