Api reference
Get a dynamic virtual account state
GET/api/merchant/virtual-account/dynamic/{dynamicAccountId}
Dashboard clients should poll every 3–5 seconds only while status is active or paid. Stop polling when it reaches synced, expired, or failed.
Request
Parameters
Prop
Type
Responses
200 Dynamic account
Example response
{ "message": "dynamic account fetched", "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" }}