Purchase Lifecycle

Lifecycle checkpoints

1. checkout session created
2. provider webhook received
3. webhook processed successfully
4. purchase/subscription state updated
5. entitlement projection updated

Troubleshooting quick map

• Checkout exists, no webhook event:
  • validate endpoint URL/secret and provider delivery logs
• Webhook exists, not processed:
  • inspect processing metadata and replay intent flow
• Purchase updated, entitlement stale:
  • run status sync and validate plan/variant mapping

Data tables

• billing_checkouts
• billing_webhook_events
• billing_purchases
• billing_subscription_snapshots
• billing_entitlements
• billing_customer_bindings

Detailed operations copy: docs/runbooks/purchase-lifecycle.md