Billing Service (v0.0.1)
Manages billing cycles, invoice generation, and payment scheduling for subscriptions
Overview
The Billing Service is responsible for managing all billing-related operations for subscriptions. It calculates billing cycles, generates invoices, and coordinates with payment services to ensure timely payment collection.
Key Features
- Billing Cycle Management: Handles daily, weekly, monthly, quarterly, and annual billing cycles
- Invoice Generation: Creates detailed invoices with line items and tax calculations
- Payment Scheduling: Schedules recurring payments based on billing cycles
- Proration: Calculates prorated charges for mid-cycle changes
- Dunning Management: Handles failed payment retry logic
API Endpoints
REST API
GET /api/billing/invoice/{subscriptionId}
- Get current invoiceGET /api/billing/history/{subscriptionId}
- Get billing historyPOST /api/billing/preview
- Preview upcoming chargesPUT /api/billing/retry/{invoiceId}
- Retry failed payment
Billing Cycle States
Loading graph...
Configuration
billing_service:
cycles:
- daily
- weekly
- monthly
- quarterly
- annual
retry_attempts: 3
retry_interval_days: [1, 3, 7]
invoice_generation_lead_days: 7
Event-driven architecture documentation: FlowMart