用途:构建自动化计费系统,覆盖周期性扣款、发票生成与投递、订阅生命周期、催款管理、按比例计费(proration)以及税费计算。适用场景包括 SaaS 订阅计费、用量计费、账单周期与续费管理、套餐变更时的按比例收费、销售税/VAT/GST 处理,以及失败付款的恢复流程。
核心概念:账单周期常见为按月、按年、按季度、按周或自定义(用量、按席位);订阅状态流转为 trial → active → past_due → canceled,并支持 paused 与 resumed;催款通过重试计划、客户通知、宽限期和账户限制来自动恢复失败付款;按比例计费用于周期中升级/降级、增减席位或更改计费频率。
使用方式:资料给出 Python 快速开始示例,从 billing 导入 BillingEngine 与 Subscription,初始化 BillingEngine 后调用 create_subscription(传入 customer_id、plan_id、billing_cycle_anchor、trial_days)创建订阅,再调用 process_billing_cycle 处理账单周期。更详细的模式与示例位于 references/details.md,当上层导航信息不足时阅读该文件。
限制:资料未提供具体支持的支付服务商、价格、平台依赖、安装命令或部署要求,这些信息暂未提供。