0. 环境配置
1. 本地会话(BFF 侧的登录态)
浏览器永远不能提交权威的 merchant_user_id / aggregate_subject / 金额 / 密钥;这些只在服务端产生。
2. 身份交换与平台回跳
返回的 location 必须由浏览器顶层 303 跳转,不能 fetch 跟随,也不能记录 token。
3. 商品目录
金额、币种、周期、金币数量一律以网关响应为准。目录展示不代表已开放购买。
4. 创建 Checkout Session
已选套餐:
未选择
READY → 201 并返回 checkout_url;预留/处理中/未知/已支付 → 202。跳转成功或回跳参数都不代表到账。
5. 订单查询
6. 订阅
at_period_end 固定 true;重复提交复用同一幂等键 cancel_<subscription_id>。
7. Webhook 事件与本地账本
/api/gateway/webhook
网关需把下游 Webhook 配到这个地址(独立密钥验签)
-
8. 请求日志(签名原文)
9. 渠道连续性 c_sign
当前地址栏 c_sign:-