Stripe
Apps & AutomationstripeStripe is an Agent Skill for apps & automation published in the civitai/civitai repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Look up Stripe customers, subscriptions, charges, and payment methods. Cancel subscriptions and issue refunds. Use when investigating billing issues, subscription cancellations, or payment disputes.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/civitai/civitai/blob/HEAD/.claude/skills/stripe/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/stripe, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Stripe
Look up and manage Stripe customers, subscriptions, charges, and refunds for support investigations.
Setup
Required
STRIPE_SECRET_KEY— from Stripe Dashboard > Developers > API Keys (Secret key)
Quick Reference
SKILL_DIR=".claude/skills/stripe"
# Look up a customer by email (shows subscriptions, charges, invoices)
node "$SKILL_DIR/query.mjs" customer [email protected]
# Search customers using Stripe Search syntax
node "$SKILL_DIR/query.mjs" search "email:'[email protected]'"
# Get subscription details
node "$SKILL_DIR/query.mjs" subscription sub_1ABC123
# List charges for a customer
node "$SKILL_DIR/query.mjs" charges [email protected]
# List payment methods
node "$SKILL_DIR/query.mjs" payment-methods [email protected]
# Cancel a subscription IMMEDIATELY
node "$SKILL_DIR/query.mjs" cancel sub_1ABC123
# Cancel at end of billing period
node "$SKILL_DIR/query.mjs" cancel sub_1ABC123 --at-period-end
# Refund a specific charge (full)
node "$SKILL_DIR/query.mjs" refund ch_1ABC123
# Partial refund (amount in cents)
node "$SKILL_DIR/query.mjs" refund ch_1ABC123 --amount 500
# Refund with reason
node "$SKILL_DIR/query.mjs" refund ch_1ABC123 --reason requested_by_customer
# Preview all refundable charges (dry run)
node "$SKILL_DIR/query.mjs" refund-all [email protected] --dry-run
# Refund ALL charges for a customer
node "$SKILL_DIR/query.mjs" refund-all [email protected] --reason requested_by_customer
Commands
| Command | Description |
|---|---|
customer <email> | Full customer lookup — details, subscriptions, charges, invoices |
search <query> | Search customers using Stripe Search syntax |
subscription <sub_xxx> | Get detailed subscription info |
charges <cus_xxx|email> | List charges for a customer |
payment-methods <cus_xxx|email> | List saved payment methods |
cancel <sub_xxx> | Cancel subscription immediately |
cancel <sub_xxx> --at-period-end | Cancel at end of current billing period |
refund <ch_xxx> | Full refund of a charge |
refund <ch_xxx> --amount <cents> | Partial refund |
refund-all <cus_xxx|email> | Refund all charges for a customer |
refund-all <cus_xxx|email> --dry-run | Preview refundable charges without refunding |
Refund Reasons
Valid --reason values:
duplicate— Charge was a duplicatefraudulent— Charge was fraudulentrequested_by_customer— Customer requested the refund
Global Flags
| Flag | Description |
|---|---|
--json | Output raw JSON (useful for piping/processing) |
Safety Notes
- Cancel terminates the subscription immediately by default. Use
--at-period-endfor graceful cancellation. - Refund-all with
--dry-runfirst to preview. Without--dry-run, it refunds every non-refunded charge. - Refunds and cancellations are destructive and irreversible. Always confirm with the human operator before executing.
- The
customercommand is read-only and safe to run at any time.
When to Use This Skill
- Investigating billing/subscription issues reported in support tickets
- Verifying payment history for disputed charges
- Canceling subscriptions for users who request immediate termination
- Processing refunds for confirmed billing errors
- Cross-referencing Stripe data with Civitai's
CustomerSubscriptiontable