Receive new event notifications

Event Webhook Endpoint

This endpoint receives webhook notifications for various events in the system.

Supported Event Types

For more information, see API Notifications Documentation

Security

  • All webhook payloads include a resource field containing JSON data
  • Use the resource field to verify the webhook signature
  • Ensure your endpoint responds with HTTP 200 status code and response with {"received":true}

Retry Policy

  • Failed webhooks will be retried up to 16 times
  • Retry intervals: 10 sec, 30 sec, 1 minutes,2 minutes etc..
  • Webhooks that continue to fail will be marked as failed

Best Practices

  1. Idempotency: Use the requestId to ensure duplicate events are handled properly
  2. Quick Response: Respond quickly (within 5 seconds) to avoid timeouts
  3. Validation: Always validate the event payload before processing
  4. Error Handling: Return appropriate HTTP status codes for different scenarios

Important Note: The receiver side system must be capable of handling duplicate notifications. If such handling is not implemented, the merchant shall bear all financial risks (such as duplicate account crediting) caused by duplicate notifications.

Payload
string
required

Unique identifier for the event

string
required

Type of event

string
required

code

string
required

message

string
required

Time of event occurrence

string
required

Event-specific data,JSON format, Use this field to check sign

Headers
string
required

The method used to generate the signature

string
required

HMAC signature for request verification

string
required

Unix timestamp in milliseconds when the request was sent

string
required

Media type of the request body

Response

LoadingLoading…