对接必读接口文档

签名算法说明

RSA 签名

对请求参数（不包含 hmac）按参数名字母进行升序排列；

使用 key=value 的格式拼接，用 & 连接；

示例：a=xx&b=yy&c=yy

使用慧徕店提供的开发者秘钥对拼接结果进行 RSA 加密，得到最终的 hmac。

X99 签名

同样对请求参数（不包含 hmac）按参数名字母进行升序排列；

拼接格式同上；

使用签到下发的 MAC 密钥进行 X99 单 DES 加密，得到最终的 mac。

MD5 签名

对请求参数（不包含 hmac）按参数名字母进行升序排列；

使用 key=value 的格式拼接；

拼接结果再追加 &key=商户密钥或应用密钥；

将最终结果进行 MD5 加密，转为大写即为 hmac。

hmac 计算说明

排除 hmac 字段，对参数按字母升序排序；

使用 key=value 拼接，使用 & 连接；

若字段值为空，则不参与签名计算；

reqData 内部字段无需排序，但顺序需与原始报文一致。

示例拼接：

outOut=1234545677&randomData=sdfgglgldl&characterSet=UTF-8&merchantId=21213643587457&signType=MD5&version=1.0.0&oprId=000001&ipAddress=137.169.23.22&type=scanPay&reqData={a=1,b=2}

加密原报文示例

characterSet=UTF-8&randomData=17953f4869fc40d1a813e33496a0ab80&reqData={merchantCode=909290010743226,orderId=900000060000220525155740613,appConfigId=1528754803286040578,ipAddress=127.0.0.1,tradeWay=WX,tradeAmt=2,authCode=130063947837230903,settleType=1,limitPay=0,notifyUrl=127.0.0.1,tradeName=商品名称}&signType=MD5&timestamp=20220525155811&version=1.0.0&key=6f0bf6c92ca545289bdd2c8875e700d1

加密 demo 下载地址

点击下载 demo

测试环境请求地址

交易地址：
https://jvhueapnfeuuaceiq.huilaidian.com.cn/openapipay/openapi-pay/

完整被扫请求地址：
https://jvhueapnfeuuaceiq.huilaidian.com.cn/openapipay/openapi-pay/mobileTrade/scanPay

接入方式

类型	是否上送 appId	是否上送 appConfigId	加密方式
应用模式接入	否	是	MD5

接口请求公共参数

字段名称	中文描述	数据类型	说明
characterSet	字符编码	String	统一上送 UTF-8
appId	接入方标识	String	由慧徕店提供
signType	签名加密方式	String	有银行卡业务时上送 X99，否则上送 RSA/MD5
hmac	签名值	String	见签名算法
randomData	请求唯一 ID	String	要求保证唯一
timestamp	请求时间	String	格式为 yyyyMMddHHmmss
version	版本号	String	默认为 1.0.0
reqData	业务参数	Object	详情见业务接口文档

接口响应公共参数

字段名称	中文描述	数据类型	说明
code	返回码	String	成功返回 `000000`
hmac	签名值	String	签名值
data	业务参数	Object	返回的业务数据
msg	返回消息	String	提示消息
pager	分页对象	Object	分页查询场景使用
timestamp	返回时间	String	格式为 yyyyMMddHHmmss

示例

请求示例（银行卡消费接口）

{
  "reqData": {
    "tradeAmt": "01",
    "tradeWay": "1212"
  },
  "randomData": "",
  "timestamp": "",
  "characterSet": "UTF-8",
  "signType": "X99",
  "version": "1.0.0",
  "hmac": "DX819DKAJSNDJA"
}

响应示例

{
  "code": "000000",
  "data": {
    "tradeAmt": "1212",
    "tradeStatus": "1"
  },
  "hmac": "XJDJAI1IIDJ",
  "msg": "操作成功",
  "pager": null,
  "timestamp": "20211223213102"
}

条码被扫接口示例

请求报文

{
  "randomData": "1a57c22704bb43a6b8f330b083db1e43",
  "timestamp": "20220617165626",
  "characterSet": "UTF-8",
  "signType": "X99",
  "version": "1.0.0",
  "reqData": {
    "appConfigId": "1528754803286040578",
    "authCode": "134238614166008536",
    "ipAddress": "127.0.0.1",
    "limitPay": "0",
    "merchantCode": "909290010743226",
    "notifyUrl": "http://baidu.com",
    "orderId": "auto1686982582453",
    "settleType": "1",
    "tradeAmt": "1",
    "tradeName": "商品名称",
    "tradeWay": "WX"
  },
  "hmac": "098898A9AE16890B2E3C771F02F3BAA0"
}

加签&验签

对接必读接口文档#

签名算法说明#

RSA 签名#

X99 签名#

MD5 签名#

hmac 计算说明#

示例拼接：#

加密原报文示例#

加密 demo 下载地址#

测试环境请求地址#

接入方式#

接口请求公共参数#

接口响应公共参数#

示例#

请求示例（银行卡消费接口）#

响应示例#

条码被扫接口示例#

请求报文#