易生云MIS技术文档
  1. 1. 综述
易生云MIS技术文档
  • 文本修改记录
  • 1. 综述
    • 1.1 阅读人员
    • 1.2 定义和术语
    • 1.3 场景和模型
    • 1.4 对接流程
    • 1.5 工具使用说明
  • 2. 接口规范
    • 1. 接口须知
    • 2. 接口规范
    • 3. 签名验签
    • 4. 签名及验签v1
    • 5. 统一示例参数
    • 4. 生成商户公私钥
      VIEW
  • 3. MIS推送接口定义
    • 3.1 推送交易
      POST
    • 3.2 交易查询
      POST
  • 4. 终端推送接口定义
    • 4.1 查询交易详情
      POST
    • 4.2 推送交易
      POST
    • 4.3 获取MQTT连接三元组接口
      LINK
    • 4.4 获取MQTT连接三元组接口
      POST
  • 5. ERP接口定义
    • 5.1 订单创建
      POST
    • 5.2 交易详情
      POST
    • 5.3 交易列表
      POST
    • 5.4 交易成功通知
      POST
  • 6. POS接口定义
    • 6.8 收银员结算
      • 6.8.1 结算信息预览
      • 6.8.2 收银员结算
      • 6.8.3 结算历史分页查询
      • 6.8.4 结算交易分页查询
    • 6.1 待支付订单详情查询
      POST
    • 6.2 待支付订单查询
      POST
    • 6.3 手工录入
      POST
    • 6.4 订单取消
      POST
    • 6.5 需退款订单查询
      POST
    • 6.6 退款订单创建
      POST
    • 6.7 账本查询
      POST
    • 6.9 MIS三方调用报文
      POST
  • 7. 附录
    • 7.1 交易代码定义
    • 7.2 交易状态定义
    • 7.3 请求支付方式
    • 7.4 接口返回码
    • 7.5 公用请求信息
    • 7.6 终端TPDU报文头规范
    • 7.7 支付方式
    • 7.8 卡类型
    • 7.9 计算交易类型
  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
修改于 2024-03-22 06:49:31
上一页
1.4 对接流程
下一页
1. 接口须知
Built with