Sign in

Payments

Dedicated Virtual Accounts

View as Markdown

In a nutshell

Reusable customer-linked virtual accounts on Paystack in Ghana.

Info

Dedicated Virtual Accounts in Ghana settle in GHS. 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:

  1. Creating or updating the customer record with identity details
  2. Validating the customer where compliance requires it
  3. Creating the Dedicated Virtual Account for that customer

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.

Was this page helpful?