Create Dynamic Virtual Account

POST

/api/v1/virtual-accounts/create/dynamic

Creates a temporary virtual account for a single collection; can be amount-bound and expires after a validity window.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Account created.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://merchantapi-dev.vantpay.io/api/v1/virtual-accounts/create/dynamic' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "firstName": "Jamiu",
    "lastName": "Abimbade",
    "phoneNumber": "09030201535",
    "amount": 20000,
    "paymentReference": "ORD-260909-0012",
    "validityMinutes": 30
}'

Response Example

{
    "isSuccessful": true,
    "code": "00",
    "message": "Operation successful",
    "data": {
        "accountNumber": "9000594200",
        "accountName": "Abimbade Jamiu - Ennovate",
        "bank": "Digitvant Microfinance Bank Ltd",
        "expiryDate": "2026-09-09T16:30:00"
    }
}

Modified at 2026-09-10 13:32:03

Create Static Virtual Account

List Static Virtual Accounts