---
name: sc-stripe
description: "(STUB / NOT IMPLEMENTED YET) Stripe payments setup — create products/prices, webhook endpoint registration, customer portal config, restricted API keys. Pairs with sc-convex for `payments` table mutations and HTTP webhook routes."
---

# /sc-stripe — Stripe (STUB)

> **Status:** boilerplate only. No working scripts yet.

## Scope when implemented

- Create/update Products + Prices idempotently from a config file
- Register webhook endpoint at `https://api-<domain>/webhook/stripe` and capture the signing secret
- Generate a **restricted API key** (least-privilege) for the runtime, distinct from the dashboard key
- Configure the Customer Portal session URL
- Smoke-test with a Stripe test-mode checkout link

## Env vars

| Var | Purpose |
|---|---|
| `STRIPE_SECRET_KEY` | `sk_test_...` or `sk_live_...` (server-side) |
| `STRIPE_PUBLISHABLE_KEY` | `pk_test_...` or `pk_live_...` (client-side) |
| `STRIPE_WEBHOOK_SECRET` | `whsec_...` — captured after webhook registration |

## Suggested file layout

```
sc-stripe/
├── SKILL.md
└── scripts/
    ├── products.js    # idempotent product/price upsert from config
    ├── webhook.js     # register endpoint, capture whsec
    ├── portal.js      # customer portal config
    └── restricted-key.js  # least-privilege key for runtime
```

## Implementation notes

- API base: `https://api.stripe.com/v1`
- Auth: `Authorization: Bearer <STRIPE_SECRET_KEY>` + `Stripe-Version: 2024-12-18.acacia`
- Bodies are `application/x-www-form-urlencoded`, NOT JSON.
- Idempotency: pass `Idempotency-Key: <uuid>` header to avoid duplicate products on retry.
- Convex integration: see `sc-convex` for `payments` schema + `http.ts` `/webhook/stripe` route example.