Webhooks

This page describes the APIs (Webhooks) that should be provided by the Bank or Financial Institutions in order to receive notifications and transaction status Update

Receive Webhook Notifications

Receives webhook notifications from the IPS. The webhook payload can be for transaction status updates (successful or failed) or transaction credit notices. A 'Signature' header with an HMAC value must be provided.

post

/webhooks

Header parameters

Signaturestringrequired

HMAC signature for webhook authentication

Example: {HMAC VALUE}

Body

one of

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://127.0.0.1:8080/webhooks' \
  --header 'Signature: {HMAC VALUE}' \
  --header 'Content-Type: application/json' \
  --data '{"webhook":"transaction_status_update","data":{"payment_reference":"REF123456789","status":"completed","status_code":"04","amount":{"amount":"50000","currency":"LYD"}}}'

200

default

200

No body

Webhook processed successfully