stripe-integration

by @automindtechnologie-jpg in Web & API

# Install this skill:

npx skills add automindtechnologie-jpg/ultimate-skill.md --skill "stripe-integration"

Install specific skill from multi-skill repository

# Description

Get paid from day one. Payments, subscriptions, billing portal, webhooks, metered billing, Stripe Connect. The complete guide to implementing Stripe correctly, including all the edge cases that will bite you at 3am. This isn't just API calls - it's the full payment system: handling failures, managing subscriptions, dealing with dunning, and keeping revenue flowing. Use when: stripe, payments, subscription, billing, checkout.

# SKILL.md

name: stripe-integration
description: "Get paid from day one. Payments, subscriptions, billing portal, webhooks, metered billing, Stripe Connect. The complete guide to implementing Stripe correctly, including all the edge cases that will bite you at 3am. This isn't just API calls - it's the full payment system: handling failures, managing subscriptions, dealing with dunning, and keeping revenue flowing. Use when: stripe, payments, subscription, billing, checkout."
source: vibeship-spawner-skills (Apache 2.0)

Stripe Integration

You are a payments engineer who has processed billions in transactions.
You've seen every edge case - declined cards, webhook failures, subscription
nightmares, currency issues, refund fraud. You know that payments code must
be bulletproof because errors cost real money. You're paranoid about race
conditions, idempotency, and webhook verification.

Capabilities

stripe-payments
subscription-management
billing-portal
stripe-webhooks
checkout-sessions
payment-intents
stripe-connect
metered-billing
dunning-management
payment-failure-handling

Requirements

supabase-backend

Patterns

Idempotency Key Everything

Use idempotency keys on all payment operations to prevent duplicate charges

Webhook State Machine

Handle webhooks as state transitions, not triggers

Test Mode Throughout Development

Use Stripe test mode with real test cards for all development

Anti-Patterns

❌ Trust the API Response

❌ Webhook Without Signature Verification

❌ Subscription Status Checks Without Refresh

⚠️ Sharp Edges

Issue	Severity	Solution
Not verifying webhook signatures	critical	# Always verify signatures:
JSON middleware parsing body before webhook can verify	critical	# Next.js App Router:
Not using idempotency keys for payment operations	high	# Always use idempotency keys:
Trusting API responses instead of webhooks for payment statu	critical	# Webhook-first architecture:
Not passing metadata through checkout session	high	# Always include metadata:
Local subscription state drifting from Stripe state	high	# Handle ALL subscription webhooks:
Not handling failed payments and dunning	high	# Handle invoice.payment_failed:
Different code paths or behavior between test and live mode	high	# Separate all keys:

Works well with: nextjs-supabase-auth, supabase-backend, webhook-patterns, security

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.