F.22 白条 orderInfo/goodsInfo 参数附加说明
一、交易下单环节
行二维码服务交易下单时，需借助acqAddnData（收款方附加数据）字段将发卡侧（此处特指京东）指定数据
予以输入，以便消费者后续进入京东收银台侧进行对应交互、展示处置。
| num | key | value | 格式 | 出现要求 | 备注 | 备注：对比 v1.0 |
|---|---|---|---|---|---|---|
| 1 | preproduct | bt | 必填 | 白条前置标识，用于识别收银台侧仅展示白条支付工具。 | / | |
| 2 | installmentNum | "3", "6", "12" | int | 选填 | 默认选中期数，代表用户使用的白条支付时选择的分期数，进入京东收银台后默认选中的分期数。非预锁分期时使用。 | / |
| 3 | lockplan | "3", "6", "12" | int | 选填 | 预锁分期活动，用于收银台侧展示对应的分期活动信息。 | / |
| 4 | a_o_s_c_u | 选填 | 支付成功指定跳转地址： openapp 前缀链接，会跳转回商户 App https 前缀链接，会在京东App打开H5跳转 | |||
| 5 | riskInfo | "{'industryNo':'11111'}" | Json String | 必填 | 白条侧策略采集字段信息。 | / |
| 6 | industryNo | string | 必填 | 行业编码，指定的白条定义的“标准商户类别码”（4位编码）。 | / | |
| 7 | routeLable | String | 必填 | 固定值： 三方支付：thirdPay， 三方支付指定商户交易：thirdPayMerchant | 新增三方支付指定商户交易传参 | |
| 8 | tradeScene | String | 必填 | 固定值： 线上：01，线下：02 | / | |
| 9 | ifPickup | String | 线上场景必填 | 固定值： 配送：01，自提：02 | 新增 | |
| 10 | province | String | 线上场景必填 | 如加密，需支持解析； 用于校验是否存在收货省市聚集，并校验收货位置 是否用户日常位置信息一致。 | 新增 | |
| 11 | city | String | 线上场景必填 | 如加密，需支持解析； 用于校验是否存在收货省市聚集，并校验收货位置是否用户日常位置信息一致。 | 新增 | |
| 12 | orderSource | string | 线下or自提必填 | 消费者下单来源，传中文，枚举如微信APP扫一扫、京东金融、京东。 | / | |
| 13 | merchantType | string | 线下or自提必填 | 商户类型，固定传参，选择其中一文传入： 企业，个体户，自然人 | / | |
| 14 | payUserId | string | 选填 | 三方支付侧用户ID，线下or自提，如有则传。 | / | |
| 15 | payCodeId | string | 线下or自提必填 | 商户收款码ID，可以是商家展业所应用的静态码/动态码所发生的终端设备唯一识别序列号。 | / | |
| 16 | shopProvince | String | 线下or自提必填 | 商户所在省，上海/广东/ 新疆 | / | |
| 17 | shopCity | String | 线下or自提必填 | 商户所在市，上海市/广州市/乌鲁木齐市 | / | |
| 18 | shopCounty | String | 线下or自提必填 | 商户所在区，浦东新区/天河区/ 新市区 | / | |
| 19 | shopAddress | String | 线下or自提必填 | 商户详细地址，xx省xx市xx区xxxxxx街xxxx号（要有省、市、区三字） | / | |
| 20 | orderEid | String | 线上场景必填 | 下单设备号，需是设备在商户侧唯一标识 | 新增 | |
| 21 | orderIp | String | 线上场景必填 | 下单ip | 新增 | |
| 22 | orderAccount | String | 线上场景必填 | 下单账号，用户在商户侧唯一标识 | 新增 | |
| 23 | acctRegTime | String | 线上场景必填 | 下单账号注册时间，yyyy-mm-dd hh:mm:ss | 新增 | |
| 24 | name | String | 线上场景必填 | 收货人姓名，如加密，需支持解析 | 新增 | |
| 25 | address | String | 线上场景必填 | 收货地址，如加密，需支持解析 | 新增 | |
| 26 | mobile | String | 线上场景必填 | 收货手机号，如加密，需支持解析 | 新增 | |
| 27 | id | String | 选填 | 商品编号，如有则填，如加密，需支持解析 | 新增 | |
| 28 | goodsName | String | 线上场景必填 | 商品名称，如加密，需支持解析 | 新增 | |
| 29 | type | String | 选填 | 商品类型，固定传参： 实物：GT01，虚拟：GT02 | 新增 | |
| 30 | price | String | 线上场景必填 | 商品单价，如加密，需支持解析 单位：分 | 新增 | |
| 31 | num | int | 线上场景必填 | 商品数量，如加密，需支持解析 | 新增 |
银联接口现有字段goodsInfo中的子字段id，用于约定白条指定的订单维度的指定营销。如：双方约定bt123为商户贴息，白条运营配置好对应的活动 后，商户下单传入该字段，则该笔订单免息。若无则传空。
二、页面跳转环节
进行拼接后返回至前端页面，将用户带入此页面完成后续支付确认环节。
https://jdpaycert.jd.com/scan/unionPay/degrade?wxMiniFlag=1&merchantSecondNo={银联商编}&qrCode={银联单号}
注：银联商编特指机构的特约商户于银联侧的标识id，即15位商户代码。qrCode银联单号特指银联二维码下单
接口返回的qrcode。
举例：https://jdpaycert.jd.com/scan/unionPay/degrade?merchantSecondNo=836102457140017&qrCode=https://qr.95516.com/00010000/013173357680027
36404714928011358
示例：
addnInfo字段格式如下：
{"installmentNum":3,"lockplan":3,"preproduct":"bt","a_o_s_c_u":"http://www.baidu.com\",\"riskInfo\":{\"acctRegTime\":\"2025-05-14 13:40:00","address":"天百中心","city":"西青区","goodsName":"水果","id":"1111","ifPickup":"01","industryNo":"5677","merchantType":"个体户","mobile":"15612339876","name":"小花","num":1,"orderAccount":"123456788","orderEid":"12345678","orderIp":"127.0.0.1","orderSource":"微信APP扫一扫","payCodeId":"","payUserId":"","price":"100","province":"天津市","routeLable":"thirdPay","shopAddress":"陇海路180号","shopCity":"上海市","shopCounty":"浦东区","shopProvince":"上海","tradeScene":"01","type":"GT01"}}修改于 2025-06-09 07:09:29