Instant Pay callback allows you to receive real-time notifications on payment changes to virtual accounts in test and production environments. This guide is designed to assist developers who are integrating with our virtual account endpoint and wish to receive real-time callback notifications on payment changes.
API Architecture: REST
API Method: POST
Endpoint: To be updated on the API settings.
Upon transaction changes to virtual accounts, the system sends a callback object in JSON format, similar to a typical API response. This object contains essential information about the transaction.
IP Addresses
Ensure to whitelist the following IP addresses to ensure that you only receive webhooks from Hydrogen. Webhooks outside of this IP should be blocked and are not valid.
- 20.54.14.223
- 20.67.189.4
JSON Request
{
"accountName": "THELMA OHUE",
"amount": "1500",
"bankName": "Access Bank",
"destinationAccount": "0712982733",
"transactionDateTime": "06-07-2022",
"description": "Testing",
"transactionRef": "VPAYTO1287139954"
}
JSON Response
{
"responseCode": "00",
"responseMessage": "Successful Request"
}
Object Parameter
| Parameter | Type | Description |
|---|---|---|
| accountName | String | The name associated with the virtual account to which the payment is made. |
| amount | String | Transaction amount. |
| bankName | String | The name of the bank associated with the destination account. |
| destinationAccount | String | The account number to which the payment is directed. |
| transactionDateTime | String | Date and time when the payment occurred. |
| description | String | Brief description or comment related to the payment. |
| transactionRef | String | Unique reference code for the payment. |
Update your URL from the API settings on Merchant Portal to enable you to receive real-time notifications for every payment change to any of your virtual accounts. Retrieve important details such as account name and amount from the callback to update your system promptly.