Designing subscription billing systems for SaaS with complex pricing tiers.
Subscription Billing Architect
Stripe, Chargebee, SaaS Billing
Best for
- ▸Design subscription billing architecture for SaaS platforms with complex pricing tiers
- ▸Implement Stripe/Chargebee webhook processing with idempotent payment state management
- ▸Build dunning workflows to recover 50-70% of failed recurring payments
- ▸Design proration logic for mid-cycle plan upgrades and downgrades
What you'll get
- ▸Complete subscription state machine with 15+ states (trial, active, past_due, canceled) including transition triggers and business logic
- ▸Webhook processing architecture with idempotency patterns, event deduplication, and reconciliation job specifications
- ▸Multi-stage dunning strategy with specific retry timing (days 1, 3, 5, 7), customer communication templates, and success rate benchmarks
Clear business model details (pricing tiers, usage-based components, trial periods) and technical constraints (existing payment stack, compliance requirements, scale expectations).
Technical architecture diagrams, state machine definitions, webhook handling code patterns, and revenue recognition data schemas with specific implementation guidance for subscription lifecycle management.
What's inside
“You are a Senior Subscription Billing Architect. You design recurring revenue systems that recover 60-75% of failed payments, handle multi-currency at scale, and never lose money to rounding errors or state divergence. - **Money-first infrastructure**: Treat every amount as integers (cents, never fl...”
Covers
Not designed for ↓
- ×One-time payment processing or e-commerce checkout flows
- ×Accounting software implementation or financial reporting systems
- ×Payment gateway selection without subscription-specific requirements
- ×Simple membership sites with fixed monthly fees and no plan changes
SupaScore
88.83▼
Evidence Policy
Standard: no explicit evidence policy.
Research Foundation: 7 sources (3 official docs, 1 industry frameworks, 2 web, 1 books)
This skill was developed through independent research and synthesis. SupaSkills is not affiliated with or endorsed by any cited author or organisation.
Version History
v5.5 distilled from v2 via Claude Sonnet
Pipeline v4: rebuilt with 3 helper skills
Initial release
Prerequisites
Use these skills first for best results.
Works well with
Need more depth?
Specialist skills that go deeper in areas this skill touches.
Common Workflows
SaaS Billing System Implementation
End-to-end process from pricing strategy through billing implementation to financial compliance for subscription businesses
© 2026 Kill The Dragon GmbH. This skill and its system prompt are protected by copyright. Unauthorised redistribution is prohibited. Terms of Service · Legal Notice