webhooks

Stripe Webhook

Handle Stripe webhook events.

Subscription + auto-refill model:

  • checkout.session.completed (mode=subscription): save customer/sub IDs + PM
  • customer.subscription.updated: handle tier upgrade/downgrade
  • customer.subscription.deleted: cancel — clear active plan
  • invoice.paid: grant monthly block credits + reset usage counters
  • invoice.payment_failed: mark plan inactive, notify user
  • payment_intent.succeeded (auto_refill): informational log only (credits are granted synchronously by the auto_refill service)

Expert payouts:

  • account.updated, payout.paid, payout.failed (unchanged)
post/api/v1/webhooks/stripe

Response

Successful Response

{"stackTrail":"paths:/api/v1/webhooks/stripe:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

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