Virtual Accounts

Virtual accounts requires an existing primary account as a parent, and it uses the same currency and safe-guarding relationship as the parent account.

You can create multiple virtual accounts linked with the same primary account, and move funds between:

• Virtual account to virtual account

• Virtual account to parent primary account

• Parent primary account to virtual account

You need an existing Primary Account in order to create a virtual account

Create Virtual Account

Create a virtual account

post

/v1/partner/accounts/virtual

Header parameters

authorizationstring

Authorization header containing your API Token

x-alg-noncestring

Nonce used to generate the payload signature

x-alg-signaturestring

Payload signature

datestring

Date of the request un UTC/GMT

Body

customerIdstring uuidrequired

idempotencyKeystring uuidrequired

A unique idempotency key to prevent duplicate operations

parentAccountIdstring uuidrequired

The parent account id for the account requested

productCodestringrequired

The product code for the account requested

Example: FIAT_ACCOUNT_UK_V1

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'api-url/v1/partner/accounts/virtual' \
  --header 'Content-Type: application/json' \
  --data '{"customerId":"123e4567-e89b-12d3-a456-426614174000","idempotencyKey":"123e4567-e89b-12d3-a456-426614174000","parentAccountId":"123e4567-e89b-12d3-a456-426614174000","productCode":"FIAT_ACCOUNT_UK_V1"}'

200

400

401

403

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "partnerId": "123e4567-e89b-12d3-a456-426614174000",
  "primaryAccountId": "123e4567-e89b-12d3-a456-426614174000",
  "type": "PRIMARY",
  "currencyCode": "GBP",
  "createDate": "2025-02-12T11:11:13.750Z",
  "identifiers": [
    {
      "type": "UK_ACCOUNT",
      "beneficiary": "text",
      "bankAddress": "text",
      "data": {
        "type": "UK_ACCOUNT",
        "sortCode": "010102",
        "accountNumber": "12345678"
      }
    }
  ],
  "state": "INITIALIZING",
  "balance": {
    "currency": "GBP",
    "availableBalance": 1,
    "ledgerBalance": 1,
    "pendingCredits": 1
  }
}

Account successfully created