接口地址: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 |
|
否 |
|
下单成功返回 |