stripe

Stripe Integration Skill

Purpose

This skill covers Stripe payment integration for subscriptions, checkout, credit/usage tracking, and webhook handling in legal tech applications.

Key Concepts

• Stripe SDK: Official Stripe Node.js library
• Subscriptions: Recurring billing for SaaS
• Checkout: Hosted payment pages
• Webhooks: Real-time payment event notifications
• Usage-Based Billing: Track and bill for API usage/credits
• Customer Portal: Self-service subscription management

Setup

Installation

bun add stripe
bun add -D @stripe/stripe-js

Environment Variables

# .env.local
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...

Stripe Client

// lib/stripe/client.ts
import Stripe from 'stripe';

export const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
  apiVersion: '2025-12-15.clover', // Latest stable API version
  typescript: true,
});

Project Structure

/
├── app/
│   ├── api/
│   │   ├── stripe/
│   │   │   ├── checkout/route.ts
│   │   │   ├── portal/route.ts
│   │   │   └── webhooks/route.ts
│   └── ...
├── lib/
│   ├── stripe/
│   │   ├── client.ts
│   │   ├── products.ts
│   │   ├── subscriptions.ts
│   │   └── webhooks.ts
└── ...

Products and Prices

Creating Products (Stripe Dashboard or API)

// lib/stripe/products.ts
import { stripe } from './client';

export async function createProduct() {
  const product = await stripe.products.create({
    name: 'Pro Plan',
    description: 'Professional legal tech features',
  });
  
  const price = await stripe.prices.create({
    product: product.id,
    unit_amount: 4900, // $49.00 in cents
    currency: 'usd',
    recurring: {
      interval: 'month',
    },
  });
  
  return { product, price };
}

Listing Products

export async function getProducts() {
  const products = await stripe.products.list({
    active: true,
    expand: ['data.default_price'],
  });
  
  return products.data;
}