Register a Webhook
Supported Events
Delivery Headers
Bila retries up to 3 times on failure (~5s, ~10s, ~20s). Return
HTTP 200 immediately 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
