1. 1. 综述
收款啦交易接口文档
  • 收款啦-码牌
    • 文本修改记录
    • 1. 综述
      • 1.1 阅读人员
      • 1.2 定义和术语
      • 1.3 场景和模型
      • 1.4 对接流程
      • 1.5 工具使用说明
    • 2. 接口规范
      • 2.1 接口须知
      • 2.2 接口规范
      • 2.3 签名验签
      • 2.4 统一示例参数
    • 3. 场景详情
      • 3.1订单支付
    • 4. 接口定义
      • 4.1 订单成功通知
    • 5. 附录
      • 5.1 交易码定义
      • 5.2 交易状态定义
  • 收款啦-终端接入
    • 文档修改记录
    • 综述
      • 智能POS收款啦SDK概述
      • 智能POS三方调用Intent模式概述
    • 接口规范
      • 接入须知
    • 接口定义
      • SDK调用模式
        • SDK初始化
        • SDK激活
        • 终端签到
        • 扫码交易(被扫)
        • 扫码交易查询
        • 扫码交易退款
        • 三方订单号查询
        • 银行卡交易
        • 银行卡撤销
        • 银行卡退款
        • 小票打印
        • 附录
      • 三方调用Intent模式
        • 签到
        • 获取商户信息
        • 消费
        • 消费撤销
        • 移动支付退货
        • 银行卡退货
        • 订单结果查询
        • 结算
        • 交易重打印
        • 开票
        • 自定打印
        • 预授权交易
        • 预授权撤销
        • 预授权完成
        • 预授权完成撤销
        • 外卡消费
        • 外卡预授权
        • 外卡预授权完成
        • 担保进度查询
        • 跳转交易列表
        • 激活
        • 余额查询
        • 附录
  • 收款啦-pos查询通知服务
    • 文本修改记录
    • 1. 综述
      • 1.1 阅读人员
      • 1.2 定义和术语
      • 1.3 场景和模型
      • 1.4 对接流程
      • 1.5 工具使用说明
    • 2. 接口规范
      • 2.1 接口须知
      • 2.2 接口规范
      • 2.3 签名验签
      • 2.4 签名及验签v1
      • 2.5 统一示例参数
      • 2.6 调试前必看
      • 2.6 生成商户公私钥
    • 3. 接口定义
      • 3.1 POS交易查询(单笔)
      • 3.2 POS交易成功通知
    • 4. 附录
      • 4.1 交易类型transType定义
      • 4.2 交易代码transCode定义
      • 4.3 卡类型cardType
      • 5.5 公用请求信息
      • 5.6 终端TPDU报文头规范
      • 5.7 支付方式
      • 5.8 卡类型
      • 5.9 计算交易类型
  • 收款啦-云MIS订单支付
    • 文本修改记录
    • 1. 综述
      • 1.1 阅读人员
      • 1.2 定义和术语
      • 1.3 场景和模型
      • 1.4 对接流程
      • 1.5 工具使用说明
    • 2. 接口规范
      • 2.1 接口须知
      • 2.2 接口规范
      • 2.3 签名验签
      • 2.4 签名及验签v1
      • 2.5 统一示例参数
      • 2.6 调试前必看
      • 2.6 生成商户公私钥
    • 3. ERP接口定义
      • 3.1 预下单
      • 3.2 查询订单列表
      • 3.3 订单详情查询
      • 获取支付宝碰一碰设备管理
      • 查询订单统计(酒店)
      • 查询订单列表(酒店)
    • 4. POS厂商接口定义
      • 4.1 结算
        • 4.1.1 结算信息预览
        • 4.1.2 收银员结算
        • 4.1.3 结算历史分页查询
        • 4.1.4 结算交易分页查询
        • 4.1.4 结算交易分页查询(酒店)
      • 4.2 待处理列表查询
      • 4.3 待处理订单详情查询
      • 4.4 订单取消
      • 4.5 需退款订单查询
      • 4.6 退款订单创建
      • 4.7 账本查询
      • 4.8 MIS三方调用报文
    • 5.1阿里Iot
      • 支付宝碰一碰设备表服务API
        • 支付宝碰一碰设备管理
        • 支付宝碰一碰设备-绑定
        • 支付宝碰一碰设备-换绑
        • 支付宝碰一碰设备-解绑
        • 支付宝碰一碰设备-绑定结果查询
        • 支付宝碰一碰设备-法人授权
        • 支付宝碰一碰设备-法人授权查询
        • 支付宝碰一碰设备-卖进退出
      • 收银员结算服务API
        • 结算信息预览
        • 收银员结算
        • 结算历史分页查询
        • 结算交易分页查询
    • 6. 附录
      • 5.1 交易代码定义
      • 5.2 交易状态定义
      • 5.3 请求支付方式
      • 5.4 接口返回码
      • 5.5 公用请求信息
      • 5.6 终端TPDU报文头规范
      • 5.7 支付方式
      • 5.8 卡类型
      • 5.9 计算交易类型
    • 指令结算API
      • 指令结算请求
      • 指令结算查询
  1. 1. 综述

1.5 工具使用说明

1.5 调试工具使用说明#

进行接口参数调试时,需要使用apifox工具进行调试,下载地址如下:
https://apifox.com/?utm_source=360&utm_medium=sem&utm_term=apifox-ocpc
注意:务必用客户端进行调试!客户端有签名脚本可以方便用户检查自己签名问题

1.1 接口调试#

使用前记得将环境调至测试环境
image.png
apifox在文档模式下有对接口各个参数的说明,并提供了请求报文的示例
image.png
进入调试模式下可以直接请求接口,下面有对应的状态码以及应答报文
image.png

1.2 检查签名、验签#

实际请求#

用户请求接口后,实际请求这里可以看到一些请求头、实际的请求报文的信息。请注意这里是签名是有经过我们签名脚本处理过的,如果对照你们原本的签名reqsign是不一样的话,那就是用户传的reqsign签名错误了,可以到控制台去看看相应的错误。
实际请求示例图:
image.png
image.png

控制台#

用户使用工具调试后,可以在控制台查看相应的签名过程,包括 reqbody的签名过程,以及最后得出的reqSign,参与签名的密钥,验签这些信息,方便用户定位签名过程中的问题。
image.png
image.png

1.3 应答码#

关于参数上一些代码、应答码的解释,可以参考 7 附录下的一些说明
image.png
修改于 2025-03-12 03:41:36
上一页
1.4 对接流程
下一页
2.1 接口须知
Built with