Appearance
上线检查
上线前,把测试环境中跑通的配置切换到正式环境,并确认你的业务系统以 webhook 结果为准。
上线前必须确认
- 已创建 live API key。
- 服务端环境变量使用 live API key。
- webhook URL 是正式域名。
- webhook signing secret 已更新到生产环境。
- 前端没有暴露任何 API key。
successUrl和cancelUrl指向正式网站。- 履约、发货、会员开通和开票逻辑只在支付确认后触发。
订单状态处理
你的系统至少应处理这些状态:
| 状态 | 推荐动作 |
|---|---|
requires_payment | 等待买家进入结账页 |
processing | 支付处理中,暂不履约 |
confirmed | 标记已支付并履约 |
failed | 允许买家重新支付 |
refunded | 同步客服和财务状态 |
expired | 创建新的支付订单 |
上线后第一笔订单
正式上线后,建议先用小额订单验证:
- 你的服务端创建订单。
- 买家可以打开结账页。
- 支付后 webhook 正常投递。
- 你的系统订单状态正确更新。
- 商家后台 Transactions 能看到对应记录。
出现问题时
排查时准备:
paymentId- 商户订单号
orderId - webhook delivery id
- 交易哈希
- 你的服务端日志时间段
继续阅读:排查支付问题