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

post

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.

Header parameters

SignaturestringRequired

HMAC signature for webhook authentication

Example: {HMAC VALUE}

Body

one ofOptional

or

Responses

200

Webhook processed successfully

default

An error response object

application/json

post

HTTPcURLJavaScriptPython

POST /webhooks HTTP/1.1
Host: 127.0.0.1:8080
Signature: {HMAC VALUE}
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "webhook": "transaction_status_update",
  "data": {
    "payment_reference": "REF123456789",
    "status": "completed",
    "status_code": "04",
    "amount": {
      "amount": "50000",
      "currency": "LYD"
    }
  }
}

Transaction Status Update (Success)Transaction Status Update (Failed)Transaction Credit Notice

No content