Stripe API Actions#

Use this skill for live Stripe write operations.

Quick start#

1. Set STRIPE_SECRET_KEY in the current shell environment.
2. Read references/actions-and-safety.md for the supported write actions and example commands.
3. Require --confirm on every write command.

Core workflow#

1. Confirm scope#

Before running a write action, identify exactly which Stripe object should change and what the expected result is.

2. Use explicit commands#

Examples:

bash

python skills/stripe-api-actions/scripts/stripe_actions.py create_customer --name "Alice" --email "alice@example.com" --confirm
python skills/stripe-api-actions/scripts/stripe_actions.py create_product --name "Monthly Plan" --confirm
python skills/stripe-api-actions/scripts/stripe_actions.py create_price --product prod_123 --unit-amount 900 --currency eur --interval month --confirm
python skills/stripe-api-actions/scripts/stripe_actions.py create_payment_link --price price_123 --quantity 1 --confirm
python skills/stripe-api-actions/scripts/stripe_actions.py create_refund --payment-intent pi_123 --amount 500 --reason requested_by_customer --confirm
python skills/stripe-api-actions/scripts/stripe_actions.py cancel_subscription sub_123 --invoice-now --prorate --confirm
python skills/stripe-api-actions/scripts/stripe_actions.py update_metadata /customers/cus_123 --metadata external_id=42 --confirm

3. Prefer narrow changes#

Prefer creating or updating the minimum necessary object rather than bundling several unrelated changes into one step.

Safety rules#

• Do not store live Stripe secrets in skill files.
• Require --confirm for every write action.
• Be cautious with refunds and subscription cancellation.
• If a task affects live money flow or billing state, double-check the target object IDs first.

Resources#

• scripts/stripe_actions.py — minimal authenticated Stripe write helper using Python standard library
• references/actions-and-safety.md — supported actions, caveats, and example commands