平台文档

主题

接口规则 ​

协议规则 ​

  • 传输方式：采用HTTP传输(生产环境建议HTTPS)
  • 提交方式：POST
  • 内容类型：application/json
  • 字符编码：UTF-8
  • 签名算法：MD5

请求头 ​

请求头格式要求

json
{
	"T-Open-Mch-No":"M16****12", // 商户号 
	"T-Open-Signature":"***", // 签名算法的结果
	"Content-Type":"application/json",
	"charset":"UTF-8" 
}

签名算法(T-Open-Signature) ​

  • 第一步： 设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。

特别注意以下重要规则：

  • 参数名ASCII码从小到大排序（字典序）；
  • 如果参数的值为空不参与签名；
  • 参数名区分大小写；
  • 验证调用返回或通讯平台主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
  • 通讯平台接口可能增加字段，验证签名时必须支持增加的扩展字段
  • 第二步： 在stringA最后拼接上key[即 StringA +"&key=" + 私钥 ] 得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。

请求参数如下：

json
{
  "mobile": "13800138000",
  "templateCode": "1000000",
  "params": {"code": "123456"},
  "ext": "2022081901",
  "callbackUrl": "http://127.0.0.1:48080/api/callback"
}

待签名值 ( "key=" + 私钥)

// 处理嵌套的对象结构,需要将复杂的对象转化为标准化的 JSON 字符串并重新构造成 Map 类型。
callbackUrl=http://127.0.0.1:48080/api/callback&ext=2022081901&mobile=13800138000&params={"code":"123456"}&templateCode=1000000&key=c9db7a6a119b4f439036f5e3610a1b8b

签名结果（示例）

7B8660451649238D743C27E2593BB898