Create a virtual account number

post

https://api.flutterwave.com/v3/virtual-account-numbers

Create a Virtual Account for Your Customer.

Body Params

string

required

Defaults to [email protected]

The email address of the customer.

currency

string

enum

Defaults to NGN

The currency of the Virtual Account

Allowed:

amount

int32

required

Defaults to 2000

The desired amount to be collected

firstname

string

required

Defaults to John

This is the first name associated with the customer's account.

lastname

string

required

Defaults to Doe

This is the last name associated with the customer's account.

tx_ref

string

Defaults to jhn-mdkn-10192029920

This is a transaction reference that would be returned each time a transfer is done to the account

is_permanent

boolean

Defaults to false

This allows you create a static account number i.e. it doesn't expire

narration

string

Defaults to Please make a bank transfer to John

This allows you specify the name shown when the account is resolved. for GHS Account. this should be 35 characters long.

bvn

string

This is the customer's Bank Verification Number. This is only required when creating a static NGN virtual accounts.

phonenumber

string

Defaults to 08012345678

This is the customer's phone number.

bank_code

string

Defaults to 090772

This allows you to specify the bank issuing the virtual account. valid values include 035 (Wema),090360 (Cashconnect),090772 (Indulge)

Headers

Authorization

string

required

Defaults to Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X

Pass your secret key as a bearer token in the request header to authorize this call

Responses

200200

400400