Skip to main content

Generate Virtual Account Number

This endpoint generates a Breezepay virtual account number/wallet ID to be used for payment by a customer if the customer does not already have one tied to their ID.

URL: https://developer-sandbox.accessbankplc.com/virtualpaycorporate/GenerateVirtualAccountNumber

Method: POST

Request Parameters

TypeNameParameter RequiredDescription
stringcustomer_nameRequiredName of the customer (for account enquiry)
stringcustomer_emailCustomer’s email address
stringchannel_codeRequiredClient application code
stringmerchant_idRequiredID of the merchant
stringcustomer_idRequiredUnique ID for the customer on client system
stringcustomer_phoneCustomer’s phone number
stringrequest_authorizerRequiredRequest authorizer on client system

Sample Request

{ 
"customer_id": "jondoe@yahoo.com",
"merchant_id": "MERCHANT ID",
"customer_name": "Jon Doe",
"bvn": "22222222222",
"customer_email": "jondoe@yahoo.com",
"customer_phone": "07051234567",
"request_authorizer": "System",
"currency": "NGN",
"forcedebit": "N",
"channel_code": "MERCHANT ID"
}

Sample Response

{
"response_code": "00",
"response_message": "Successful Request",
"response_data": {
"virtual_acct_no": "1444624445",
"virtual_acct_name": "MERCHANT ID- IHIYI OBA",
"expiry_datetime": ""
}
}