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: Interlace does not guarantee exactly-once delivery. Your system must be capable of handling duplicate Webhook notifications and perform idempotency checks based on the unique business identifier in the resource field, rather than the outer notification id.

The merchant shall bear all financial risks (such as duplicate account crediting) resulting from improper handling of duplicate notifications.