Stripe CLI Cheat Sheet

stripe version

# Print the installed Stripe CLI version.

stripe help

# List top-level commands and global flags.

stripe listen --help

# Inspect a command or resource-specific subcommand.

stripe login

# Authenticate the CLI with your Stripe account.

stripe logout

# Remove the current CLI session.

stripe config --list

# Display account context and config values.

stripe customers list --live

# Target your live Stripe account explicitly.

stripe customers list --api-key sk_test_xxx

# Override the configured account with a supplied API key.

stripe customers list --profile my-sandbox

# Run a command using a configured Stripe CLI profile.

stripe products create --name="My Product" --stripe-version 2026-02-25.clover

# Override the API version for a single request.

stripe products create --name="My Product" --latest

# Test a request against the latest available API version.

stripe customers list --limit 5

# Limit the number of returned objects.

stripe subscriptions list --expand data.customer

# Request expanded objects directly from Stripe.

stripe customers list --limit 3 | jq ".data[] | {id, email}"

# Extract specific fields from a CLI response.

stripe payment_intents create --amount 5000 --currency usd --idempotency-key order_123

# Protect retried write requests from duplication.

stripe customers create --name "Ada Lovelace" --metadata team=backend --metadata source=cli

# Store key-value metadata on supported objects.

stripe checkout sessions retrieve cs_test_123 --expand payment_intent --expand customer

# Return several expanded fields in one request.

stripe get /v1/customers/cus_123

# Call an arbitrary Stripe API endpoint directly.

stripe post /v1/customers -d email=ada@example.com -d name="Ada Lovelace"

# Call an arbitrary POST endpoint directly from the CLI.

stripe delete /v1/webhook_endpoints/we_123

# Delete or deactivate supported resources with a raw request.

stripe customers --help

# Discover the resource namespace before drilling into subcommands.

stripe listen --forward-to localhost:4242/webhooks

# Listen for Stripe events and forward them to a local endpoint.

stripe listen --events payment_intent.created,checkout.session.completed,charge.failed --forward-to localhost:4242/webhooks

# Filter forwarded events to a focused set of names.

stripe listen --skip-verify --forward-to https://localhost:3000/api/webhooks/stripe

# Disable HTTPS certificate verification when testing locally.

stripe listen --load-from-webhooks-api --forward-to localhost:3000

# Load event configuration from a Stripe-registered endpoint and forward locally.

stripe trigger checkout.session.completed

# Create the object graph for checkout.session.completed testing.

stripe trigger payment_intent.succeeded

# Fire a payment_intent.succeeded fixture.

stripe trigger checkout --help

# Inspect the available fixtures for a Stripe surface.

stripe logs tail

# Stream API request logs from Stripe to your terminal.

stripe logs tail | jq "select(.status >= 400)"

# Use jq to watch only error conditions.

stripe events list --limit 10

# Inspect events recorded in your account.

stripe events retrieve evt_123

# View the payload for one event identifier.

stripe customers create --name "Ada Lovelace" --email ada@example.com

# Create a basic customer directly from the CLI.

stripe customers list --limit 10

# List recent customers in your account.

stripe customers retrieve cus_123

# Fetch a single customer by ID.

stripe customers update cus_123 --email new@example.com --metadata plan=pro

# Modify customer fields such as email or metadata.

stripe customers delete cus_123

# Delete a customer object in test mode.

stripe products create --name "Starter Plan" --description "Created with Stripe CLI"

# Create a one-time or recurring product entry.

stripe prices create --unit-amount 3000 --currency usd --product prod_123

# Attach a price to a product.

stripe prices create --unit-amount 1500 --currency usd --product prod_123 --recurring interval=month

# Attach a monthly recurring price to a product.

stripe payment_intents create --amount 5000 --currency usd

# Create a test payment intent from the terminal.

stripe payment_intents confirm pi_123

# Confirm an existing payment intent if your flow requires it.

stripe refunds create --payment-intent pi_123

# Refund a successful charge or payment intent.

stripe checkout sessions create --mode payment --success-url https://example.com/success --cancel-url https://example.com/cancel --line-items price=price_123,quantity=1

# Generate a hosted Checkout session for a price.