F.22 白条 orderInfo/goodsInfo 参数附加说明

一、交易下单环节

当消费者于收单机构特约商户的收银台页面选择“京东白条”作为支付方式时，收单机构通过银联通道进
行二维码服务交易下单时，需借助acqAddnData（收款方附加数据）字段将发卡侧（此处特指京东）指定数据
予以输入，以便消费者后续进入京东收银台侧进行对应交互、展示处置。

字段1： orderInfo（订单信息）---addnInfo（附加信息）增加字段：

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	线上场景必填	商品数量，如加密，需支持解析	新增

字段2：goodsInfo（商品信息） ---id

银联接口现有字段goodsInfo中的子字段id，用于约定白条指定的订单维度的指定营销。如：双方约定bt123为商户贴息，白条运营配置好对应的活动后，商户下单传入该字段，则该笔订单免息。若无则传空。

二、页面跳转环节

收单机构通过银联通道进行二维码服务交易下单成功后，服务端将所获取的qrCode（二维码）按照京东侧预置规则（见下方）
进行拼接后返回至前端页面，将用户带入此页面完成后续支付确认环节。
https://jdpaycert.jd.com/scan/unionPay/degrade?merchantSecondNo={银联商编}&qrCode={银联单号}
注：银联商编特指机构的特约商户于银联侧的标识id，即15位商户代码。qrCode银联单号特指银联二维码下单
接口返回的qrcode。
举例：https://jdpaycert.jd.com/scan/unionPay/degrade?
merchantSecondNo=836102457140017&qrCode=https://qr.95516.com/00010000/013173357680027
36404714928011358
交互实例如下：

收单机构通过银联通道进行二维码服务交易下单成功后，服务端将所获取的qrCode（二维码）按照京东侧
预置规则（见下方）进行拼接后返回至前端页面，将用户带入此页面完成后续支付确认环节。
https://jdpaycert.jd.com/scan/unionPay/degrade?merchantSecondNo={银联商编}&qrCode={银联单号}
注：银联商编特指机构的特约商户于银联侧的标识id，即15位商户代码。qrCode银联单号特指银联二维码下单
接口返回的qrcode。
举例：https://jdpaycert.jd.com/scan/unionPay/degrade?
merchantSecondNo=836102457140017&qrCode=https://qr.95516.com/00010000/013173357680027
36404714928011358
交互实例如下：

1、机构/服务商收银台页面

用户操作：

点击“支付”按钮后跳转至京东侧中转页服务。

机构侧实施内容：

用户扫码后进入收银台页面，增加京东白条入口。选择后点击去支付，拼接京东码付收银台跳转链接，拼接方式：https://jdpaycert.jd.com/scan/unionPay/degrade?merchantSecondNo={银联商编}&qrCode={银联单号}

2、跳转至京东中转页服务

用户操作：

跳转京东App或京东金融App打开。优先京东App

3、京东SDK收银台

用户操作：

通过银联侧查询订单信息，通过备注字段将用户所选的白条分期期数等信息带入，展示在页面上。
收单机构在银联下单时，发卡侧通过以下两个拓展字段采集进行收银台展示渲染。
orderInfo（订单信息）---addnInfo（附加信息）
goodsInfo（商品信息）---id (活动识别标识)

目前仅支持通过微信进行扫码支付，选择白条支付，通过中转页即可拉起支付进行跳转京东系APP进行支付。
注：当前京东侧只通银联生产环境，测试环境无法走通，需要机构侧在生产环境使用测试商户号进行联调。上
线后一定要提供白条侧交易订单用于风险字段和策略验证，验证通过后，风险策略才会放开。

示例：

京东白条使用json字符串形式定义
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"}}

F.22 白条 orderInfo/goodsInfo 参数附加说明

一、交易下单环节#

二、页面跳转环节#

1、机构/服务商收银台页面#

用户操作：#

机构侧实施内容：#

2、跳转至京东中转页服务#

用户操作：#

3、京东SDK收银台#

用户操作：#

示例：#

一、交易下单环节

二、页面跳转环节

1、机构/服务商收银台页面

用户操作：

机构侧实施内容：

2、跳转至京东中转页服务

用户操作：

3、京东SDK收银台

用户操作：

示例：