公共参数
请求的公共参数
| 名称 | 类型 | 签名 | 必填 | 描述 |
|---|---|---|---|---|
| mch_id | String | 是 | 是 | app_id对应的开发者ID,直连模式填入客户的mch_id,ISV模式填入ISV的mch_id |
| app_id | String | 是 | 是 | 开放平台分配的应用ID |
| timestamp | String | 是 | 是 | 毫秒值时间戳,13位长1734507275146。服务端允许客户端请求最大时间误差为5分钟 |
| nonce_str | String | 是 | 是 | 随机字符串,不长于32位,每次请求需唯一 |
| sign_type | String | 是 | 是 | 签名类型,默认填:SHA。(暂只支持SHA) |
| content | String | 是 | 是 | 请求参数的集合,最大长度不限,API请求Json转字符串格式。除公共参数外所有请求参数都必须放在这个参数中传递,具体参照接入文档。content内容需做AES对称加密并转为base64格式字符串 |
| version | String | 是 | 否 | 版本号,固定填"1.0" |
| sign | String | 否 | 是 | 签名 签名方法 |
请求示例
{
"mch_id": "商户编号",
"app_id": "应用ID",
"timestamp": "1541661668",
"nonce_str": "aiz04enx0a2",
"sign": "xxxxxxxxxxx",
"sign_type": "SHA",
"version": "2.0",
"content": "VBDExvz6/k56B1S5n7n3uOvI2sxZixcsV0Tdld92ym0CpnN8ooiCkXPgg0N1z8NC"
}
content解密后格式
{
"param0": 0,
"param1": "aaa",
"param2": {
}
}
响应的公共参数
| 名称 | 类型 | 签名 | 必填 | 描述 |
|---|---|---|---|---|
| code | int | 是 | 是 | 返回码,0为成功,小于0为失败 |
| msg | String | 是 | 是 | 返回信息 |
| result | String | 是 | 否 | 返回码为0时返回,经AES对称加密的base64格式字符串。解密后为接口响应返回的具体内容, json格式字符串。 |
| sign_type | String | 是 | 是 | 签名类型,默认填:SHA。(暂只支持SHA) |
| sign | String | 否 | 是 | 返回签名 签名方法 |
成功响应
{
"code": 0,
"msg": "SUCCESS",
"result": "VBDExvz6/k56B1S5n7n3uOvI2sxZixcsV0Tdld92ym0CpnN8ooiCkXPgg0N1z8NC",
"sign": "xxxxxxxx",
"sign_type": "SHA"
}
result解密后格式
{
"param0": 0,
"param1": "aaa",
"param2": {}
}
失败响应
JSON
{
"code": -101,
"msg": "参数错误",
"sign": "xxxxxxxx",
"sign_type": "SHA"
}