Restheart Webhooks

generated: '2026-10-21'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://restheart.org/docs/stripe/webhooks
sources:
- https://restheart.org/docs/stripe/webhooks
- https://restheart.org/docs/v8/cloud/webhook/
- https://restheart.org/docs/v8/cloud/webhook/getting-started
- https://restheart.org/docs/v8/cloud/webhook/user-guide
description: Stripe webhook endpoint (/stripe/webhook) receives Stripe events and applies them – updating subscription state or order status,
  recording transactions.
events:
- event: checkout.session.completed
  description: Logged only. Stripe follows with customer.subscription.created.
- event: customer.subscription.created
  description: Rebuilds full subscription state.
- event: customer.subscription.updated
  description: Plan change, renewal, quantity change, cancellation scheduling.
- event: customer.subscription.deleted
  description: Resets to default-plan, status canceled. Sends notification.
- event: customer.subscription.trial_will_end
  description: Sends the trial‑will‑end notification.
- event: invoice.payment_succeeded
  description: Status → active.
- event: invoice.payment_failed
  description: Status → past_due. Sends notification.
- event: product.updated
  description: Invalidates the plans display cache.
- event: price.updated
  description: Invalidates the plans display cache.
- event: checkout.session.async_payment_succeeded
  description: Order → paid. Appends payment transaction.
- event: checkout.session.async_payment_failed
  description: Order → failed.
- event: checkout.session.expired
  description: Order → expired (from pending_payment only).
- event: charge.refunded
  description: Appends refund transaction. Updates amount_refunded.
- event: charge.dispute.created
  description: Appends dispute transaction.
delivery:
  signature: Stripe-Signature header verified against stripeConfig.webhook-secret
  retries: Stripe will retry on 500 responses
docs: https://restheart.org/docs/stripe/webhooks