Skip to main content

Dynamic virtual account

POST/api/merchant/virtual-account/dynamic

create a short-lived dynamic virtual account

Request​

Request body (required)

{
  "accountName": "Order INV-1001",
  "amount": 50000
}

Responses

201 Dynamic account created

Example response

{
  "message": "dynamic account created successfully",
  "response": {
    "id": "66c9b4b736d142b900000001",
    "accountNumber": "0123456789",
    "accountName": "Order INV-1001",
    "bankName": "Aella Microfinance Bank",
    "currency": "NGN",
    "expectedAmount": 50000,
    "status": "active",
    "expiresAt": "2026-08-24T12:30:00.000Z",
    "providerBalance": 0,
    "onchainBalance": 0,
    "createdAt": "2026-08-24T12:00:00.000Z",
    "updatedAt": "2026-08-24T12:00:00.000Z"
  }
}