（3162期）Billing – 企业级支付系统开发指南

企业级支付系统开发指南 全栈支付开发指南，覆盖 Stripe/Paddle 集成、订阅生命周期、税务合规与收入确认，适合需要实现企业级计费系统的开发者。 使用说明 Billing Skill 综合评估 核心用法 Billing 技能是一套面向 SaaS 和电商平台的企业级支付开发知识库，核心聚焦九大模块： PSP 集成：以 Stripe 为主，涵盖 PaymentIntent、Customer、Product/Price 等核心对象的完整交互模式 Webhook 架构：签名验证、幂等处理、乱序事件的状态机设计，强调"绝不信任未验证的 payload" 订阅生命周期：从 trialing → active → pastdue → canceled 的完整状态流转，以及取消策略（cancelatperiodend vs immediate delete）的财务影响 税务合规：欧盟 MOSS、美国 11,000+ 司法管辖区的销售税、B2B 反向征税等复杂场景 按量计费：metered billing 的实现模式与争议处理 争议与拒付：7-21 天的证据提交窗口、欺诈监控触发条件 收入确认：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 月度摊销，建立递延收入科目 | 原始说明 Build payment integrations, subscription management, and invoicing systems with webhook handling, tax compliance, and revenue recognition.