SuperAPI AI 工具集

Billing

通用与其它

查看项目

更新于 10-16 03:07

技能介绍

用途:当用户需要实现或调试支付处理、订阅生命周期、发票或收入运营时使用,覆盖支付服务商集成、Webhook 架构、多币种、税务合规、拒付、按量计费、市场分账与收入确认。

主要能力与参考文件:Stripe 集成(stripe.md)、Webhook 与事件(webhooks.md)、订阅生命周期(subscriptions.md)、发票生成(invoicing.md)、税务合规(tax.md)、按量计费(usage-billing.md)、拒付与争议(disputes.md)、市场支付(marketplace.md)、收入确认(revenue-recognition.md)。

核心规则摘要:金额始终用最小货币单位整数存储,禁用浮点数,变量名标明币种;Webhook 必须验签(Stripe-Signature),用原始请求体,存储 event_id 并做幂等,事件可能乱序;订阅状态机需区分 trialing、active、past_due、canceled、unpaid,不能仅凭 active 授权;取消应默认周期末取消;变更计划需显式指定 proration 模式;注意事件竞态与最终一致性;税务按国家/地区处理(欧盟 B2B 反向征收、B2C MOSS、美国多辖区销售税);PCI-DSS 下不存储卡数据,只存 PSP token;拒付有截止时间;收入确认遵循 ASC 606/IFRS 15。

限制:资料未提供具体代码示例、安装命令、收费与平台细节;实际实现需结合所选用 PSP 的官方文档与当地法规核验。