微信扫码支付
接口说明
- 除被扫支付场景以外,清算方系统先调用该接口在平台化支付服务后台生成预支付交易单,返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付
请求方式
方法名
- fshows.liquidation.wx.trade.precreate
请求参数
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
商品描述 |
body |
是 |
String(128) |
腾讯充值-QQ会员 |
商品简单描述,该字段须严格按照规范传递,具体请见参数规定 |
商户订单号 |
out_trade_no |
是 |
String(32) |
201508025346 |
服务商订单号,64 个字符以内、可 包 含字母、数字、下划线;需保证 在 接入的服务商系统中不重复 |
总金额 |
total_fee |
是 |
Price |
8.88 |
订单总金额,单位为元,详见支付金额 |
终端IP |
spbill_create_ip |
是 |
String(16) |
123.12.12.123 |
APP和网页支付提交用户端ip,Native支付填调用微信支付API的机器IP。 |
通知地址 |
notify_url |
否 |
String(256) |
http://www.weixin.qq.com/wxpay/pay.php |
接收微信支付异步通知回调地址。如果没有使用后台设置的url,如果都没有就不回调 |
店铺id |
store_id |
是 |
String(20) |
123 |
移动支付平台为商户分配的惟一 ID,商户入驻后,由平台返回 (与接口 1 中 sub_merchant_id 一致) |
更多微信公众号appid |
sub_appid |
可选 |
String(32) |
12sadadq_dsfw |
若在移动支付平台有添加过额外的公众号 appid来满足服务商的额外的业务需求,则该参数填写上述添加过的公众号appid。(若申请正式环境时只提交了一个需要使用的公众号appid,则该参数无需填写) |
商品标记 |
goods_tag |
可选 |
String(32) |
WXG |
商品标记,代金券或立减优惠功能的参数,说明详见代金券或立减优惠 |
微信子商户号 |
sub_mch_id |
可选 |
String(32) |
14555004 |
微信子商户号 |
请求示例
{
"method":"fshows.liquidation.wx.trade.precreate",
"app_id":"2016072300007148",
"sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
"version":"1.0"
"content":{
"store_id":"20170720205421027980",
"body":"yaya",
"out_trade_no":"CQL201709060957150126355",
"total_fee":"0.01" ,
"spbill_create_ip":"120.0.0.1",
"notify_url":"http://cc.ngrok.cc/test"
}
}
返回值
字段名 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
out_trade_no |
String |
必填 |
64 |
商户的订单号 6823789339978248 |
清算方订单号 |
qr_code |
String |
是 |
String(64) |
URl:weixin://wxpay/s/An4baqw |
trade_type为NATIVE是有返回,可将该参数值生成二维码展示出来进行扫码支付 |
返回值示例
成功请求示例:
{ "return_value":{
"out_trade_no":"CQL201709060957150126355",
"qr_code":"weixin://wxpay/bizpayurl?pr=Mp4nTHA"
},"success":true
}
失败请求示例
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}