Skip to content

上线检查

上线前,把测试环境中跑通的配置切换到正式环境,并确认你的业务系统以 webhook 结果为准。

上线前必须确认

  • 已创建 live API key。
  • 服务端环境变量使用 live API key。
  • webhook URL 是正式域名。
  • webhook signing secret 已更新到生产环境。
  • 前端没有暴露任何 API key。
  • successUrlcancelUrl 指向正式网站。
  • 履约、发货、会员开通和开票逻辑只在支付确认后触发。

订单状态处理

你的系统至少应处理这些状态:

状态推荐动作
requires_payment等待买家进入结账页
processing支付处理中,暂不履约
confirmed标记已支付并履约
failed允许买家重新支付
refunded同步客服和财务状态
expired创建新的支付订单

上线后第一笔订单

正式上线后,建议先用小额订单验证:

  1. 你的服务端创建订单。
  2. 买家可以打开结账页。
  3. 支付后 webhook 正常投递。
  4. 你的系统订单状态正确更新。
  5. 商家后台 Transactions 能看到对应记录。

出现问题时

排查时准备:

  • paymentId
  • 商户订单号 orderId
  • webhook delivery id
  • 交易哈希
  • 你的服务端日志时间段

继续阅读:排查支付问题