Billing Webhooks
How Handlet keeps billing state synchronized with provider events.
Billing webhooks keep Handlet synchronized when checkout, subscription, invoice, or cancellation events happen outside the browser session.
Endpoint
Handlet billing integrations should receive provider events at the configured billing webhook endpoint and verify the provider signature before processing.
Required behavior
- Verify webhook signatures.
- Process events idempotently.
- Map provider customer or subscription records to the correct account.
- Keep secrets out of logs.
- Return quickly after safe processing or queueing.
Stripe Billing V1 notes
For Stripe Billing V1, subscribe to checkout completion, subscription created, subscription updated, subscription deleted, and invoice paid events. Billing Portal changes should match the supported plan-change rules for the current commercial model.