billing-ops-plus

Built on affaan-m/ECC by @affaan-m (252,453 stars, MIT). All credit for the original idea to them. This fork improves and repackages it; upstream license preserved in UPSTREAM_LICENSE.

A Claude Code skill that helps support teams review refunds, failed payments, cancel requests, invoices, and plan issues with safer checks.

💡 Why

Billing help can change money and account access.

A wrong match can hurt the wrong customer. A second refund can lose money. A rushed cancel can remove access from a full team.

This skill gives Claude Code a clear workflow for billing support. It checks the customer, charge, plan, and past actions before it suggests or makes a change.

It is for support staff, founders, and developers who use connected billing tools such as Stripe.

🚀 Install

mkdir -p ~/.claude/skills/customer-billing-ops && curl -fsSL https://raw.githubusercontent.com/billing-ops-plus/billing-ops-plus/main/skill/SKILL.md -o ~/.claude/skills/customer-billing-ops/SKILL.md

The skill is one file and has no package needs. It fits into your current Claude Code flow.

🧭 Usage

Ask Claude Code about a real billing case:

Review this customer billing case.

Email: sam@example.com
Invoice: in_123
Request: The customer says they were charged twice and wants a refund.

Check the full billing state first. Do not change billing data unless I approve it.

Expected output:

Customer state:
- One customer matched by email and invoice ID.
- Two active personal subscriptions were found.
- Both payments were captured.
- No past refund or open dispute was found.

Proposed action:
- Cancel the extra subscription at the right time.
- Refund only the extra charge if company rules allow it.
- Wait for approval before making either change.

Money and access impact:
- Confirm the amount, currency, and access end date before acting.

Customer message:
- A short reply that explains the next step and refund timing.

The skill will stop when facts do not match. It will not claim that a refund or cancel was done when the tool could not do it.

🔧 What we changed vs upstream

• Rewritten from Japanese into simpler, more explicit English while preserving the original billing-operations purpose.
• Adds ECC attribution and stricter authorization rules, including no external calls or billing changes unless requested and approved.
• Expands safety checks for identity matching, duplicate actions, mismatched facts, privacy, legal compliance, and audit logging.
• Broadens case coverage to trials, invoice states, disputes, taxes, currencies, coupons, pricing, and prorated charges.
• Adds a more thorough pre-action billing-state review, including payments, refunds, renewal dates, credits, disputes, and pending changes.

📄 License

This repo uses the MIT License. See LICENSE.

The upstream MIT license and credit are kept in UPSTREAM_LICENSE.