Stripe Webhook Migration Runbook

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

Required Environment

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

Typical Flow

1. Check status

   stripe-webhook status

2. Create and enable new-version webhook

   stripe-webhook migrate --step create --webhook-url "$STRIPE_WEBHOOK_URL"

3. Regenerate config and deploy updated application

   task config:generate

4. Disable old webhook after validation

   stripe-webhook migrate --step disable --webhook-url "$STRIPE_WEBHOOK_URL"

For full command behavior and rollback paths, see the stripe-webhook README.