Accounts
Creating virtual accounts
Learn about creating virtual accounts
Create a virtual account
Accept payments with virtual accounts
POST /v1/accounts/virtual
Request body
accountRef
string
requiredAccount reference
accountName
string
requiredAccount holder’s name
currency
string
requiredCurrency code
expiryDate
string
Expiry Date (This field allows you to customize the expiry period for this account. The default time however is 5 minutes)
Response body
code
string
requiredResponse code
description
string
requiredResponse description
data
object
createdAt
string
requiredCreation timestamp.
accountHolderId
string
requiredAccount holder ID.
accountRef
string
requiredAccount reference.
bvn
string
requiredBank Verification Number (BVN).
accountName
string
requiredThe name associated with the account (may return the parent account name if not a corporate account)
bankAccountNumber
string
requiredThe account number
bankAccountName
string
requiredThe account name that will reflect when doing name lookup
currency
string
requiredCurrency code.
expiryDate
string
Expiry date of the account created.