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
Response body
code
string
requiredResponse code
description
string
requiredResponse description
data
object
createdAt
string
requiredCreation timestamp.
accountId
string
requiredAccount ID.
accountHolderId
string
requiredAccount holder ID.
accountRef
string
requiredAccount reference.
phoneNumber
string
requiredPhone number.
email
string
requiredEmail address.
bvn
string
requiredBank Verification Number (BVN).
status
enum<string>
requiredAccount status.
type
enum<string>
requiredAccount type.
accountName
string
requiredAccount holder’s name.
banks
object[]
requiredList of associated bank accounts.
bankAccountNumber
string
requiredBank account number.
bankName
string
requiredBank name.
bankAccountName
string
requiredBank account holder name.
currency
string
requiredCurrency code.