Skip to main content

Stripe Webhook Migration Runbook

Use the stripe-webhook migration workflow to rotate Stripe webhook API versions with dual processing and no downtime.

Typical Flow

  1. Check status
stripe-webhook status
  1. Create and enable new-version webhook
stripe-webhook migrate --step create --webhook-url "$STRIPE_WEBHOOK_URL"
  1. Regenerate config and deploy updated application
task config:generate
  1. Disable old webhook after validation
stripe-webhook migrate --step disable --webhook-url "$STRIPE_WEBHOOK_URL"

Required Environment

export STRIPE_API_KEY=sk_test_...
export STRIPE_WEBHOOK_URL=https://api.theopenlane.io/v1/stripe/webhook

For full command behavior and rollback paths, see /Users/manderson/core/cmd/stripe-webhook/README.md.