Billing Skill 综合评估
核心用法
Billing 技能是一套面向 SaaS 和电商平台的企业级支付开发知识库，核心聚焦九大模块：
1. PSP 集成：以 Stripe 为主，涵盖 PaymentIntent、Customer、Product/Price 等核心对象的完整交互模式
2. Webhook 架构：签名验证、幂等处理、乱序事件的状态机设计，强调"绝不信任未验证的 payload"
3. 订阅生命周期：从 trialing → active → past_due → canceled 的完整状态流转，以及取消策略（cancel_at_period_end vs immediate delete）的财务影响
4. 税务合规：欧盟 MOSS、美国 11,000+ 司法管辖区的销售税、B2B 反向征税等复杂场景
5. 按量计费：metered billing 的实现模式与争议处理
6. 争议与拒付：7-21 天的证据提交窗口、欺诈监控触发条件
7. 收入确认：ASC 606/IFRS 15 准则下的递延收入处理，避免"收钱即确认收入"的会计错误
显著优点
- 生产级严谨：强调整数分（cents）存储、浮点数陷阱、 race condition 处理等真实故障场景
- 合规覆盖完整：PCI-DSS、税务、会计三轨并行，降低法律与审计风险
- 反模式明确：用"Trap"章节列出 20+ 真实踩坑案例，如 webhook 伪造、CVV 入日志、年度收入一次性确认等
潜在局限
- Stripe 中心化：虽提及 Paddle，但深度明显偏向 Stripe 生态
- 地域税务浅尝：美国销售税仅提 11,000+ 司法区复杂性，未给具体实现路径
- 无代码示例：纯文档指引，需配合各子文件（
stripe.md等）使用 - 版本锁定风险：Stripe API 更新频繁，1.0.0 版本可能滞后
适合人群
- 后端工程师：实现支付核心系统的技术负责人
- 财务技术（FinTech）开发者：需要理解收入确认与税务合规的交叉领域
- SaaS 创始人/CTO：评估自建 vs 第三方计费（如 Chargebee）的决策参考
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 安全漏洞 | 未验证 webhook 签名导致伪造支付通知 | 强制实现 `Stripe-Signature` 校验 |
| 合规处罚 | PCI-DSS 违规（存储 CVV 或明文卡号） | 仅存储 PSP 令牌，敏感数据零留存 |
| 财务损失 | 错误 proration 模式导致客户意外扣款 | 所有订阅变更显式指定 `proration_behavior` |
| 审计问题 | 年度订阅收入一次性确认 | 按 ASC 606 月度摊销，建立递延收入科目 |