Stripe Integration

Stripe Integration

When to Use

Trigger phrases:

• "stripe integration"

• "Integrate Stripe for payments, subscriptions, invoicing, and billing"

• When adding payment processing to an application

• When implementing subscription billing or recurring payments

• When building checkout flows or payment forms

• When handling Stripe webhooks for payment events

When NOT to Use

• For non-Stripe payment gateways (use their specific skills)
• For simple donation pages (use simpler payment widgets)

Overview

Full Stripe integration covering payments, subscriptions, invoicing, and billing. Handles checkout sessions, customer portal, webhooks, and error handling.

Workflow

1. Install SDK - npm install stripe or pip install stripe
2. Configure - Set API keys (test + live), webhook endpoints
3. Build checkout - Create checkout sessions or payment elements
4. Handle webhooks - Process payment events (succeeded, failed, refunded)
5. Manage customers - Create, update, attach payment methods
6. Handle errors - Declined cards, expired tokens, rate limits

Anti-Rationalization Table

Code Example (Node.js)

const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);

const session = await stripe.checkout.sessions.create({
  mode: 'subscription',
  payment_method_types: ['card'],
  line_items: [{ price: 'price_xxx', quantity: 1 }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
});

app.post('/webhook', express.raw({type: 'application/json'}), (req, res) => {
  const sig = req.headers['stripe-signature'];
  const event = stripe.webhooks.constructEvent(req.body, sig, endpointSecret);
  switch (event.type) {
    case 'invoice.payment_succeeded': break;
    case 'invoice.payment_failed': break;
  }
  res.json({received: true});
});

Process

1. Prepare — Gather requirements, verify prerequisites, set up environment
2. Execute — Run stripe integration workflow with configured parameters
3. Verify — Validate output meets requirements, document results

Verification

• Checkout session creates successfully
• Payment processes in test mode
• Webhooks verify signature correctly
• Failed payments handled gracefully