sc-stripe

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.