Stripe Dev - Integration Orchestrator

Master skill that routes to specialized Stripe integration skills. Start here when building any Stripe integration.

When to Apply

Reference this skill when:

• Starting a new Stripe integration
• Choosing between Stripe products for a use case
• Implementing cross-cutting patterns (webhooks, errors, testing)
• Planning Stripe architecture for a project

Available Skills

Priority	Skill	Impact	Use Case
1	stripe-payments	CRITICAL	Accept one-time payments, save cards
2	stripe-billing	CRITICAL	Subscriptions, invoicing, recurring revenue
3	stripe-connect	HIGH	Marketplace / platform payments
4	stripe-money-management	HIGH	Payouts, refunds, disputes, fraud
5	stripe-treasury	MEDIUM	Embedded finance, card issuing
6	stripe-revenue	MEDIUM	Tax, revenue recognition, reporting

Quick Reference

Routing by Goal

Goal	Primary Skill	Also Use
Accept card payments	stripe-payments	stripe-money-management
SaaS subscriptions	stripe-billing	stripe-payments
Marketplace payouts	stripe-connect	stripe-money-management
Usage-based pricing	stripe-billing	stripe-revenue
Embed banking features	stripe-treasury	stripe-connect
Multi-party payments	stripe-connect	stripe-payments
Fraud prevention	stripe-money-management	stripe-payments
Tax automation	stripe-revenue	stripe-billing
Financial reporting	stripe-revenue	stripe-money-management

Architecture by Stage

• MVP: Checkout + Customer Portal + Payment Links
• Growth: Payment Element + Webhooks + Stripe Tax
• Platform: Connect + Treasury + Revenue Recognition + Sigma

Cross-Cutting Patterns

For detailed integration patterns: references/integration-patterns.md

SDK Setup

import Stripe from 'stripe';
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

Webhook Verification

const event = stripe.webhooks.constructEvent(
  body, sig, process.env.STRIPE_WEBHOOK_SECRET!
);

Idempotency

await stripe.paymentIntents.create(
  { amount: 2000, currency: 'usd' },
  { idempotencyKey: `order_${orderId}` }
);

Error Handling

try {
  await stripe.paymentIntents.create({...});
} catch (err) {
  if (err instanceof Stripe.errors.StripeCardError) { /* declined */ }
  else if (err instanceof Stripe.errors.StripeRateLimitError) { /* retry */ }
  else if (err instanceof Stripe.errors.StripeInvalidRequestError) { /* fix */ }
}

Testing

• CLI: stripe listen --forward-to localhost:3000/webhooks
• Cards: 4242424242424242 (success), 4000000000000002 (decline)
• 3DS: 4000002500003155 (required), 4000003800000446 (always)

Deep Dive References

• references/integration-patterns.md - Full-stack architecture, database schemas, multi-product patterns