跳到主要内容

故障排除

HashNut 集成的常见问题和解决方案。

身份验证问题​

"Invalid signature or credentials"​

原因:

  • 错误的 apiKey
  • 请求体字符串化不正确
  • 缺少必需的标头

解决方案:

  1. 验证 apiKey 是否正确
  2. 确保体字符串化与发送的完全一致
  3. 检查所有必需的标头是否存在
  4. 如需要，重新生成 API 密钥

"Invalid accessKeyId"​

解决方案: 验证 accessKeyId 是否正确且处于活动状态。

订单问题​

"Order not found"​

原因:

  • 错误的订单 ID
  • 错误的环境 (测试网 vs 生产环境)

解决方案:

  1. 验证 payOrderId 和 merchantOrderId 是否正确
  2. 检查您是否使用正确的环境
  3. 验证 accessSign 来自订单创建

"Duplicate merchantOrderId"​

原因:

  • 订单 ID 已存在

解决方案:

  1. 使用唯一的订单 ID
  2. 检查现有订单
  3. 实现幂等性

支付问题​

支付未完成​

原因:

  • 网络拥堵
  • 余额不足
  • 错误的网络

解决方案:

  1. 在区块链浏览器上检查交易
  2. 验证客户是否有足够的余额
  3. 确保使用正确的网络

未收到 Webhook​

原因:

  • Webhook URL 不可访问
  • 未使用 HTTPS
  • 防火墙阻止

解决方案:

  1. 对 webhook URL 使用 HTTPS
  2. 使用 ngrok 进行本地测试
  3. 检查防火墙设置

网络问题​

错误的网络​

原因:

  • 客户在错误的区块链上

解决方案:

  1. 支付页面会提示切换网络
  2. 验证订单链是否与钱包网络匹配

获取帮助​

仍有问题？ 联系 支持 →