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 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/ACCOUNT-ID/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"
    }
]
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.

← Previous Introduction to Volt Virtual IBANs
Next → Reversal notifications