Appearance

Webhooks ​

The Webhook feature enables your system to receive real-time transaction updates automatically. Once the final transaction status is determined (such as successful or failed), our platform sends a secure HTTP POST request to your configured webhook endpoint with the latest transaction details.

💡This allows your system to receive updates instantly without repeatedly polling the API.

How It Works ​

  1. You configure a webhook (callback) URL in your account settings page.

  2. When a payment is processed, a webhook notification is sent to your endpoint containing the event data .

  3. Your server receives the request, processes the payload, and returns a response confirming receipt.

How to setup a signed webhook ​

Log in to your Merchant Account and go to:

Settings → API Configuration → API Keys & Webhooks.

Find the Callback Secret field, click Edit, enter your secret key (without spaces), and then click Save.

signature = request.headers["signature"]
if signature exists:
 payload = request.raw_body
secret = "YOUR_MERCHANT_CALLBACK_SECRET"
computed = HMAC_SHA256(payload, secret)
if secure_compare(computed, signature) is false:
return HTTP 401 Unauthorized
process webhook
return HTTP 200 OK

💡 Important Notes

  • Your webhook endpoint must be publicly accessible and able to receive HTTP requests.
  • Your server should return a successful response (e.g., HTTP 200) after processing the webhook.
  • For security, you should validate the webhook using signature verification when a Callback Secret is configured.