stripe-payments

1# Stripe Payments
2 
3Add Stripe payments to a web app. Covers the common patterns — one-time payments, subscriptions, webhooks, customer portal — with working code. No MCP server needed.
4 
5## Which Stripe API Do I Need?
6 
7| You want to... | Use | Complexity |
8|----------------|-----|-----------|
9| Accept a one-time payment | Checkout Sessions | Low — Stripe hosts the payment page |
10| Embed a payment form in your UI | Payment Element + Payment Intents | Medium — you build the form, Stripe handles the card |
11| Recurring billing / subscriptions | Checkout Sessions (subscription mode) | Low-Medium |
12| Save a card for later | Setup Intents | Low |
13| Marketplace / platform payments | Stripe Connect | High |
14| Let customers manage billing | Customer Portal | Low — Stripe hosts it |
15 
16**Default recommendation**: Start with Checkout Sessions. It's the fastest path to accepting money. You can always add embedded forms later.
17 
18## Setup
19 
20### Install
21 
22```bash
23npm install stripe @stripe/stripe-js
24```
25 
26### API Keys
27 
28```bash
29# Get keys from: https://dashboard.stripe.com/apikeys
30# Test keys start with sk_test_ and pk_test_
31# Live keys start with sk_live_ and pk_live_
32 
33# For Cloudflare Workers — store as secrets:
34npx wrangler secret put STRIPE_SECRET_KEY
35npx wrangler secret put STRIPE_WEBHOOK_SECRET
36 
37# For local dev — .dev.vars:
38STRIPE_SECRET_KEY=sk_test_...
39STRIPE_WEBHOOK_SECRET=whsec_...
40STRIPE_PUBLISHABLE_KEY=pk_test_...
41```
42 
43### Server-Side Client
44 
45```typescript
46import Stripe from 'stripe';
47…