# 接口说明

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

## 参数规范
> **交易金额**：默认为人民币交易，单位为分，参数值不能带小数。
> **时间参数**：所有涉及时间参数均使用精确到毫秒的13位数值，如：1622016572190。时间戳具体是指从格林尼治时间1970年01月01日00时00分00秒起至现在的毫秒数。

## 签名算法
:::highlight orange 📌
签名生成的通用步骤如下
:::
**第一步**： 设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
特别注意以下重要规则：
◆ 参数名ASCII码从小到大排序（字典序）；
◆ 如果参数的值为空不参与签名；
◆ 参数名区分大小写；
◆ 验证调用返回或支付中心主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
◆ 支付中心接口可能增加字段，验证签名时必须支持增加的扩展字段

**第二步**： 在stringA最后拼接上key[即 StringA +"&key=" + 私钥 ] 得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。

如请求支付系统参数如下：
```java

        Map<String, Object> paramsMap = new HashMap<>();
        paramsMap.put("mchNo", "M1682391685");                   // 商户号
        paramsMap.put("appId", "6447428682ca7458118af79f");      // 应用ID
        paramsMap.put("mchOrderNo", "mho1694051705945");         // 商户订单号
        paramsMap.put("wayCode", "ALI_BAR");                     // 支付方式
        paramsMap.put("amount", 1L);                             // 金额，单位分
        paramsMap.put("currency", "CNY");                        // 币种，目前只支持cny
        paramsMap.put("clientIp", "192.166.1.132");              // 发起支付请求客户端的IP地址
        paramsMap.put("subject", "商品标题");                     // 商品标题
        paramsMap.put("body", "商品描述");                        // 商品描述
        paramsMap.put("notifyUrl", "https://www.jeequan.com");   // 异步通知地址
        paramsMap.put("reqTime", "1694051706");                  // 请求时间
        paramsMap.put("version", "1.0");                         // 接口版本号，固定：1.0
        paramsMap.put("signType", "MD5");                        // 签名类型
        paramsMap.put("channelExtra", "{\"authCode\":\"284957415846666792\"}");  // 渠道参数
```

**待签名值**：
amount=1&appId=6447428682ca7458118af79f&body=商品描述&channelExtra={“authCode”:”284957415846666792”}&clientIp=192.166.1.132&currency=CNY&mchNo=M1682391685&mchOrderNo=mho1694051705945&notifyUrl=https://www.jeequan.com&reqTime=1694051706&signType=MD5&subject=商品标题&version=1.0&wayCode=ALI_BAR&key=UNpEETkvMpqC9oDLBr9S2X7U92k462h3zhHiy7hj4xbw23PiWhMv6TCAQ2vh8PzynZXZYo9n6puxHkAHG7li6LZi8IpaQrshzydnBll64iKlb4U59ggiyCTaHJeqffiW

签名结果：924065BA077FA461A9B06D2E76E9ED3C

**最终请求支付系统参数**：
{“amount”:1,”mchOrderNo”:”mho1694051705945”,”subject”:”商品标题”,”wayCode”:”ALI_BAR”,”sign”:”924065BA077FA461A9B06D2E76E9ED3C”,”reqTime”:”1694051706”,”body”:”商品描述”,”version”:”1.0”,”channelExtra”:”{"authCode":"284957415846666792"}”,”appId”:”6447428682ca7458118af79f”,”clientIp”:”192.166.1.132”,”notifyUrl”:”https://www.jeequan.com","signType":"MD5","currency":"CNY","mchNo":"M1682391685"}