二维码url链接生成接口（一单一码+静态码）|京东聚合支付开发者文档

1. 说明
一单一码返回二维码URL信息接口：针对商户有相关页面，只需要聚合支付相关二维码信息的需求，提供给商户返回二维码中相关信息。商户需将相关信息通过二维码生成工具生成二维码展示到自己的页面中。聚合支付服务会根据商户在浏览器中请求数据验证商户身份，以及验证请求信息是否被篡改。验证通过后，会生成相关二维码信息，通过加密方式返回给相关商户。

```
调用地址：https：//payx.jd.com/getScanUrl
编码格式： 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	|聚合支付商户订单号：最长不超过32位一单一码：外部订单号必传同一个商户订单号，只能支付成功一次|
|5	|订单金额	|amount	|否	|String(12)	|订单金额(单位：分)：一单一码：订单金额必传|
|6|	支付成功异步通知地址|	successNotifyUrl	|否	|String(256)|	支付成功异步通知地址：如果需要异步通知商户,请填写相关url|
|6|	订单失效时间|	expireTime|	否|	String|	订单失效时间单位：秒,超过有效期后,不能支付带金额(一单一码)方式：如果需要设置订单失效时间，请填写该字段|
|6|	交易备注|	remark	|否	|String	|如果需要在二维码首页展示相关备注信息,请传递该字段”|
3. 查询接口返回参数
支付方式的明细参数：

|参数名称	|参数编码|是否必返	|参数类型|	描述|
|---|---|---|---|--|
|是否成功|	isSuccess|	是|	boolean	|获取二维码是否成功标识|
|结果码	|code|	是|	String(100)	|聚合支付响应码：当isSuccess为false时,查看相关code|
|结果信息	|message|	是	|String(100)|	聚合支付响应信息：当isSuccess为false时,查看相关异常信息|
|商户号	|merchantNo	|是	|String(100)	|聚合商户号：请保持和PayRequest对象中merchantNo保持一致,系统会做强一致性校验|
|二维码链接url	|scanUrl	|是|	String(512)	|当isSuccess是true时,返回线下支付：扫码二维码链接url|

4. 参数特殊说明
```
1)在以上的请求参数中，商户号是在注册开通聚合支付功能的时候，聚合支付商户管理系统为用户分配的。
2)外部订单号是商户自己的订单号。
3)签名规则详见：签名算法
4)为保证信息安全，表单中的各个字段除了merchant（商户号）、签名（sign）以外，其余字段全部采用3DES进行加密
5.明文源串样例
```
1)一单一码：
```
{
"version"："V1.0.0",
"appId"："jw",
"merchantNo"："110047782",
"orderId"："1111111113445367",
"amount"："20",
"successNotifyUrl"："https：//payx.jd.com",
"remark"："小白兔买糖"
}
```
最终加密以及加签后,调用聚合支付返回二维码URL信息接口的请求url样例：

```
https：//payx.jd.com/getScanUrl?merchantNo=110047782&cipherJson=AOMgGP7u1n8EguuAMjcj5TRTHk2UWGTnTChUbEf0U1cAau6UUC1VwLS_4pQtvjtOzi2MaTPQn8BlplGHhB5-62iPVtjo4wzFHdqklHSf6XusjjtqaC5kPUierZrNBFCCvkv-VlxXWUWg8ehLck250NkQNSJ1WlbJUqJgusfrlnLmpjJUnDv1WcER1UJGcDCgOcy8HvuvGskV_t7-xmcG-ZRSBWZxEImTw7DWOgS07N8&sign=c35e9763695f18168a3aab1fea7e7158
```
2) 查询返回报文样例
调用聚合支付返回二维码URL信息接口的响应数据样例：：

```
{
"merchantNo"："110047782",
"cipherJson"："zSO7OuBNvLi0v-KULb47Ts4tjGkz0J_AnvGjpNNkEX7oc0LZAOjG78YZNk4SXB4Z32KkMRaY_Ih4Tktf8cKIDqyyM1oW3DWlGm-5pk2vjU_iya7HN215GHkomGO2r6SuDSFDYf8nZXkORlwFmLFUl8MpKDjA2Ngkl46RenROr9MyBYKFkr6Et9iartvVaGfcPEGmm6TsMN9C3ZhWTkyxlJ5DQAr6X2U4d-Lf3EBTArU96A1UulvMeGr7x9Tda3oHRyZrr9lHfwdj2aq0UyPBd--WEY9AOh1jfVwmAP4iKrrQNcVe0c0GnvhjBDhtbdCMrMz5nCq193lCe7EwS8F_l5F9eEhuw2Q0Fg7j4wixWuqvxCMnZzBcsVF-ldHMg-b6jEAq2jcNdIXxsF8en6tQCw5blqxKeaouuaejds8vLVwxmw_MfOOJu0Lc--WsJ74XEferdJpJnwl5W09y6OdM-PageI2jFjGRMZzZBbWvtDmbuEG-l7BTquhOaGG0ye23ocpDrsWNTb8t_XMl23gQlV99Y-hXZEG9HWv5MINnZIp2vHAMFNF4dUM6t9BWvRvlR46RG-m-UlRsMs0gBqBzoQ",
"sign"："f93089d59594dae9a25a12bc25fcf2af"
}
```
说明：
```
上面样例中除merchant和sign字段外，各字段均需要进行3DES加密
2)请求和响应报文加密后结构一致，解密加密字符串后可以得到源文。
```