1. 接口介绍 二维码展示页面接口提供给商户展示聚合支付二维码页面接口,聚合支付服务会根据商户在浏览器中请求数据验证商户身份,以及验证请求信息是否被篡改。验证通过后,会展示聚合支付二维码页面 撤销申请的报文需按照接口规范进行加密,详见加密算法 ``` 调用地址:https://payx.jd.com/pre 编码格式: UTF-8 调用方式:post 数据格式:application/JSON ``` 2.参数列表 |序号 |参数名称 |参数编码 |必填| 参数类型 |描述| |---| |1 |版本号 |version| 是| String| 当前固定填写:V1.0.0| |2 |应用id |systemId |是 |String |聚合支付分配系统id:systemId| |3 |商户号 |merchantNo| 是 |String |聚合商户号:请保持和PayRequest对象中merchantNo保持一致,系统会做强一致性校验| |4 |订单号 |outTradeNo |否| String |聚合支付商户订单号:<br>最长不超过32位<br>一单一码:外部订单号必传<br>同一个商户订单号,只能支付成功一次| |5 |订单金额| amount |否 |String(12) |订单金额(单位:分):<br>一单一码:订单金额必传| |6 |支付成功异步通知地址 |successNotifyUrl| 否| String(256) |支付成功异步通知地址:如果需要异步通知商户,请填写相关url| |6 |订单失效时间 |expireTime |否 |String |订单失效时间单位:秒,<br>超过有效期后,<br>不能支付带金额(一单一码)方式:如果需要设置订单失效时间,请填写该字段| |6| 交易备注 |remark |否| String |如果需要在二维码首页展示相关备注信息,请传递该字段| 3. 特殊参数说明 1)在以上的请求参数中,商户号是在注册开通聚合支付功能的时候,聚合支付商户管理系统为用户分配的。 2)外部订单号是商户自己的订单号。 3)签名规则详见:签名算法 4)为保证信息安全,表单中的各个字段除了merchant(商户号)、签名(sign)以外,其余字段全部采用3DES进行加密 4. 样例 1)一单一码: ``` { "version": "V1.0.0", "appId": "jw", "merchantNo": "110047782", "orderId": "1111111113445367", "amount": "20", "successNotifyUrl": "https://payx.jd.com", "remark": "小白兔买糖" } ``` 2)固定二维码: ``` { "version": "V1.0.0", "appId": "jw", "merchantNo": "110047782", } ``` 3)支付请求数据集合参数样例 ``` { "merchantNo":"110047938", "cipherJson:"这里的值是对明文源串样例加密得到的值", "sign":"这里的值是对明文源串样例按照ASCII正序排序后加盐,再用md5加签得到的值" } ``` 4)最终加密以及加签后,调用聚合支付展示二维码页面接口的请求url样例 ``` https://payx.jd.com/pre?merchantNo=110047782&cipherJson=AOMgGP7u1n8EguuAMjcj5TRTHk2UWGTnTChUbEf0U1cAau6UUC1VwLS_4pQtvjtOzi2MaTPQn8BlplGHhB5-62iPVtjo4wzFHdqklHSf6XusjjtqaC5kPUierZrNBFCCvkv-VlxXWUWg8ehLck250NkQNSJ1WlbJUqJgusfrlnLmpjJUnDv1WcER1UJGcDCgOcy8HvuvGskV_t7-xmcG-ZRSBWZxEImTw7DWOgS07N8&sign=c35e9763695f18168a3aab1fea7e7158 ``` 说明: ``` 上面样例中除merchant和sign字段外,各字段均需要进行3DES加密 2)请求和响应报文加密后结构一致,解密加密字符串后可以得到源文。 ```