对接规范
协议规则
传输方式:采用HTTP传输
提交方式:POST 或 GET
内容类型:application/json
字符编码:UTF-8
签名算法:MD5
参数规范
费率相关:单位为千分比,精确到小数点后4位。
时间参数:所有涉及时间参数均使用精确到毫秒的13位数值,如:1622016572190。时间戳具体是指从格林尼治时间1970年01月01日00时00分00秒起至现在的毫秒数。
签名算法
签名生成的通用步骤如下
第一步: 设所有发送或者接收到的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串stringA。
特别注意以下重要规则:
◆ 参数名ASCII码从小到大排序(字典序);
◆ 如果参数的值为空不参与签名;
◆ 参数名区分大小写;
◆ 验证调用返回或支付中心主动通知签名时,传送的sign参数不参与签名,将生成的签名与该sign值作校验。
◆ 接口可能增加字段,验证签名时必须支持增加的扩展字段
第二步: 在stringA最后拼接上key[即 StringA +"&key=" + 私钥 ] 得到stringSignTemp字符串,并对stringSignTemp进行MD5运算,再将得到的字符串所有字符转换为大写,得到sign值signValue。
如请求代理商系统参数如下:
Map<String, Object> paramsMap = new HashMap<>();
paramsMap.put("applyId", "A1950440220066045954"); // 申请单ID
paramsMap.put("agentNo", "A1682391658"); // 代理商号
paramsMap.put("ifCode", "shengpay"); // 渠道代码
paramsMap.put("reqTime", "1753945877760"); // 请求时间
paramsMap.put("version", "1.0"); // 接口版本号,固定:1.0
paramsMap.put("signType", "MD5"); // 签名类型
待签名值:
agentNo=A1682391658&applyId=A1950440220066045954&ifCode=shengpay&reqTime=1753945877760&signType=MD5&version=1.0&key=ei6IJ3mIQqRPJlHPhrMEodLcvQTmggGetZlQn13CtqpNQhWNaFvG7amBoh9bzUV3
签名结果:E722DA143376B1D69B6A05FBA437A0CA
最终请求代理商系统参数:
{"ifCode":"shengpay","applyId":"A1950440220066045954","agentNo":"A1682391658","sign":"E722DA143376B1D69B6A05FBA437A0CA","signType":"MD5","reqTime":"1753945877760","version":"1.0"}
代理商拥有自己的秘钥,请注意保管。