POST
/
collection
/
virtual-accounts

Virtual Accounts provide a flexible and efficient way to manage financial transactions for both businesses and individuals. They are designed to meet organizational and personal needs.

​
Corporate (Business)

Corporate Virtual Accounts are ideal for businesses looking to centralize and streamline their financial operations. They allow companies to manage multiple payment inflows efficiently, enabling better tracking and reconciliation of customer payments under a unified account system.

​
Individual

Individual Virtual Accounts are tailored for personal use, offering a secure and organized way to handle financial activities. They provide users with unique account identifiers to facilitate seamless transactions and better control over personal finances.

Virtual Accounts serve as a versatile solution for diverse financial management needs, adapting to both corporate and individual requirements.

For testing inflows, you can use the Simulator Tool. Please note, it only works in the test environment and does not process real money.

Authorizations

x-api-key
string
headerrequired
x-api-secret
string
headerrequired

Body

application/json
accountType
enum<string>
default: individualrequired

Type of account, e.g., 'individual'

Available options:
individual
firstName
string
required

First name (Required for Personal Account)

lastName
string
required

Last name (Required for Personal Account)

dateOfBirth
string
required

Date of birth in 'DD-MM-YYYY' format

bvn
string
required

Bank Verification Number (BVN), 10-digit number

bvnName
string
required

Name linked to the BVN

Response

200 - application/json
status
boolean
required

Indicates if the request was successful

statusCode
integer
required

HTTP status code of the response

data
object
required
message
string
required

Response message describing the result of the request

Create RecurringTemporary Account