Generate Virtual Account Number

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

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

Method: POST

Request Parameters

Type	Name	Parameter Required	Description
string	customer_name		Name of the customer (for account enquiry)
string	customer_email		Customer’s email address
string	channel_code	Required	Client application code
string	merchant_id	Required	ID of the merchant
string	transaction_amount	required	Transaction amounts
string	customer_id	Required	Unique ID for the customer on client system
string	customer_phone		Customer’s phone number
string	request_authorizer		Request authorizer on client system

Sample Request

{ 

    "customer_id": "jondoe@yahoo.com", 
    "merchant_id": "MERCHANT ID", 
    "customer_name": "Jon Doe", 
    "transaction_amount":"100", 
    "customer_email": "jondoe@yahoo.com", 
    "customer_phone": "07051234567", 
    "request_authorizer": "System", 
    "currency": "NGN", 
    "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",
        "request_id": "TESTd829ba2e87d7a6a",
        "expiry_datetime": "2024-06-20 15:47:23"
    }
}