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
Authorization header containing your API Token
Nonce used to generate the payload signature
Payload signature
Date of the request un UTC/GMT
Customer ID that will be the account owner.
a2b9649e-df7f-4349-adff-1c57283fef10
A unique idempotency key to prevent duplicate account creation.
1483d25d-3f00-4d39-90ce-2379a130becd
The parent account ID under which the virtual account will be created.
e0cab2dd-739f-43de-b131-3e423e935bf1
The product code for the virtual account being created.
FIAT_ACCOUNT_UK_V1
Account successfully created
Input validation error
Unauthorized
Forbidden
POST /v1/partner/accounts/virtual HTTP/1.1
Host: api-url
Content-Type: application/json
Accept: */*
Content-Length: 201
{
"customerId": "a2b9649e-df7f-4349-adff-1c57283fef10",
"idempotencyKey": "1483d25d-3f00-4d39-90ce-2379a130becd",
"parentAccountId": "e0cab2dd-739f-43de-b131-3e423e935bf1",
"productCode": "FIAT_ACCOUNT_UK_V1"
}
{
"id": "e0cab2dd-739f-43de-b131-3e423e935bf1",
"customerId": "a2b9649e-df7f-4349-adff-1c57283fef10",
"partnerId": "2ecf0e23-3215-462c-97c4-9e5a147656d7",
"primaryAccountId": "ae66fcb2-2852-4568-990d-accc78572e4d",
"type": "VIRTUAL",
"currencyCode": "GBP",
"createDate": "2025-01-01",
"identifiers": [
{
"type": "UK_ACCOUNT",
"beneficiary": "John Doe",
"bankAddress": "Squire Patton Boggs, No.1 Spinningfields, Hardman Square, Manchester, M3 3EB",
"data": {
"type": "UK_ACCOUNT",
"sortCode": "010102",
"accountNumber": "12345678"
}
}
],
"state": "READY",
"balance": {
"currency": "GBP",
"availableBalance": 1,
"ledgerBalance": 1,
"pendingCredits": 1
}
}
Last updated
Was this helpful?