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.