公共参数

请求的公共参数

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

请求示例

{
  "mchId": "商户编号",
  "appId": "应用ID",
  "projectId": "项目ID",
  "sign": "xxxxxxxxxxx",
  "signType": "SHA",
  "version": "1.0",
  "content": "VBDExvz6/k56B1S5n7n3uOvI2sxZixcsV0Tdld92ym0CpnN8ooiCkXPgg0N1z8NC",
  "timestamp": "1541661668",
  "nonceStr": "aiz04enx0a2"
}

content解密后格式

{
  "param0": 0,
  "param1": "aaa",
  "param2": {
  }
}

响应的公共参数

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

成功响应

{
 "code": 0,
 "msg": "SUCCESS",
 "result": "VBDExvz6/k56B1S5n7n3uOvI2sxZixcsV0Tdld92ym0CpnN8ooiCkXPgg0N1z8NC",
 "sign": "xxxxxxxx",
 "signType": "SHA"
}

result解密后格式

{
  "param0": 0,
  "param1": "aaa",
  "param2": {}
}

失败响应

JSON

{
  "code": -101,
  "msg": "参数错误",
  "sign": "xxxxxxxx",
  "signType": "SHA"
}