跳到主要内容

公共参数

请求的公共参数

名称类型签名必填描述
mch_idStringapp_id对应的开发者ID,直连模式填入客户的mch_id,ISV模式填入ISV的mch_id
app_idString开放平台分配的应用ID
timestampString毫秒值时间戳,13位长1734507275146。服务端允许客户端请求最大时间误差为5分钟
nonce_strString随机字符串,不长于32位,每次请求需唯一
sign_typeString签名类型,默认填:SHA。(暂只支持SHA)
contentString请求参数的集合,最大长度不限,API请求Json转字符串格式。除公共参数外所有请求参数都必须放在这个参数中传递,具体参照接入文档。content内容需做AES对称加密并转为base64格式字符串
versionString版本号,固定填"1.0"
signString签名 签名方法

请求示例

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

响应的公共参数

名称类型签名必填描述
codeint返回码,0为成功,小于0为失败
msgString返回信息
resultString返回码为0时返回,经AES对称加密的base64格式字符串。解密后为接口响应返回的具体内容, json格式字符串。
sign_typeString签名类型,默认填:SHA。(暂只支持SHA)
signString返回签名 签名方法

成功响应

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