civitai 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