billing-integration

# billing-integration

## Instructions

This skill provides complete Clerk Billing integration with Stripe for subscription management, pricing plans, and payment processing. Clerk Billing eliminates the need for custom webhooks and payment UI by connecting directly to Stripe while handling user interface, entitlement logic, and session-aware billing flows.

### 1. Enable Clerk Billing

Initialize Clerk Billing in your Clerk Dashboard:

```bash
# Run automated setup script
bash ./skills/billing-integration/scripts/setup-billing.sh
```

**What This Does:**
- Guides you through Clerk Dashboard setup
- Connects your Stripe account
- Enables billing features
- Configures production/sandbox modes

**Manual Setup Steps:**
1. Navigate to Clerk Dashboard > Configure > Billing
2. Click "Enable Billing"
3. Connect your Stripe account (or use sandbox mode for development)
4. Configure billing settings and defaults

### 2. Configure Pricing Plans

Create subscription plans and features:

```bash
# Run plan configuration script
bash ./skills/billing-integration/scripts/configure-plans.sh
```

**Configuration Process:**
1. Navigate to Dashboard > Configure > Subscription Plans
2. Click "Add User Plan" (B2C) or "Add Organization Plan" (B2B)
3. Enter plan details:
   - Name (e.g., "Pro Plan")
   - Slug (auto-generated, e.g., "pro_plan")
   - Description
   - Pricing (monthly/yearly)
4. Add features to plan:
   - Feature name (e.g., "AI Assistant")
   - Feature slug (e.g., "ai_assistant")
   - Feature description
5. Set feature limits if usage-based

**Plan Types:**
- **User Plans**: B2C subscriptions tied to individual users
- **Organization Plans**: B2B subscriptions for teams/companies
- **Free Tier**: Optional free plan with limited features
- **Trial Plans**: Time-limited free access to paid features

### 3. Implement Pricing Table

Add the pricing display component:

**Using Template:**
```bash
# Copy pricing page template
cp ./skills/billing-integration/templates/pricing-page