Stripe
Look up Stripe customers, subscriptions, charges, and payment methods.
by civitai · Apache-2.0
The skill
Look up Stripe customers, subscriptions, charges, and payment methods. Cancel subscriptions and issue refunds. Use when investigating billing issues, subscription cancellations, or payment disputes.
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 user@example.com
# Search customers using Stripe Search syntax
node "$SKILL_DIR/query.mjs" search "email:'user@example.com'"
# Get subscription details
node "$SKILL_DIR/query.mjs" subscription sub_1ABC123
# List charges for a customer
node "$SKILL_DIR/query.mjs" charges user@example.com
# List payment methods
node "$SKILL_DIR/query.mjs" payment-methods user@example.com
# 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 user@example.com --dry-run
# Refund ALL charges for a customer
node "$SKILL_DIR/query.mjs" refund-all user@example.com --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
Use this skill
Connect your agent to the Skill Store MCP server and ask for it by ref: civitai/stripe-54462344331.
Details
- Publisher
- civitai
- Category
- Finance & Markets › Payments & crypto
- License
- Apache-2.0
- Updated
- 2026-10-19
References
More from civitai
- Add Ecosystem Add a new ecosystem and base model to basemodel.constants.ts.
- Add Generation Support Wire an existing ecosystem into the generation system.
- Add Prompt Enhancement Guide Author a prompt-enhancement system prompt for a new ecosystem and register/update it on the orche…
- Add Trainer Model Add a new trainable base model to BOTH trainers end-to-end — the in-app trainer (main Next.js app…