1. 2. 接口规范
收款啦交易接口文档
  • 收款啦-码牌
    • 文本修改记录
    • 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. 2. 接口规范

2.3 签名验签

2.3.1.验签数据#

商户/代理方用以验证返回的报文是否合法。
值为空字符不参与签名
对返回报文中的返回头rspHeader和返回体rspBody,按照名称的ASCII码从小到大先分别进行排序,如果名称的首字母相同,则比较第二个字母,以此类推。将排序后的rspBody计算Md5(hex转大写),再将排序后的请求头rspHeader和请求体rspBody计算得到的Md5值进行拼接,拼接后的字符串,返回报文中rspSign签名,使用RSA公钥验签(公钥由易生提供,密钥位数为2048(SHA256WITHRSA)位【其他算法使用其他算法的密钥和加密方式】,计算签名是否正确用以确认易生签发的报文数据。
注意
若rspBody没有返回则算MD5的时候用 {}
rspBody排序后
{"orderNo":"20240524162916","transSequence":"2024052404265933"}
MD5计算排序后的rspBody 并转成大写
121E9DF4157A519349A718EC72A7C477
排序后rspHeader:
{"easyPayCertificateId":"00000000","rspCode":"000000","rspInfo":"成功","transCode":"0001"}
待验签内容为[verfyString]
{"easyPayCertificateId":"00000000","rspCode":"000000","rspInfo":"成功","transCode":"0001"}121E9DF4157A519349A718EC72A7C477
rspHeader对象排序后的jsonString + MD5(rspBody排序后的verfyString).toUpperCase()
签名信息
OR6IIlx4d/ozOkXde9K4oQM7rMyNXWmxOBMa6w/CGSW/uNzfRRcusMax8p1tkS2SJRjwPj5pDaRSPacNvu8qVSvEjU829qO5rKStFtzneW9JvGlsO+G4ftO0SbGdC2mvtuk/drvM4MJwFdqsttR6w5Cr+TMaD71GTVzq0/+qMFDJlbNMxYvC1EeYAFMQirZ55jVK+KhREsZ6LI4o7WGbC7+AljsUAoZ1+cQ/gIKfwLBJhu/yofxhE/idf5x6bt5omnHf9PDIIadLUXdjfspPlKOUVsZ23MoRz94WSAHPEsHDXv+ImQP+jYjBEI6BWuSZ1XYrp1b2wAe0bmY5aI/PXg==
易生提供的RSA公钥对VerfyString进行验签
测试环境易生支付公钥
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArgVerkGaSEQvZIOpLjeUoVpL0lSYLc04+txtPFtfm5r5XFbaNaf5Ahu0lziGEwWzrGONThSsnb3U9pqoY6BpqviN4h+Guw5oEdHr1T/eDkQD5urgQUaZA6lDoU9XC662r+0kpbKidvXIsK2CrShN+BF8HEJmRZuhglxh25OHWIWqQiUDjLZC+QJRZqUu9Uzy9RBBu7qa0f0xbqYl3hnYi+vH++SsyOavO2gUVQyKU5Kkt5ZJVpZFQvD3BXePgwJSpsvrjhj0hiYp2v6PScN9XHP1vXB4wtIYSFYwmVus1KkV/LfDzUm6zHjliHYTVl6lPMhveIVJlRIqInRZRHxg5QIDAQAB
生产环境易生支付公钥【易生支付通用】
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCLLVY70e67BcK4V08P+69dfBeMmMYDopf3HF9G6meqPTVxyGYlEb0XwT0UA6g8t2HzG8FaKgTFKgOvhr+EFbBcF+AYdrgFYZSjR4hWBkWiOyKC66wQ7kQhYzC4kwetcDp5TftJfSivbAC1Lm8/Gf2+ZpaDuHDPjLCFS2gQYI5dqwIDAQAB
验签结果
true
得到请求报文
{
    "rspHeader": {
        "rspCode": "000000",
        "rspInfo": "成功",
        "transCode": "0001"
    },
    "rspBody": {
        "transSequence": "2023120100000800"
    },
    "rspSign": "qSIdJLmrrgdBIBScM3MrbCPwZQBdTtDXwwtUgY2KwMxG3aOSrkPYOeEZfiEplUv0iezkS7Nxg61MVUS80gYnvkpudncdYfx2onKSEhM+uhHtN7OuhFlb+9WMtzJKHX/sOwSx3y8hnsY3S608Ot5CFU4NgR1MnU7uWoRCEWbH9QbF2P/ukR0IKHNYvngv4VERAYOkiozorO4rkdoc5iILatA+NgoMevy6ftTZt8v0pTr7ONS3okdFIuR0Tu8M7GupdHXkXG7KVPYkoh5WTM6msVPILw5FHjff6bKBowSxbpfqDO8HLxADKeru1FGxRYJTowjk9zDpoJzHYKP+UFCP9g==",
    "signType": "RSA2",
    "time": "2023-12-01 22:19:43"
}

2.3.2 示例代码【RSA为例】#

修改于 2025-03-12 02:15:30
上一页
2.2 接口规范
下一页
2.4 统一示例参数
Built with