Skip to content

接口描述:

下述参数中提到的ROOT_URL,appId,secretKey参数可通过如下两种方式得到:

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

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

接口版本:

版本日期描述作者

协议规则

传输方式:采用HTTP/HTTPS传输 提交方式:采用GET/POST 方式提交 字符编码:UTF-8

接口地址

ROO_URL:https://mch.s.yunfuyitong.cn

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

公共参数

接口中的version默认1.0

参数名说明
appIdappId,请与对接人获取
deviceId设备编号,设备的IMEI等,请确保唯一性,调用接口前请将设备号告知对接人员
requestTime请求时间时间戳(单位:秒)
sign验签的sign,详见下方签名方式
merchantId商户号,在 “设备初始化” 接口获取,设备初始化接口此值传空即可
productNum产品编号,默认值:123456
data业务参数序列化后赋值给此字段,该字段为JSON字符串格式

返回参数

  1. 服务端返回数据为json格式,参数说明:
参数类型是否必填描述示例值
codeString接口返回码,00000表示业务处理成功00000
messageString接口返回描述,业务处理失败时,返回错误信息success
dataJson接口返回的数据{}

返回数据参考:

{
  "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