The webhook allows you to receive instant notifications about payment status from the payment gateway. A webhook is sent in JSON, similar to what you would get in response to a typical API request. Below is the body of the Payment Gateway webhook.

API ARCHITECTURE: REST API Method: POST Endpoint: To be updated on the API settings.

To set up your webhook from the Merchant Portal, navigate to the Profile and Settings, select the API Integrations, and click "Setup Webhook". Enter the URL, select the API from the dropdown and hit save. Feel free to use https://webhook-test.com/ to get a URL for testing webhook delivery.

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

{
  "id": "f9140000-dacd-8663-678b-08ddd45d093b",
  "amount": 5,
  "chargedAmount": 5,
  "currency": "NGN",
  "customerEmail": "",
  "narration": null,
  "description": "",
  "status": "Paid",
  "transactionStatus": "Paid",
  "transactionRef": "36934683_4308395c7f",
  "processorResponse": null,
  "createdAt": "2025-08-05T21:17:00.8413571",
  "paidAt": "2025-08-05T21:17:00.8413571",
  "ip": "102.88.114.121",
  "paymentType": "Card",
  "authorizationObject": null,
  "fees": 0,
  "vat": 0,
  "extraFee": 0,
  "meta": null,
  "recurringCardToken": null,
  "metadata": [],
  "sourceAccountName": "TEST  USER",
  "sourceBank": "Access Bank",
  "sourceAccountNumber": null,
  "maskedPan": "123456******9090",
  "expiryMonth": "02",
  "expiryYear": "2021",
  "cardType": "MasterCard"
}

Response

Field	Type	Description
id	String	Unique identifier for the transaction.
amount	Decimal	The total amount of the transaction
chargedAmount	Decimal	The actual amount charged for the transaction.
currency	String	The currency in which the transaction is conducted (NGN, USD or GBP).
customerEmail	String	Email address of the customer making the transaction.
narration	String	A brief description or note about the transaction.
transactionStatus	String	The current state of the transaction. Possible values are Pending, Failed, Paid and Expired.
status	String	The current state of the transaction. Possible values are Pending, Failed, Paid and Expired.
transactionRef	String	Reference code for the transaction, useful for tracking and identification.
createdAt	DateTime	The timestamp when the transaction was created.
paidAt	DateTime	The timestamp when the transaction was done.
ip	String	The IP address from which the transaction was initiated.
paymentType	String	The method of payment used for the transaction (e.g., Card or BankTransfer).
fees	Decimal	Any fees associated with the transaction, in the smallest unit of the currency.
meta	String	Additional metadata about the transaction, useful for custom information.