Instant Pay webhook 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 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 an 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.

132.164.151.107

JSON Response

{
	"accountName": "THELMA OHUE",
	"amount": "1500",
	"bankName": "Access Bank",
	"destinationAccount": "0712982733",
	"transactionDateTime": "06-07-2022",
	"description": "Testing",
	"transactionRef": "VPAYTO1287139954"
}

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 Webhook 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 webhook to update your system promptly.