Register a Webhook
Supported Events
Delivery Headers
Bila attempts delivery 7 times: immediately, then after approximately 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours and 24 hours. Each delay is jittered by ±20%. The delivery is marked
FAILED only after the seventh attempt fails.
Return HTTP 200 in under 10 seconds and process asynchronously.
Verify Signatures
Read the raw request body as a string before JSON parsing - the signature is computed against the raw bytes. Parsing first will break verification.
Pre-Launch Checklist
- Webhook registered and signing secret stored
- Signature verification implemented and tested
payment.completedandpayment.failedreceived correctly- Duplicate delivery detection via
X-Bila-Deliveryworking - Endpoint returns
200in under 10 seconds
