curl --request POST \
--url https://api.platnova.com/v1/virtual-accounts/dynamic \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"customer_id": "aad8aff0-00db-48b0-9bb0-9b399c313438",
"amount": 200,
"lifespan_minutes": 20
}
'{
"status": true,
"data": {
"account_name": "PLATNOVA TECHNOLOGIES LTD/PLATNOVA ",
"account_no": "9000043059",
"amount": 200,
"currency": "ngn",
"bank_name": "BEAMER (GABSYN) MICROFINANCE BANK",
"reference": "BDEPSTbdpLERjSmvg2XbF9iTA0bXxrX8E88BOI",
"email": "[email protected]",
"expires_at": "2026-03-19T23:13:03.140476016Z",
"payment_session_id": "",
"usage": "integration",
"created_at": "2026-03-19T22:53:03.140476016Z",
"customer_id": "aad8aff0-00db-48b0-9bb0-9b399c313438",
"customer_reference": "CUST-10293",
"order_reference": "ORDER-7781"
},
"error": [],
"message": "operation was successful"
}Generate Dynamic Virtual Account
Generate a single-use NGN account for a customer, for an amount and a lifespan. Add reference (your order id) to give each order its own account: the payment notification then names the order. Without reference, a customer has one open account per bank at a time and a repeat request for the same amount returns it; another amount gets a new account.
curl --request POST \
--url https://api.platnova.com/v1/virtual-accounts/dynamic \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"customer_id": "aad8aff0-00db-48b0-9bb0-9b399c313438",
"amount": 200,
"lifespan_minutes": 20
}
'{
"status": true,
"data": {
"account_name": "PLATNOVA TECHNOLOGIES LTD/PLATNOVA ",
"account_no": "9000043059",
"amount": 200,
"currency": "ngn",
"bank_name": "BEAMER (GABSYN) MICROFINANCE BANK",
"reference": "BDEPSTbdpLERjSmvg2XbF9iTA0bXxrX8E88BOI",
"email": "[email protected]",
"expires_at": "2026-03-19T23:13:03.140476016Z",
"payment_session_id": "",
"usage": "integration",
"created_at": "2026-03-19T22:53:03.140476016Z",
"customer_id": "aad8aff0-00db-48b0-9bb0-9b399c313438",
"customer_reference": "CUST-10293",
"order_reference": "ORDER-7781"
},
"error": [],
"message": "operation was successful"
}Overview
Generate a single-use NGN account for a customer, for an amount and a lifespan (5 to 1440 minutes). Show the payer the account, the amount andexpires_at.
customer_id can be our customer id or your own; with the customer’s details in the request, a new customer is created under your id (see Use your own customer ids; on this route customer_date_of_birth is always required for a new customer).
The bank
Dynamic accounts open at Nombank MFB. Show the payer thebank_name from the response.
A Nombank dynamic account takes exactly amount and stops accepting payments at expires_at: the payer’s bank refuses any other amount and any late transfer.
- Nombank opens an account only against the customer’s BVN or NIN. Send the BVN as
id_number(11 digits) when none is on file; it is used for this account. A BVN other than the one verified for the customer answers409customer_id_conflict. With no BVN or NIN at all:422identity_required,data.fieldid_number. - Nombank holds at most two accounts per BVN or NIN. Leave
bankout and a customer at that limit gets a Paga account in the same request (bank_namePaga; a Paga account adds its collection fee to what the payer sends). With"bank": "nombank"the answer is422nomba_identity_limit. - Nombank can’t be reached, or didn’t confirm the account:
503issuing_unavailable, retryable. No account is given to you; retry with the samereference, and contact support if it persists. bankother thannombankorpaga:400invalid_bank.
reference, a customer has one open account at a time, whichever bank opened it; a repeat for the same amount returns it, and a different amount gets a new account.
Order reference
Send your order id asreference (or order_reference) to give the order its own account. The response returns it as order_reference, and account.funded carries it as reference, with expected_amount. Repeating the request with the same reference, customer and amount while the account is open returns the same account. Any other reuse answers 400 duplicate_reference (data.status expired once the account has expired). Without reference, a customer has one open account per bank at a time: a repeat for the same amount returns it, and a different amount gets a new account (the earlier one still credits whatever is paid into it).
A payment of a different amount, or after expires_at, is still credited; a late one is marked "late": true on the webhook. See Collecting payments per order.Body
Name the customer with customer_id or customer_reference (exactly one is required). The customer_* fields are read only when the customer does not exist yet.
Required unless you send customer_reference. Our customer id, or your own id for the customer. We look it up within your business: our id first, then a customer whose reference is this value. If neither matches and the request carries the customer's details (customer_* fields), the customer is created with this value as their reference (1 to 64 characters: letters, digits, and _ . : -). Without details, an unknown id answers 400 customer was not found.
"CUST-10293"
New customer: required. A valid email address, unique among your customers.

