stripe-integration

The Stripe Integration skill serves as a structured technical blueprint for developers implementing payment processing within their applications. It facilitates the end-to-end integration of Stripe's financial infrastructure, ensuring that payment flows—ranging from simple e-commerce checkout to complex SaaS subscription billing—adhere to professional security standards. This tool is designed for software engineers, backend developers, and product teams aiming to reduce technical debt associated with payment handling by providing pre-validated code patterns and robust architectural guidance.

The skill provides a clear decision-making framework to determine the appropriate integration path based on user requirements, such as one-time checkout, recurring subscriptions, usage-based billing, or custom PaymentIntents. It enforces industry-standard security protocols, including server-side payment creation to prevent client-side price tampering, idempotent webhook handling to ensure data integrity during retry scenarios, and the correct management of financial data in smallest currency units.

• Provides detailed implementation patterns for Node.js, Express, Next.js, and Serverless environments.

• Includes a comprehensive security checklist covering API key management, environment variables, HTTPS enforcement, and webhook signature verification.

• Offers explicit architectural patterns for asynchronous webhook processing using message queues to prevent timeouts.

• Supplies extensive test documentation, including specific Stripe test card numbers for simulating success, declines, and 3D Secure scenarios.

• Features a go-live readiness guide to ensure seamless transitions from test to production modes.

• Intended for developers working with Stripe APIs to handle secure financial transactions.

• Requires Node.js 18+ and an existing backend application architecture.

• Emphasizes the use of .env files for protecting STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET.

• Encourages usage of Stripe CLI for local development and webhook forwarding.

• Recommends structured error handling and database transaction wrapping for all payment state changes to ensure high reliability.