Awesome-omni-skill stripe-checkout-subscriptions
Guide for creating Stripe Checkout Sessions for subscriptions in Flutter/Supabase backend. Covers flows, API preferences, and non-negotiable rules.
install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/cli-automation/stripe-checkout-subscriptions" ~/.claude/skills/diegosouzapw-awesome-omni-skill-stripe-checkout-subscriptions && rm -rf "$T"
manifest:
skills/cli-automation/stripe-checkout-subscriptions/SKILL.mdsource content
Stripe Checkout Subscriptions
Source of Truth: All subscription states derive from Stripe Webhooks.
Backend Flow
Client → Create Checkout Session → Stripe → Webhook → Supabase.
Flutter Client
- Listen to
table in Supabase for status updates post-payment.profiles - Flutter app NEVER updates its own
flag; it only reads backend-provided state.is_premium
Implementation Rules (Non-Negotiable)
- Use Stripe Checkout Sessions API for one-time payments and subscriptions.
- Model taxes/discounts via Stripe.
- For recurring revenue (SaaS-like): Prefer Billing APIs + Stripe Checkout.
- Never use Charges API. Migrate to Checkout Sessions or Payment Intents if needed.
- For web: Prioritize Stripe-hosted Checkout or embedded Checkout. Payment Element OK for advanced customization (pair with Checkout Sessions).
- Never recommend legacy Card Element or Payment Element in card mode.
- Avoid deprecated Sources API or outdated Tokens/Charges. Use Setup Intent API for saving payment methods.
- For pre‑PaymentIntent rendering: Use Stripe Confirmation Tokens, not
/createPaymentMethod
.createToken - Turn on dynamic payment methods in dashboard (don't hardcode
).payment_method_types - Default to latest API version: 2026-01-28.clover (unless user specifies otherwise).
- Use env vars:
.STRIPE_SECRET_KEY
Integration Resources
- Stripe Integration Options / API Tour docs.
- Go Live Checklist before production.