integrating-stripe-payments

# Integrating Stripe Payments ## Core Workflow When user requests Stripe payment integration for Convex + Next.js: ### 1. Requirements Gathering Ask these questions first: - **Payment type**: Subscription or one-time payment? - **Backend**: Confirm this is Convex (required for this skill) - **Checkout preference**: Hosted Stripe Checkout (recommended) or embedded? - **Pricing**: Amount, currency, billing interval for subscriptions? - **Product**: What does user get after payment? ### 2. API Keys & Environment Setup **CRITICAL**: Gather these FIRST before proceeding - MCP tools require credentials. 1. **Get Stripe API keys from user**: - Ask for Stripe Secret Key (starts with `sk_test_` or `sk_live_`) - Add to `.env.local`: `STRIPE_SECRET_KEY=sk_test_...` 2. **Install dependencies**: `npm install stripe` 3. **Set initial environment variables**: - `STRIPE_SECRET_KEY` (from step 1) - `NEXT_PUBLIC_SITE_URL=http://localhost:3000` (default local development) 4. **Use Stripe MCP tool** to create product/price and get price ID 5. **Use Convex MCP tool** to set remaining environment variables 6. **Manual fallback**: Follow `resources/environment-setup.md` Complete required env vars: - `STRIPE_SECRET_KEY` ✓ (set in step 1) - `STRIPE_PRICE_ID` (from Stripe MCP tool) - `STRIPE_WEBHOOK_SECRET` (set during webhook configuration) - `NEXT_PUBLIC_SITE_URL` ✓ (set in step 1) ### 3. Database Schema Update `convex/schema.ts` with Stripe fields. See `resources/database-sche...