The virtual account API allows users to create virtual accounts and get transaction notifications. These virtual accounts can be used to track transactions and accept payments from customers.

The API is designed to be easily integrated into existing systems using standard HTTP requests and responses. Overall, the virtual account API provides a powerful and flexible solution for managing virtual accounts and streamlining payment processes for businesses of all sizes.

The API takes in the necessary information such as the account label and creates virtual accounts for the merchants. This allows the user or customer to receive payments through bank transfer.

To create a virtual account you call the virtual-account endpoint

Request

METHOD: POST

🚧

Test URL: https://qa-dev.hydrogenpay.com/qa/api/v2/vpay/virtual-account

βœ…

Live URL: https://api.hydrogenpay.com/api/v2/account/virtual-account

Request parameters

MandatoryTypeNameComment
YesStringaccountLabelThe label must be a unique identity on a per-user basis. Merchants can not have multiple accounts with the same account label. Name of the new account being created.

HYDROGEN - MERCHANT NAME - ACCOUNT LABEL

Response Parameters

NameTypeDescription
statusCodeIntegerResponse status code. See status codes.
messageStringDescription.
dataObjectSee Data description.

Below are the parameters of the data block

MandatoryNameTypeDescription
YesaccountLabelString
YesaccountNameStringnew account name
YesaccountStringunique account number

Sample Request

{
    "accountLabel": "string"
}

Sample Response

{
    "statusCode": "90000",
    "message": "success",
    "data": {
        "accountLabel": "Test Account",
        "accountName": "HYDROGENCO- LAMI LAMO-TEST ACCOUNT",
        "account": "1717714550",
      	"bankName": "Access Bank"
    }
}