商户采购API接口文档
  1. 开发指南
商户采购API接口文档
  • 开发指南
    • 对接环境介绍
    • 接口签名介绍
    • API接口调试
    • 常见问题
  • 接口文档
    • 话费|油卡|权益|代充|流量-采购文档
      • 新商品ID模式
        • 放单API
        • 查询商品列表API
        • 修改商品自主报价
        • 商品自定义放单超时时间设置
      • 旧产品模式API
        • 旧产品模式-放单API
        • 查询商品列表API
        • 修改商品自主报价
      • 商品价格变更通知
        • 商品价格变更订阅取消
        • 商品价格变更订阅
        • 商品价格变更推送
      • 代充充值-采购文档
        • 代充放单API
        • 解除充值号码/卡密黑名单API
      • 资金查询API
      • 订单结果状态回调API
      • 订单做单日志
      • 订单状态查询API
      • 订单状态列表批量查询API
    • 携号转网/空号检测API
      • 提交查询订单API
    • 卡密卡券-采购文档
      • 卡种面值库存列表
      • 库存购买
      • 卡密求购
      • 取消求购
      • 订单查询API
      • 上报订单结果
      • 订单状态回调API
      • 商户余额查询
      • 商户流水查询(按天查询)
    • 电影票-采购文档
      • 城市列表
      • 地区列表
      • 影院列表
      • 影院排期列表
      • 座位图
      • 座位图 Copy
  1. 开发指南

常见问题

商户入驻汇总#

1 为何要实名认证?#

根据《中华人民共和国网络安全法》第二十四条规定,必须要求提供实名信息。在涉及账号归属问题时,实名信息可以有效的确定所有者。

2 为什么实名认证还没通过?#

实名认证由系统自动审核+人工辅助审核。若商户处于待审核状态,可能是证件图片模糊无效,或与提交认证的信息不一致,导致系统判断失败进入人工审核阶段。若有需求,可联系在线客服申请加急处理实名认证审核。

3 如何获取秘钥?#

测试环境获取参数:沙箱环境模拟数据
正式环境获取路径:开放平台-API调试-秘钥管理-获取参数
image.png

4 无效的AppKey,如何处理?#

错误原因:接口请求时服务器会校验请求参数的app_key,判断当前app_key是否有效;
解决方案
检查app_key是否复制错误; 沙箱环境与生产环境数据不互通; 沙箱环境只能使用沙箱数据,沙箱环境数据获取地址:沙箱环境模拟数据; 以上均排查后还未能解决问题,可能是由于账号配置初始化异常,可通过更新回调地址来重置账号配置,即可解决问题;(操作步骤:登录商户控制台-配置订单回调地址)。

5 签名问题#

按以下点排查:
看对接环境是否搞错,是否有测试环境与生产环境交叉用错情况;
参与签名参数值是否原值非编码;
看参数名称和参数值是否输写错误;
参数值null要做为字符串参与签名;
接口请求签名、接口响应签名、异步回调签名的规则都是一样的,可参考签名规则;
接口响应中的签名,是使用响应参数result的值做的签名,规则是将该值字符串转成字符数组,然后排序该字符数组,再将该字符数组中的元素拼接成字符串,在它后面带上秘钥,最后md5。
备注:一般是null没有做为字符串参与签名,请自行排查代码。
修改于 2025-04-16 10:17:13
上一页
API接口调试
下一页
放单API
Built with