Register an endpoint
Add the URL at /dashboard/webhooks — Bila shows the whsec_ signing secret once on creation.
Event envelope
{
"id": "evt_...",
"object": "event",
"type": "charge.succeeded",
"resource_type": "charge",
"resource_id": "ch_...",
"data": { /* the resource at the time of the event */ },
"livemode": true,
"created": 1779000000
}Event types
charge.requires_actioncharge.pendingcharge.succeededcharge.failedcharge.canceledcharge.updatedrefund.succeededrefund.failed
Delivery guarantees
- HMAC-SHA256 signed via
Bila-Signatureheader — see Handling webhooks. - 9 retry attempts across ~72 hours on any non-2xx response.
- At-least-once delivery — make your handler idempotent by remembering each
event.id. - Replay any past delivery from
/dashboard/webhooks.
Test mode
Endpoints receive events from both sk_test_ and sk_live_ traffic. Read event.livemode to tell them apart.