排查支付问题

当订单状态不符合预期时，先确认问题发生在哪个环节：创建支付订单、买家结账、webhook 投递，还是你的系统更新订单。

先准备这些信息

• 商户订单号 orderId
• Taria Pay paymentId
• 买家邮箱
• 交易哈希 txHash
• webhook delivery id
• 买家看到的问题截图
• 问题发生时间

创建支付订单失败

常见原因：

• API key 缺失、无效或已撤销
• orderId 已经存在
• amount、currency 或 URL 字段格式不正确
• 服务端把 API base URL 配错

处理方式：

1. 确认 API key 只在服务端使用。
2. 检查请求字段是否符合 API 参考。
3. 如果返回错误里有 requestId，记录后联系支持。

买家无法完成付款

常见原因：

• 钱包未连接或网络不匹配
• 余额不足
• 买家拒绝钱包确认
• 买家选择的网络或币种当前不可用

处理方式：

1. 让买家确认钱包余额和网络。
2. 检查结账页展示的支付选项。
3. 如果支付已上链，记录交易哈希。

买家已付款，但你的网站订单没更新

优先检查 webhook：

1. Webhook endpoint 是否是公网 HTTPS 地址。
2. Signing secret 是否和商家后台一致。
3. 你的服务端是否读取原始请求体后验签。
4. Handler 是否返回 2xx。
5. 订单更新逻辑是否幂等。

不要用买家是否进入 successUrl 判断最终支付结果。

Webhook 投递失败

在 Developers 的 Delivery Logs 查看：

• 响应状态码
• 最近一次错误
• 重试次数
• delivery id
• 事件类型

常见修复：

• 修正 webhook URL。
• 更新 signing secret。
• 放开防火墙或安全策略。
• 让 handler 快速返回 2xx，耗时任务放到后台处理。

联系支持

如果你无法定位问题，发送邮件到 support@tariapay.com，并附上本页开头列出的排查信息。