english/.opencode/skills/payment-integration/references/stripe/stripe-cli.md

Stripe CLI Reference

Command-line tool for testing and development workflows.

Installation

# macOS
brew install stripe/stripe-cli/stripe

# Windows (scoop)
scoop install stripe

# Linux (apt)
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list
sudo apt update && sudo apt install stripe

# Docker
docker run --rm -it stripe/stripe-cli

Authentication

stripe login
# Opens browser for Dashboard authorization
# Stores credentials in ~/.config/stripe/config.toml

Environment variable (CI/CD):

export STRIPE_API_KEY=sk_test_...

Webhook Testing

Listen for Events

# Forward webhooks to local server
stripe listen --forward-to localhost:3000/webhook

# Output:
# Ready! Your webhook signing secret is whsec_xxx

Trigger Test Events

stripe trigger payment_intent.succeeded
stripe trigger customer.subscription.created
stripe trigger checkout.session.completed

Event Types

Common events to test:

• payment_intent.succeeded
• payment_intent.payment_failed
• checkout.session.completed
• customer.subscription.created
• customer.subscription.updated
• customer.subscription.deleted
• invoice.paid
• invoice.payment_failed

API Logs

# Real-time logs
stripe logs tail

# Filter by status
stripe logs tail --filter-status-code 400

# Filter by path
stripe logs tail --filter-request-path "/v1/charges"

Resource Commands

# List customers
stripe customers list --limit 5

# Create customer
stripe customers create --email="test@example.com"

# Retrieve resource
stripe products retrieve prod_xxx

# Delete resource
stripe products delete prod_xxx

Fixtures (Batch Operations)

Create fixtures.json:

{
  "_name": "test_flow",
  "fixtures": [
    {
      "name": "customer",
      "path": "/v1/customers",
      "method": "post",
      "params": { "email": "test@example.com" }
    },
    {
      "name": "subscription",
      "path": "/v1/subscriptions",
      "method": "post",
      "params": {
        "customer": "${customer:id}",
        "items[0][price]": "price_xxx"
      }
    }
  ]
}

Run: stripe fixtures fixtures.json

Common Workflows

Test Checkout Integration

# Terminal 1: Listen for webhooks
stripe listen --forward-to localhost:3000/webhook

# Terminal 2: Trigger checkout event
stripe trigger checkout.session.completed

Test Subscription Lifecycle

stripe trigger customer.subscription.created
stripe trigger invoice.paid
stripe trigger customer.subscription.updated
stripe trigger customer.subscription.deleted

Resources

• Full docs: https://docs.stripe.com/cli
• Webhook testing: https://docs.stripe.com/webhooks/test
• Fixtures: https://docs.stripe.com/cli/fixtures