Billing Webhooks

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, invoice paid, invoice payment failed, and invoice payment action required events. Billing Portal changes should match the supported plan-change rules for the current commercial model.