
Stripe Integration Architect
Design and implement production-grade Stripe payment flows
What You Can Do
You can architect secure, scalable payment flows that handle subscriptions, one-time charges, webhooks, and complex billing scenarios. This skill guides you through designing idempotent payment patterns, implementing robust error handling, and debugging production Stripe issues with confidence—from initial design through deployment.
Features
Map out subscription, one-time charge, and multi-tier billing patterns before coding
Securely handle Stripe events with verification, idempotency, and error recovery
Design resilient flows that handle rate limits, network failures, and payment declines
Build systems that minimize sensitive data exposure and meet security standards
Prevent duplicate charges and ensure transaction safety during retries
Design patterns for subscription lifecycle, billing cycles, and customer records
Debug production issues using Stripe's CLI, test events, and logging strategies
Follow pre-launch validation steps covering key rotation, webhook configuration, and cutover planning
Example Output
Architecture Decision Diagram:
User Payment → Idempotency Check → Create Payment Intent → Handle 3D Secure → Webhook Verification → Database Update
Webhook Implementation Checklist:
- Verify Stripe signature on all incoming webhooks
- Implement exponential backoff for failed event processing
- Handle duplicate events via idempotency keys
- Log all webhook events with request/response timestamps
Error Recovery Flow:
Payment Failed (declined_code: "insufficient_funds")
→ Notify customer via email with retry link
→ Schedule automatic retry after 3 days
→ Update subscription status to "past_due"
→ Log to monitoring dashboard
What's Included
- SKILL.md: Complete Stripe integration guide with decision trees, architectural patterns, and step-by-step workflows
- Payment Flow Templates: Subscription billing, one-time charges, installment plans, and multi-currency flows
- Webhook Validation Checklist: Event types to handle, signature verification, idempotency tracking
- Error Handling Decision Tree: How to classify and respond to different payment failure types
- PCI Compliance Worksheet: Audit checklist for secure Stripe implementation
- Debugging Playbook: Common issues, how to inspect Stripe logs, and production troubleshooting steps
- Pre-Launch Validation Checklist: Environment setup, webhook routing, API key rotation, and cutover plan
Who It's For
- Backend engineers building billing systems or payment infrastructure
- Full-stack developers integrating Stripe into SaaS products
- FinTech architects designing payment platforms
- Payment platform teams managing subscription services
- Founders building billing or marketplace features
Best For
- Implementing subscription billing systems from scratch
- Debugging failed payments or webhook delivery issues in production
- Designing idempotent payment flows that handle retries safely
- Building multi-currency or multi-tier pricing models
- Auditing and hardening existing Stripe integrations for PCI compliance







