OpenParable
Skip to content
← Back to skills

Stripe

Apps & Automation
stripe

Stripe 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

CommandDescription
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-endCancel 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-runPreview refundable charges without refunding

Refund Reasons

Valid --reason values:

  • duplicate — Charge was a duplicate
  • fraudulent — Charge was fraudulent
  • requested_by_customer — Customer requested the refund

Global Flags

FlagDescription
--jsonOutput raw JSON (useful for piping/processing)

Safety Notes

  • Cancel terminates the subscription immediately by default. Use --at-period-end for graceful cancellation.
  • Refund-all with --dry-run first 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 customer command 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 CustomerSubscription table