Documentation
Virtual Accounts

Virtual Accounts

Through the virtual account APIs, you can create virtual bank accounts for your customers. Currently, only Nigerian virtual bank accounts can be created with the option of SAFEHAVEN MFB and PROVIDUS banks.

Account Types

Virtual accounts can be created for both individual and business customers.

  • Individual (default) — created using the customer's first and last name.
  • Business — created using the business legal name. Requires rcNumber (business registration number) and businessLegalName to be provided in the request.

To create a business virtual account, set the type field to BUSINESS in the create request.

Get a Virtual Account

To get a virtual account, only the id of the virtual account is required

Get all Virtual Accounts

You can retrieve a list of all virtual accounts

Get transactions on a virtual account

You can retrieve the transactions on a specific virtual account using the id of that virtual account.