billing-automation

Design and review subscription billing, invoicing, and payment recovery systems.

1|Updated Aug 7, 2025
One-click install
npx skills add https://github.com/zzafergok/arktos --skill billing-automation-zzafergok
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: billing-automation
Source: https://github.com/zzafergok/arktos/tree/main/.agent/skills/billing-automation
Command: npx skills add https://github.com/zzafergok/arktos --skill billing-automation-zzafergok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building recurring billing systems involves financial correctness risks like duplicate charges, lost webhooks, incorrect proration, and unreconciled ledgers that are hard to get right without a disciplined model. ## Core Features & Use Cases - Billing State Machine Design: Model the full subscription lifecycle including trials, renewals, plan changes, pauses, cancellations, failed payments, refunds, and disputes with explicit effective dates. - Correctness Invariants: Enforce idempotent event handlers, verified webhook authenticity, integer minor-unit monetary values, and traceable financial adjustments. - Reconciliation & Operations Guidance: Reconcile provider transactions, invoices, entitlements, and accounting exports while monitoring renewal success, involuntary churn, and webhook lag. - Use Case: When integrating a payment provider like Stripe into a SaaS product, use this Skill to design the subscription lifecycle, verify webhook handling against duplicate and out-of-order delivery, and define a proration policy before writing code. ## Quick Start Ask the assistant to design a subscription billing lifecycle with proration, dunning, and webhook idempotency for your payment provider integration.

Frequently Asked Questions about billing-automation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a subscription billing lifecycle?▼

Model each transition explicitly: creation, trial, activation, renewal, plan change, pause, cancellation, failed payment, recovery, refund, and dispute. Define effective dates, customer communication, and entitlement behavior for every transition before implementation.

How to handle duplicate or out-of-order payment webhooks?▼

Verify webhook authenticity before processing, make all event handlers idempotent, and use durable event storage with correlation identifiers. Never let provider state silently overwrite a newer internal transition.

Should I grant access when a client reports payment success?▼

No. Derive entitlements from trusted server-side state confirmed by verified provider events, never from client-reported success. Document a grace policy for edge cases like delayed webhook delivery.

How do I implement proration for plan changes?▼

Specify the exact proration policy upfront, including rounding rules and effective dates, and preview the customer-facing impact before applying changes. Test plan changes near billing period boundaries with deterministic clocks.

What should I monitor in a production billing system?▼

Monitor renewal success rates, involuntary churn, aging payment retries, webhook lag, processing errors, reconciliation mismatches, and manual interventions. Reconcile provider transactions against invoices, entitlements, and accounting exports regularly.