Handle Stripe Billing Webhook

Handle Stripe webhook events.

Flow:

  1. Verify signature via StripeProviderService.verify_webhook()
  2. Delegate to WebhookProcessorService for idempotent processing

Events handled:

  • invoice.paid → activate subscription / allocate top-up credits / renew
  • invoice.payment_failed → dunning: schedule retry, set grace period
  • customer.subscription.created → store provider_subscription_id
  • customer.subscription.updated → handle plan change / pending cancellation
  • customer.subscription.deleted → demote to PAYG
  • checkout.session.completed → allocate top-up credits (one-time payments)
post/api/v1/webhooks/billing/stripe

Request

  • Base URL: https://api.sanifu.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.sanifu.ai/api/v1/webhooks/billing/stripe
  • Auth: none declared

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.