对接文档

Appearance

常见问题 ❓ ​

签名问题 ​

本系统签名采用hmac-sha256算法，无需拼接key，具体算法参照签名规则页

订单状态 ​

查询接口和回调参数中的订单状态枚举值是一致的

接口调用失败问题排查 ​

1. 参数错误:所有字段均为string格式(包括amount,time_stamp) ​

  • 产生原因: 请求参数中使用了非string格式的参数，如下例红色标记处
json
{
    "time_stamp": 1613719331, 
    "mch_no": "1611906847",
    "nonce": "9ZD0fWnWg1VPRlOV",
    "sign": "8cf605c78f09565c84e46389bf0cec6691e6e83b1fd5f78ef8710d6581b4540e",
    "out_order_no": "test0001",
    "amount": 1000, 
    "pay_type": "ALI_QR",
    "client_ip": "1.1.1.1",
    "attach": "test",
    "notify_url": "https://www.google.com",
    "currency": "CNY"
}
  • 解决方法: 将参数替换成带"的字符串格式

2. 签名错误: 服务器生成的签名串amount=1000&attach=test&client_ip=1.1.1.1....... ​

  • 产生原因: 签名错误，请核对签名规则页的签名算法
  • 解决方法: 接口返回的错误信息中包含了服务器生成的签名字符串，将本地生成的签名字符串与服务器的对比，查看是否一致。如果签名串一致，联系客服核对商户密钥信息是否正确。

3. 参数错误: 商户号[1611906847]，产品编码[test]已关闭 ​

  • 产生原因: 未开通对应编码的权限，联系客服开通，或者更换编码重新下单
  • 解决方法: 联系客服开通该商户对应编码的代收/代付开关，并设置费率

4. 系统内部错误: 商户[1611906847],编码[test]无可用通道,请联系运营开启对应通道权限 ​

  • 产生原因: 未绑定产品编码为test类型的通道到当前商户，联系客服解决
  • 解决方法: 为该商户绑定产品编码为test类型的通道，并打开通道的代收/代付开关

5. 请求路径不存在,请检查地址或method(GET,POST...) ​

  • 产生原因: 接口地址错误，或者请求的method错误
  • 解决方法: 核对接口地址是否与文档中一致，且请求方式[GET / POST]是否一致

6. 出码失败: {"xxx":"yyy"} ​

  • 产生原因: 下游通道出码失败，非对接问题
  • 解决方法: 联系客服处理下游通道问题