微信刷卡支付
接口说明
- 收银员使用扫码设备读取微信用户刷卡授权码以后,二维码或条码信息传送至清算方收银台,由清算方收银台或者清算方后台调用该接口发起支付
请求方式
方法名
- fshows.liquidation.wx.trade.pay
请求参数
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
商品描述 |
body |
是 |
String(128) |
image-深圳腾大- QQ |
商品简单描述,该字段须严格按照规范传递,具体请见参数规定 |
商户订单号 |
out_trade_no |
是 |
String(32) |
1012014368018 |
服务商订单号,64 个字符以内、可 包 含字母、数字、下划线;需保证 在 接入的服务商系统中不重复 |
订单金额 |
total_fee |
是 |
Price |
8.88 |
订单总金额,单位为元,最多允许保留两位小数,详见支付金额 |
终端IP |
spbill_create_ip |
是 |
String(16) |
8.8.8.8 |
调用微信支付API的机器IP |
授权码 |
auth_code |
是 |
String(128) |
12006109406 |
扫码支付授权码,设备读取用户微信中的条码或者二维码信息 |
店铺id |
store_id |
是 |
String(20) |
123 |
移动支付平台为商户分配的惟一 ID,商户入驻后,由平台返回 (与接口 1 中 sub_merchant_id 一致) |
更多微信公众号appid |
sub_appid |
可选 |
String(32) |
wwsxa_2e |
若在移动支付平台有添加过额外的公众号 appid来满足服务商的额外的业务需求,则该参数填写上述添加过的公众号appid。(若申请正式环境时只提交了一个需要使用的公众号appid,则该参数无需填写) |
商品标记 |
goods_tag |
可选 |
String(32) |
WXG |
商品标记,代金券或立减优惠功能的参数, 说明详见代金券或立减优惠 |
微信子商户号 |
sub_mch_id |
可选 |
String(32) |
14555004 |
微信子商户号 |
请求示例
{
"method":"fshows.liquidation.wx.trade.pay",
"app_id":"2016072300007148",
"sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
"version":"1.0"
"content":{
"body":"QQ公仔" ,
"total_fee":"0.01",
"spbill_create_ip":"120.0.0.1",
"auth_code":"134537237814335750",
"store_id":"20170720205421027980",
"out_trade_no":"CQL201709060953120179985",
"notify_url":"http://cc.ngrok.cc/test"
}
}
返回值
名称 |
变量名 |
必填 |
类型 |
示例值 |
描述 |
用户标识 |
openid |
是 |
String(128) |
Y |
用户在商户appid 下的唯一标识 |
是否关注公众账号 |
is_subscribe |
是 |
String(1) |
Y |
用户是否关注公众账号,仅在公众账号类型支付有效,取值范围:Y或N;Y-关注;N-未关注 |
交易类型 |
trade_type |
是 |
String(16) |
MICROPAY |
支付类型为MICROPAY(即扫码支付) |
付款银行 |
bank_type |
是 |
String(16) |
CMC |
银行类型,采用字符串类型的银行标识,值列表详见银行类型 |
货币类型 |
fee_type |
否 |
String(16) |
CNY |
符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型 |
订单金额 |
total_fee |
是 |
Price |
8.88 |
订单总金额,单位为元,最多允许保留两位小数,详见支付金额 |
现金支付金额 |
cash_fee |
是 |
Price |
100 |
订单现金支付金额,详见支付金额 |
微信支付订单号 |
transaction_id |
是 |
String(32) |
121775233368018 |
微信支付订单号 |
商户订单号 |
out_trade_no |
是 |
String(32) |
12177703368018 |
商户系统的订单号,与请求一致。 |
支付完成时间 |
time_end |
是 |
String(14) |
20141030133525 |
订单生成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。详见时间规则 |
清算方手续费 |
liquidator_commission_fee |
是 |
Price |
0.001 |
接口接入方设置的手续费 |
银行手续费 |
bank_commission_fee |
是 |
Price |
0.001 |
银行收取的手续费 |
微信手续费 |
pay_platform_fee |
是 |
Price |
0.001 |
支付平台收取的手续费 |
网关手续费 |
gatewayCommissionFee |
是 |
Price |
0.001 |
网关收取的手续费 |
净收入 |
net_money |
是 |
Price |
0.01 |
扣取总费用后的净收入 |
代金券金额 |
coupon_fee |
是 |
Price |
0.00 |
单位为分!“代金券或立减优惠”金额<=订单总金额,订单总金额-“代金券或立减优惠”金额=现金支付金额,详见支付金额 |
清算方费率 |
liquidator_commission_rate |
是 |
String |
0.01 |
清算方的费率 |
银行费率 |
bank_commission_rate |
是 |
String |
0.01 |
银行的费率 |
微信费率 |
pay_platform_rate |
是 |
String |
0.01 |
微信的费率 |
网关费率 |
gatewayCommissionRate |
是 |
String |
0.01 |
网关的费率 |
返回值示例
成功请求示例:
{ "return_value":{
"transaction_id":"2017090621523001498972679979",
"liquidator_commission_fee":0.00000,
"pay_platform_fee":0.00000,
"bank_type":"CFT",
"bank_commission_fee":0.00000,
"openid":"odBg7w0urs07MhHgZT2leFHOfAo1",
"liquidator_commission_rate":0.00140,
"fee_type":"CNY","cash_fee":0.01,
"out_trade_no":"CQL201709060953120179985",
"bank_commission_rate":0.00030,
"coupon_fee":0.00,"total_fee":0.01,
"trade_type":"MICROPAY",
"time_end":"20170906215231",
"is_subscribe":"Y",
"pay_platform_rate":0.00200,
"net_money":0.01,
“gatewayCommissionFee”:0.001,
“gatewayCommissionRate”:0.01
},"success":true
}
失败请求示例
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}