Stripe Setup

1. Create a Stripe Account

Sign up at stripe.com. Use Test mode (toggle in dashboard) for development.

2. Get API Keys

1. Go to Stripe Dashboard → Developers → API keys
2. Copy:
   • Publishable key → NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY
   • Secret key → STRIPE_SECRET_KEY

3. Create Products and Prices

1. Go to Products → Add product

2. Create three products: Standard, Pro, Ultra (or match your plan names)

3. For each product, add:

   • Monthly price — Recurring, monthly
   • Annual price — Recurring, yearly (typically 20% discount)

4. Copy the Price IDs (e.g. price_xxx) and add to .env.local:

STRIPE_PRICE_STANDARD_MONTHLY=price_xxx
STRIPE_PRICE_STANDARD_ANNUAL=price_xxx
STRIPE_PRICE_PRO_MONTHLY=price_xxx
STRIPE_PRICE_PRO_ANNUAL=price_xxx
STRIPE_PRICE_ULTRA_MONTHLY=price_xxx
STRIPE_PRICE_ULTRA_ANNUAL=price_xxx

See lib/config/env.ts for the exact variable names.

4. Webhook Setup

Local Development

Use the Stripe CLI to forward webhooks:

stripe listen --forward-to localhost:3000/api/webhooks/stripe

Copy the webhook signing secret (e.g. whsec_xxx) to STRIPE_WEBHOOK_SECRET.

Production

1. Go to Developers → Webhooks → Add endpoint
2. Endpoint URL: https://your-domain.com/api/webhooks/stripe
3. Select events: checkout.session.completed, customer.subscription.updated, customer.subscription.deleted, invoice.paid, invoice.payment_failed
4. Copy the signing secret to STRIPE_WEBHOOK_SECRET

5. Customer Portal (Optional)

For self-service subscription management (cancel, update payment):

1. Go to Settings → Billing → Customer portal
2. Configure branding and features
3. NextBento uses /api/billing/portal to redirect users to the portal

6. Environment Variables

NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_xxx
STRIPE_SECRET_KEY=sk_test_xxx
STRIPE_WEBHOOK_SECRET=whsec_xxx
# Plus the 6 price IDs above

Test Mode

Next Steps

• Billing — Plans, checkout flow, webhooks
• Environment Variables — Full reference