公共参数&签名 - 昊天数据V4

接口描述：
下述参数中提到的ROOT_URL，appId，secretKey参数可通过如下两种方式得到：

方式1：由聚合支付系统侧线下提供，设备接入方将参数写入设备中使用
方式2：调用统一设备平台接口获取获取设备支付参数

说明：大部分使用方式2实现，如不想依赖计全统一设备平台可使用方式1实现。
统一设备平台是为了方便更多设备厂商接入计全聚合支付系统而实现，只提供设备参数统一获取，不参与支付逻辑。

接口版本：
版本V4
日期202504
描述完善了部分细节
作者：周洋东
协议规则
传输方式：采用HTTP/HTTPS传输
提交方式：采用GET/POST 方式提交
字符编码：UTF-8

接口地址
ROO_URL：https://mch.s.haotiandate.com

说明：接口的完整地址为：ROOT_URL + 接口URL

公共参数
接口中的version默认1.0

参数名说明
appId appId，请与对接人获取
deviceId 设备编号，设备的IMEI等，请确保唯一性，调用接口前请将设备号告知对接人员
requestTime 请求时间时间戳（单位：秒）
sign 验签的sign，详见下方签名方式
merchantId 商户号，在 “设备初始化” 接口获取，设备初始化接口此值传空即可
productNum 产品编号，默认值：123456
data 业务参数序列化后赋值给此字段，该字段为JSON字符串格式
返回参数
服务端返回数据为json格式，参数说明：
参数类型是否必填描述示例值
code String 是接口返回码，00000表示业务处理成功 00000
message String 是接口返回描述，业务处理失败时，返回错误信息 success
data Json 否接口返回的数据 {}
返回数据参考：

{
"code": "00000",
"message": "SUCCESS",
"deviceId": "xxxxx",
"result": {}
}
安全规范
1、签名方式
secretKey：私钥

按照secretKey放在首位，然后把上面参数按照从低到高顺序排列，并转MD5后再转小写；拼接方式如：{secretKey}{appId}{data}{deviceId}{merchantId}{productNum}{requestTime}

签名例子：

{
"appId": "appid1007005",
"data": "{"deviceOrderNum":"20210506180217050000"}",
"deviceId": "1",
"requestTime": "1620295342",
"sign": "6a158f0055c62f80f7767569fce6880e",
"merchantId": "7005",
"productNum": "1007005"
}

MD5({secretKey}{appId}{data}{deviceId}{merchantId}{productNum}{requestTime})
= d2jHFhvryHJyAUKShEsPL53ZtLYvUX0Iappid1007005{"deviceOrderNum":"20210506180217050000"}1700510070051620295342
= 6a158f0055c62f80f7767569fce6880e
2、涉及隐私相关的使用HTTPS