Loading...
Virtual IBANs

Activation of a Virtual IBAN

How to activate and fetch new Virtual Account numbers.


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

Request

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

NOTE – the below endpoint is available only in PRODUCTION, this is not available in SANDBOX.

PATCH /accounts/{accountId}/virtual-accounts/activate
{
    "numberOfVirtualAccounts": 2
}

Response

The response will look like the following:

[
    {
        "id": "06949674-d65c-4266-a2c6-23bce4a80a81",
        "currencies": {
            "EUR": {
                "accountIdentifiers": [
                    {
                        "iban": "DK2450517187342686"
                    },
                    {
                        "iban": "DE2450517187342686"
                    },
                    {
                        "iban": "LU70408000005999999"
                    },
                    {
                        "iban": "GB64SAPY60838250999999"
                    }
                ]
            }
        },
        "name": "name",
        "customerId": "0fadd711-a97d-4b8e-87d1-cd240e5b5846",
        "accountId": "ce862ef6-2313-40c0-b5e0-3328de199b9d",
        "status": "active"
    },
    {
        "id": "2158b419-f435-48a9-bf57-decdb6d72ef6",
        "currencies": {
            "EUR": {
                "accountIdentifiers": [
                   {
                        "iban": "DK3230517187342686"
                    },
                    {
                        "iban": "DE1230517187342686"
                    },
                    {
                        "iban": "LU72608000005999999"
                    },
                    {
                        "iban": "GB64SAPY60838250555555"
                    }
                ]
            }
        },
        "name": "name 2",
        "customerId": "0fadd711-a97d-4b8e-87d1-cd240e5b5846",
        "accountId": "ce862ef6-2313-40c0-b5e0-3328de199b9d",
        "status": "active"
    }
]
FieldTypeNotes
iduuidId of the Virtual Account
currenciesobjectCurrency of the Volt Account & Virtual Account
accountIdentifiers.ibanstringIBAN of the Virtual Account
namestringName of the Virtual Account
customerIduuidYour Volt Id
accountIduuidVolt Account Id
statusstringActive: 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.

How is this guide?

Last updated on

On this page