支付宝统一收单线下交易预创建(扫码支付)
接口说明
- 收银员通过收银台或商户后台调用支付宝接口,生成二维码后,展示给用户,由用户扫描二维码完成订单支付
请求方式
方法名
- fshows.liquidation.submerchant.alipay.trade.precreate
请求参数
参数 |
类型 |
是否必填 |
最大长度 |
描述 |
out_trade_no |
String |
必须 |
64 |
服务商订单号,64 个字符以内、可 包 含字母、数字、下划线;需保证 在 接入的服务商系统中不重复 20150320010101001 |
notify_url |
String |
可选 |
- |
支付成功后回调地址,如果不填会用清算平台默认地址 |
total_amount |
Price |
必须 |
11 |
订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。 如果同时传入【可打折金额】和【不可打折金额】,该参数可以不用传入; 如果同时传入了【可打折金额】,【不可打折金额】,【订单总金额】三者,则必须 |
discountable_amount |
Price |
可选 |
11 |
参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。 如果该值未传入,但传入了【订单总金额】和【不可打折金额】,则该值默认为【订单总金额】-【不可打折金额】 8.88 |
undiscountable_amount |
Price |
可选 |
11 |
不参与优惠计算的金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]。如果该值未传入,但传入了【订单总金额】和【可打折金额】,则该值默认为【订单总金额】-【可打折金额】 80.00 |
subject |
String |
必须 |
256 |
订单标题 Iphone6 16G |
body |
String |
可选 |
128 |
订单描述 Iphone6 16G |
sub_merchant |
SubMerchant |
必须 |
- |
商户信息,此字段为一个类,以下带 └标记的字段为该类的参数 |
└merchant_id |
String |
必填 |
20 |
移动支付平台为商户分配的惟一 ID,商户入驻后,由平台返回 (与接口 1 中 sub_merchant_id 一致) |
请求示例
{
"method":"fshows.liquidation.submerchant.alipay.trade.precreate",
"app_id":"2016072300007148",
"sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
"version":"1.0"
"content":{
"out_trade_no":"CQL201709060934560196423",
"sub_merchant":{"merchant_id":"20170720205421027980"},
"subject":"支付宝订单",
"total_amount":0.01,
"body":"测试"
}
}
返回值
返回值示例
成功请求示例:
{ "return_value":{
"qrCode":"https://qr.alipay.com/bax02824jttnhbmik36x0033",
"outTradeNo":"CQL201709060934560196423"
},"success":true
}
失败请求示例
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}