用途:构建自动化计费系统,处理周期性付款、发票生成、订阅生命周期与催收管理,适合实现 SaaS 订阅计费、自动开票与投递、失败付款恢复、套餐变更按比例计费、销售税/VAT/GST 处理、用量计费以及账单周期与续费管理。
主要能力:订阅状态流转(trial→active→past_due→canceled,含 paused/resumed);账单周期处理(生成发票、扣款、成功则推进周期并发送发票,失败则标记逾期并启动催收);催收管理(重试计划、客户通知、宽限期、账户限制);按比例计费(升级/降级、增减席位、变更计费频率);税费计算(按地区税率、税种判定、VAT 号校验);发票生成(行项目、小计、税、总额、PDF/HTML 输出);用量计费(记录用量、按分层或按单位计价)。
使用方式:资料给出 Python 示例,如 from billing import BillingEngine, Subscription;billing = BillingEngine();billing.create_subscription(customer_id="cus_123", plan_id="plan_pro_monthly", billing_cycle_anchor=datetime.now(), trial_days=14);billing.process_billing_cycle(subscription.id)。扣款示例使用 stripe.Charge.create(customer=customer.stripe_id, amount=int(amount * 100), currency='usd')。
限制:资料未提供安装命令、依赖清单、具体平台支持范围、收费与价格信息,也未给出完整可运行工程或部署步骤;示例中的 generate_id、send_email、UsageRecord 等为示意,需自行实现。税费税率仅为示例值,实际应以合规来源为准。