京东统一下单接口
接口说明
- 清算方系统先调用该接口在清算平台服务后台生成交易单,再按扫码、APP等不同场景发起支付
请求方式
方法名
- fshows.liquidation.jdpay.uniorder
请求参数
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
sub_merchant_id |
String |
是 |
20 |
移动支付平台为商户分配的惟 一 ID,商户入驻后,由平台返回 |
body |
String |
是 |
128 |
商品描述 ,传入实际商品名称,例如:京东公仔 |
out_trade_no |
String |
是 |
64 |
服务商订单号,64 个字符以内、可包含字母、数字、下划线;需保证 在 接入的服务商系统中不重 |
total_fee |
Price |
是 |
11 |
总金额 单位为元,精确到小数点后两位,取值范围[0.01,100000000] |
notify_url |
String |
可选 |
- |
回调地址 |
order_type |
String |
是 |
3 |
订单类型 0:实物 1:虚拟 |
请求示例
{
"method":"fshows.liquidation.jdpay.uniorder",
"app_id":"2016072300007148",
"sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
"version":"1.0"
"content":{
"out_trade_no":"CQL201709061014480195818" ,
"sub_merchant_id":"20170720205421027980",
"body":"这是京东支付订单",
"total_fee":"0.01",
"order_type":"0",
"notify_url":"http://cc.ngrok.cc/test"
}
}
返回值
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
qr_code |
String |
是 |
64 |
支付二维码,用于后续接口调用中使用,该值有效期为2小时 |
trade_no |
String |
是 |
64 |
移动支付平台的订单号,在支付平台中唯一 |
total_fee |
Price |
是 |
11 |
总金额 单位为元,精确到小数点后两位,取值范围[0.01,100000000] |
net_receipt_amount |
Price |
是 |
11 |
净收入=(100%-总费率)*total_fee |
bank_commission_rate |
Price |
是 |
15 |
银行佣金费率 |
bank_commission_fee |
Price |
是 |
15 |
银行佣金费 |
pay_platform_rate |
Price |
是 |
15 |
支付平台费率(京东) |
pay_platform_fee |
Price |
是 |
15 |
支付平台手续费(京东) |
liquidator_commission_rate |
Price |
是 |
15 |
清算方佣金费率,每笔交易,返给清算方的佣金费率 |
liquidator_commission_fee |
Price |
是 |
15 |
清算方佣金费,每笔交易,返给清算方的佣金费 |
notify_url |
String |
可选 |
- |
回调地址 |
返回值示例
成功请求示例:
{ "return_value":{
"qr_code":"https://h5pay.jd.com/code?c=63xrquzxctu14d",
"trade_no":"2017090622140509534568101496",
"total_fee":0.01,
"net_receipt_amount":0.01,
"bank_commission_rate":0.00030,
"bank_commission_fee":0.00,
"pay_platform_rate":0.00200,
"pay_platform_fee":0.00,
"liquidator_commission_rate":0.00100,
"liquidator_commission_fee":0.00,
"notify_url":"http://cc.ngrok.cc/test"
},"success":true
}
失败请求示例
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}