技能介绍

支付接入为什么容易翻车

很多产品的第一次支付事故，不是收款失败，而是 Webhook 没验签、重复事件没做幂等。把东南亚的银行转账做成全球订阅，或者用错计费模式，同样会付出数月返工的代价。这个技能要解决的正是三件事：平台选型、接入流程、回调安全。

它如何工作

第一步是选型。 技能按场景给出一张对照表：

SePay：越南市场、VND、银行转账、VietQR/NAPAS 二维码
Polar：全球 SaaS 订阅，支持 GitHub/Discord 自动权益发放
Stripe：企业级支付基础设施，需要 Connect 或自定义结账时选用
Paddle：MoR 模式下平台代缴全球销售税，适合想省去税务负担的订阅业务
Creem.io：MoR 叠加软件授权，支持分账与无代码结账

第二步是通用接入流程。 各平台形态不同，骨架一致：鉴权 → 创建产品/价格 → 发起结账 → 接收 Webhook → 处理事件。结账优先走托管页面或官方前端组件（如 Stripe Payment Element、Paddle 浮层），把 PCI 范围压缩到最小。

第三步是 Webhook 验签。 这里写成书面化的固定步骤，不内嵌脚本：取出签名头与时间戳 → 用平台密钥对 时间戳 + "." + 原始请求体 做 HMAC-SHA256 → 常量时间比对，不一致直接返回 4xx → 校验时间戳容差防止重放 → 按 event_id 幂等，已处理则直接返回 2xx。

技能的输出是一个结构化工件 PayPlan：平台、计费模式、结账方式、回调整证要点，可以直接交给后端、前端或文档流程消费。订阅生命周期（试用转正、升降级、暂停）与多平台订单的统一模型也包含在内。