Payments
Dedicated Virtual Accounts
In a nutshell
Reference information for reusable customer-linked virtual accounts on Paystack.
Info
Dedicated Virtual Accounts settle in NGN.
This feature requires your business to have completed the go-live process.
Dedicated Virtual Accounts (DVAs) are reusable bank account numbers assigned to individual customers. When a transfer lands in a customer's DVA, Paystack automatically records it as a transaction from that customer.
Copy linkWhat DVAs are
A DVA is a persistent virtual account used for repeated inbound transfers. It is available on the Paystack Dashboard and API and is designed for businesses that want account-based payments tied to a known customer record.
DVAs suit wallet top-ups, repeat deposits, and customers who prefer bank transfers to cards. Each customer keeps a stable payment destination, so you don't generate a new payment instruction for every payment.
Copy linkSupported banks and providers
DVA creation uses supported providers returned by the Fetch Providers endpoint. Paystack does not hard-code the bank list in the product guide; the available provider set depends on the merchant's market and enabled DVA providers.
Inbound transfer approval is available only on Paystack-Titan Virtual Accounts.
Copy linkCustomer assignment model
A DVA is assigned to a customer record. In the multi-step model, the flow consists of:
- Creating or updating the customer record with identity details
- Validating the customer where compliance requires it
- Creating the Dedicated Virtual Account for that customer
For businesses in the Betting, Financial Services, or General Services categories, validate the customer's identity before generating the account. Customer consent is also required because DVA creation uses personal customer information.
In the single-step model, Paystack handles customer creation, validation where needed, and account assignment in one request.
Copy linkAccount behavior
- Incoming transfers are reported through
charge.success - Successful assignment is reported through
dedicatedaccount.assign.success - Failed assignment is reported through
dedicatedaccount.assign.failed - Customer requery is rate-limited to one request every 10 minutes
- Default account creation limit is 1,000 dedicated bank accounts per business, subject to review for increase
When an account is created, the account name generally follows the format Product Name / Customer Name.
For the operational setup flow, see Create and Assign Dedicated Virtual Accounts.
Copy linkHow DVAs differ from regular bank transfers
The main difference between DVAs and Pay with Transfer is lifespan and ownership.
| Feature | Dedicated Virtual Accounts | Pay with Transfer |
|---|---|---|
| Account scope | Customer-level | Transaction-level |
| Reuse | Reusable | Expires after payment or timeout |
| Matching | Always linked to assigned customer | Linked to one active charge |
| Typical use | Wallet funding, repeat deposits, account-based reconciliation | One-off checkout transfers |