| Event | Endpoint | Auth | Triggered When |
|---|
beneficiary_addition | Merchant's webhook URL | Basic | Beneficiary status changes |
fund_transfer | Merchant's webhook URL | Basic | Each payout in a batch reaches a terminal state |
statement | Merchant's webhook URL | Basic | HDFC statement requested via 5.3.1 is ready to fetch |
All webhooks include an X-Webhook-Signature header. Always validate the signature before acting on the payload.
| Pattern | Example |
|---|
| Standard HTTPS on public host | https://api.merchant.com/hooks/payments |
| Nested path | https://api.example.com/deep/nested/path?x=1&y=2 |
| Custom port (any numeric port is fine) | https://api.example.com:8443/webhook |
| Subdomain | https://sandbox.api.example.com/webhooks |
| Public IPv4 literal | https://8.8.8.8/hook |
| With query string | https://api.example.com/hook?event=payment_success |
| Root path | https://api.example.com/ |
