4.3.2京东白条下单


接口地址:https://vsp.allinpay.com/apiweb/tlfqf/jdbtpay

使用场景:

京东白条交易下单接口,同时返回H5跳京东app的url和跳微信小程序的url

请求参数:

参数

参数名称

取值

可空

最大长度

备注

业务参数

cusid

商户号

平台分配的商户号

15

 

appid

应用ID

平台分配的APPID

8

 

version

版本号

接口版本号

2

默认填12

trxamt

交易金额

单位为分

15

 

reqsn

商户交易单号

商户的交易订单号

32

保证商户平台唯一

body

订单标题

订单商品名称,为空则以商户名作为商品名称

100

最大100个字节(50个中文字符)

remark

备注

备注信息

160

最大160个字节(80个中文字符)

validtime

有效时间

订单有效时间,以分为单位,不填默认为5分钟

2

最大60分钟

notify_url

交易结果通知地址

接收异步通知回调地址,通知url必须为直接可访问的url,不能携带参数。

256

因为刷卡支付交易结果实时返回,因此对于刷卡支付,该字段无效

cusip

终端ip

用户下单和调起支付的终端ip地址

16

 

fqnum

分期期数

3,6,12

4

 

extendparams

扩展参数

Extendparams实体的json字符串,注意是String

一般用于渠道的活动参数填写

详看附录

 

-

 

randomstr

随机字符串

商户自行生成的随机字符串

32

 

signtype

签名方式

 

8

SM2

RSA

sign

签名

详见安全规范

32

 

响应参数:

字段ID

字段名称

取值

可空

最大长度

备注

retcode

返回码

SUCCESS/FAIL

 

8

此字段是通信标识,非交易结果,交易是否成功需要查看trxstatus来判断

retmsg

返回码说明

 

100

 

randomstr

随机字符串

随机生成的字符串

32

SUCCESS返回

sign

签名

详见安全规范

32

SUCCESS返回

业务参数 当retcode为SUCCESS时有返回

trxstatus

交易状态

交易的状态,

0000:下单成功,请完成支付

其余错误码看错误信息

 

4

详见附录

errmsg

错误原因

失败的原因说明

100

 

reqsn

商户订单号

 

32

 

trxid

交易单号

通联平台的交易流水号

20

下单成功返回

h52appurl

H5跳到京东白条app支付的url

 

-

下单成功返回

h52miniurl

H5跳到京东微信小程序支付的url

 

 

下单成功返回


yinjr 2025年4月24日 13:57 收藏文档