Billing (Stripe)

Stripe integration, subscriptions, and billing flows. This is the pack-billing-stripe pack.

What you need

• A Stripe account. Sign up at dashboard.stripe.com.
• Postgres (subscription models live in the database).
• Optionally Resend for receipt emails. If RESEND_API_KEY is set, the pack sends receipts; otherwise it skips email.

Stripe credentials

From the Stripe dashboard, grab:

• Secret key (STRIPE_SECRET_KEY) from API Keys.
• Webhook signing secret (STRIPE_WEBHOOK_SECRET) from Webhooks, or create one locally with the Stripe CLI (below).

Webhook endpoint

The pack exposes a Stripe webhook receiver at:

POST /checkout/webhook

In production, create a webhook endpoint in Stripe pointing at https://yourdomain.com/checkout/webhook, subscribe to the events the pack handles (checkout, subscription, customer), and copy the signing secret into STRIPE_WEBHOOK_SECRET.

Local development with the Stripe CLI

Stripe can't reach localhost over the internet, so use the Stripe CLI to forward events. Install it from stripe.com/docs/stripe-cli, then:

stripe listen --forward-to localhost:3000/checkout/webhook

The CLI prints a whsec_... signing secret. Put it in STRIPE_WEBHOOK_SECRET.

Environment variables

Variable	Purpose
STRIPE_SECRET_KEY	Stripe API secret key
STRIPE_WEBHOOK_SECRET	Signing secret for the webhook endpoint
RESEND_API_KEY	Optional. Enables receipt emails