OPEN BANKING DOCSOpen virtual account (Open Banking v2)
Create a virtual account for an existing customer. Charges a per-call fee from the debit account to the settlement account. Idempotent per customerId using idempotencyKey.
X-API-Key<token>
In: header
Header Parameters
X-API-Keystring
API key for the application
X-App-Idstring
UUID of the application
Format
uuidappIdstring
Application ID
Format
uuidcustomerIdstring
Customer ID for virtual account creation
Format
uuiddebitAccountNumberstring
Account number to debit fee from (must belong to appId)
Match
^[0-9]{10}$currencystring
Currency code
Value in
"NGN" | "USD" | "EUR" | "GBP"idempotencyKey?string | null
Optional idempotency key for duplicate prevention
customerImageBase64?string | null
Base64-encoded customer image (optional, for future retail accounts)
customerSignatureBase64?string | null
Base64-encoded customer signature (optional, for future retail accounts)
Response Body
curl -X POST "https://virtual-accounts-api.vantacrest.com/company/v1/open-banking/v2/accounts/open" \ -H "X-API-Key: string" \ -H "X-App-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "appId": "28c365d5-df94-4a54-8217-3ce51d068868", "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac", "debitAccountNumber": "string", "currency": "NGN" }'{
"data": {
"customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
"accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",
"accountNumber": "string",
"accountName": "string",
"feeApplied": true,
"feeAmount": 0,
"feeCurrency": "string",
"feeTransactionId": "string",
"settlementStatus": "PENDING",
"correlationId": "string"
}
}{
"success": true,
"message": "string",
"data": {},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": true,
"message": "string",
"data": {},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": true,
"message": "string",
"data": {},
"timestamp": "2019-08-24T14:15:22Z"
}