京东白条支付

一、支付产品介绍

1.1产品概述

京东白条是京东数科旗下的一款消费金融产品，用户可通过京东白条额度进行分期或信用支付。

1.2适用场景

京东白条支付主要适用于已开通京东白条额度的用户进行消费分期或信用支付，覆盖线上和线下多类场景。

业务场景	场景特点	典型应用案例
线上商城	用户在商户网页/App下单，选择京东白条支付，跳转至京东白条H5或微信小程序完成支付。	电商平台、品牌官网、垂直品类商城等支持白条分期的线上消费场景。
线下扫码	商户生成收款码或通过POS终端发起交易，用户使用京东金融App或微信扫描二维码，调起白条支付。	零售门店、餐饮、教育、3C数码等线下消费场景。
大额分期消费	单笔交易金额较高，用户选择分期减轻还款压力。	3C数码、家电、家装、教育缴费、医美等大额消费场景。

1.3商户入网

1.3.1准入材料

商户申请开通京东白条支付，需准备以下材料：

材料名称	说明
营业执照	商户主体营业执照（三证合一）
法人身份证	法定代表人身份证正反面
经营场所证明	门店照片或经营场地证明
京东白条合作协议	商户与京东签署的白条业务合作协议
其他	根据商户类型和交易场景，可能需要补充行业资质或特殊证明材料

说明： 京东白条支付需商户先行与京东数科签署白条业务合作协议，完成白条商户入驻后，方可在通联支付云商通2.0中开通该支付产品。

1.3.2准入标准

商户可联系通联分公司人员签署协议提交入网材料，审核通过入网成功后，即可进行支付产品开通。

二、技术开发准备

2.1开发环境准备

第一步：密钥获取（云梯）

设置商户公私钥、加密key

第二步：公共参数获取（云梯）

下载通联公钥

第三步：对接规范

调用通联接口，统一使用POST形式提交，数据格式统一为JOSN，相关SDK及签名方法如下：SDK示例：https://prodoc.allinpay.com/doc/1360/

三、接口说明

3.1API列表

功能	接口	描述
利息计算	【京东白条利息计算】（transCode:4037）	根据交易金额计算各分期期数的每期还款额和利息，供下单前向用户展示
订单生成	【京东白条下单】	上送payMode=JDBT_PAY，生成白条支付订单，获取H5支付链接或微信小程序支付链接
支付结果回调	【订单结果通知】	验证回调签名、更新订单状态、回复「success」防止重复回调
订单查询	【3001-订单状态查询】、【3002-订单结果查询】	查询订单状态（未收到回调时），或主动查询订单信息
退款	【2294-退款申请】	处理用户退款请求，支付金额将原路退还给用户
订单对账	【4002-对账单文件下载】	下载商户对账文件，含"分期商户贴息手续费"字段

3.2消费流程

利息计算（可选）： 商户在下单前可调用【京东白条利息计算】接口，传入交易金额和收银宝商户号，获取各分期期数对应的每期还款额和利息，在收银台向用户展示分期还款计划。起分金额为10元，仅适用于用户付息模式。

下单请求： 商户调用【京东白条下单】接口，上送支付模式 payMode=JDBT_PAY 及相关参数。

返回支付链接：通联支付返回京东白条H5支付链接（h52appurl）和微信小程序支付链接（h52miniurl），商户引导用户跳转完成支付。

用户支付： 用户在京东白条H5页面或微信小程序中确认支付，完成白条额度扣款。

结果通知： 支付完成后，通联支付通过异步通知将支付结果推送到商户指定的通知地址。

下单接口请求参数（payMode=JDBT_PAY重点关注）：

字段	字段类型	必填	字段名称
vspCusid	String	否	收银宝子商户号（集团模式必填）
cusIp	String	是	终端IP，用户下单和调起支付的终端IP地址
fqNum	String	是	分期期数，取值见下表
extendParams	String	否	扩展参数，ExtendParams实体的JSON字符串
remark	String	否	备注，透传至收银宝remark

fqNum取值说明：

取值	说明
1,1	京东白条支付（不分期）
3	三期用户付息
3,1	三期商户贴息
6	六期用户付息
6,1	六期商户贴息
12	十二期用户付息
12,1	十二期商户贴息
24,1	二十四期商户贴息

下单接口响应参数（重点关注）：

字段	字段类型	必填	字段名称
respCode	String	是	业务返回码，00000代表成功
respMsg	String	是	业务返回说明
chnlFrontParamInfo	JSON	否	渠道参数信息，包含h52appurl和h52miniurl

chnlFrontParamInfo 中包含以下两个支付链接：

h52appurl： H5跳转到京东白条App支付的URL

h52miniurl： H5跳转到京东微信小程序支付的URL

3.3退款流程

若用户需要退款则可调用退款接口，将接口调用成功后支付金额将原路退还给客户。退款需上传参数如下：

字段	字段类型	是否必填	字段名称
orgRespTraceNum	String	否	原通联订单号
orgReqTraceNum	String	否	商户订单号，唯一不可重复
orgTransDate	String	否	订单时间，yyyy-MM-dd
orderAmount	Long	是	退款总金额（单位：分）
respUrl	String	否	后台通知地址

上传参数时“orgRespTraceNum”和“orgReqTraceNum+orgTransDate”二选一即可成功调用退款接口
退款支持部分退款和全额退款，同时支持多次退款。退款金额不能大于支付金额。

3.4订单管理

客户支付完成后，通联支付将支付结果推送到商户异步地址【订单结果通知】。若长时间未收到异步结果，可调用【3001-订单状态查询】或【3002-订单结果查询】接口查询交易状态。

订单类型	订单状态	场景说明
消费	0：进行中	待支付：商户成功调用下单接口，获取支付链接，等待用户跳转支付。
	0：进行中	支付中：用户已跳转至京东白条，正在确认支付/验证身份，通道处于交易处理中。
	1：交易成功	支付成功：京东白条已完成额度扣款。
	2：交易失败	支付失败：用户主动取消支付、额度不足、账户异常、交易被风控拦截等。
退款	0：进行中	退款中：商户已调用退款接口，通联受理退款请求，京东/银行正在处理退款。
	1：交易成功	退款成功：资金已原路退回用户白条账户，退款流程完结。
	2：交易失败	退款失败：超过退款有效期、通道拒绝、账户异常等原因导致退款无法完成。

3.5订单对账

为满足财务对账需求，通联支持商户下载对账文件。具体方式如下：

门户下载对账文件：可在商户门户【对账单下载】菜单下载对账文件

调用API接口获取对账文件

商户可调用【下载商户对账文件】接口下载对账文件，支持日度、月度对账文件获取，文件格式支持CSV/Excel，包含订单号、交易金额、退款金额、手续费、交易时间、支付方式等核心字段。