Api reference
Create a 30-minute dynamic virtual account
POST/api/merchant/virtual-account/dynamic
Create a 30-minute dynamic virtual account
Request
Request body (required)
Prop
Type
{ "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": "Example 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" }}