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
Create Virtual Account
Header parameters
authorizationstringOptional
Authorization header containing your API Token
x-alg-noncestringOptional
Nonce used to generate the payload signature
x-alg-signaturestringOptional
Payload signature
datestringOptional
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
productCodestringRequiredExample:
The product code for the account requested
FIAT_ACCOUNT_UK_V1
Responses
200
Account successfully created
application/json
400
Input validation error
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
post
POST /v1/partner/accounts/virtual HTTP/1.1
Host: api-url
Content-Type: application/json
Accept: */*
Content-Length: 201
{
"customerId": "123e4567-e89b-12d3-a456-426614174000",
"idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
"parentAccountId": "123e4567-e89b-12d3-a456-426614174000",
"productCode": "FIAT_ACCOUNT_UK_V1"
}
{
"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-06-30T22:08:02.893Z",
"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
}
}
Last updated
Was this helpful?