Skip to main content

Webhook Notification Service

Description: Provides real-time transaction status updates to participating institutions.

Instead of repeatedly polling transaction status, institutions may receive asynchronous updates from eTranzact.

Webhook Endpoint​

Client provides endpoint during onboarding.

  • Example: https://client-domain.com/api/v1/webhooks/transaction-status

Webhook Security​

The following headers will be sent:

Content-Type: application/json
X-API-Key: <client-api-key>
X-Event-Time: 2026-04-17T13:45:30Z

Example:​

https://client-domain.com/api/v1/webhooks/transaction-status

Request Headers​

Content-Type: application/json
X-API-Key: <client-api-key>
X-Event-Time: 2026-04-17T13:45:30Z

Sample Notification​

{
  "event": "TRANSACTION_STATUS",
  "data": {
    "reference": "09FG210817200150711WVSL1K",
    "clientReference": "AS24Test00050",
    "amount": 100.00,
    "fee": 0.00,
    "currency": "566",
    "status": "SUCCESS",
    "responseCode": "00",
    "responseMessage": "Transaction Successful",
    "transactionDate": "2026-04-17T13:44:55Z"
  }
}
  • Expected Response

200 OK

Optional Body:

{
  "status": "received"
}