现象
Kyren Pay 中的订单状态与你的系统或客户预期不一致。常见原因
| 状态 | 通常含义 |
|---|---|
pending | 支付尚未完成,或网关尚未确认最终结果。 |
paid | 支付成功;如果其他检查通过,你的系统可以履约。 |
failed | 支付被拒绝、取消,或在支付网关失败。 |
closed / expired | Checkout 或支付窗口在成功支付前结束。 |
refunded | 在可用场景中,已记录退款状态。 |
在 Kyren 中检查
- 打开 控制台 > 订单 并搜索订单。
- 核对状态、金额、币种、创建时间和支付时间。
- 检查订单是否包含 Epay 来源订单标识。
在你的服务端检查
- 将 Kyren 订单 ID 与你的内部订单 ID 核对。
- 确认你的系统依赖 Webhook、轮询,还是两者结合。
- 检查是否缓存了较早的
pending状态,而订单后来已变化。 - 对比 API 数据时使用毫秒级时间戳,例如
1736932200000。
修复
使用paid 作为履约信号,保持履约幂等,并在人工对账前刷新订单状态。除非你的业务规则明确关闭内部订单,否则将 pending 视为等待状态。