微信刷卡支付接口
接口说明
- 收银员使用扫码设备读取微信用户刷卡授权码以后,二维码或条码信息传送至服务商方收银台,由服务商收银台或者服务商后台调用该接口发起支付
请求方式
方法名
fshows.liquidation.wx.trade.pay
请求参数
名称 |
变量名 |
必填 |
类型 |
描述 |
商品描述 |
body |
是 |
String(128) |
商品简单描述,该字段须严格按照规范传递,具体请见参数规定 |
商户订单号 |
out_trade_no |
是 |
String(32) |
服务商订单号,64 个字符以内、可 包 含字母、数字、下划线;需保证 在 接入的服务商系统中不重复 |
订单金额 |
total_fee |
是 |
Price |
订单总金额,单位为元,最多允许保留两位小数,详见支付金额 |
终端IP |
spbill_create_ip |
是 |
String(16) |
调用微信支付API的机器IP |
授权码 |
auth_code |
是 |
String(128) |
扫码支付授权码,设备读取用户微信中的条码或者二维码信息 |
终端设备号 |
device_info |
是 |
String(64) |
终端设备号 |
商户id |
store_id |
是 |
String(20) |
移动支付平台为商户分配的惟一 ID,商户入驻后,由平台返回 (与接口 1 中 sub_merchant_id 一致) |
更多微信公众号appid |
sub_appid |
可选 |
String(32) |
若在移动支付平台有添加过额外的公众号 appid来满足服务商的额外的业务需求,则该参数填写上述添加过的公众号appid。(若申请正式环境时只提交了一个需要使用的公众号appid,则该参数无需填写) |
商品标记 |
goods_tag |
可选 |
String(32) |
商品标记,代金券或立减优惠功能的参数, 说明详见代金券或立减优惠 |
微信子商户号 |
sub_mch_id |
可选 |
String(32) |
微信子商户号 |
通知地址 |
notify_url |
否 |
String(256) |
接收微信支付异步通知回调地址。如果没有则使用后台设置的url,如果都没有就不回调 |
请求示例
{
"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",
"device_info":"123.14",
}
}
返回值
名称 |
变量名 |
类型 |
描述 |
用户标识 |
openid |
String(128) |
用户在商户appid 下的唯一标识 |
是否关注公众账号 |
is_subscribe |
String(1) |
用户是否关注公众账号,仅在公众账号类型支付有效,取值范围:Y或N;Y-关注;N-未关注 |
交易类型 |
trade_type |
String(16) |
支付类型为MICROPAY(即扫码支付) |
付款银行 |
bank_type |
String(16) |
银行类型,采用字符串类型的银行标识,值列表详见银行类型 |
货币类型 |
fee_type |
String(16) |
符合ISO 4217标准的三位字母代码,默认人民币:CNY,其他值列表详见货币类型 |
订单金额 |
total_fee |
Price |
订单总金额,单位为元,最多允许保留两位小数,详见支付金额 |
现金支付金额 |
cash_fee |
Price |
订单现金支付金额,详见支付金额 |
清算平台支付订单号 |
transaction_id |
String(32) |
清算平台支付订单号 |
清算平台支付订单号 |
trade_no |
String(32) |
清算平台支付订单号 |
商户订单号 |
out_trade_no |
String(32) |
商户系统的订单号,与请求一致。 |
支付完成时间 |
time_end |
String(14) |
订单生成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。详见时间规则 |
清算方手续费 |
liquidator_commission_fee |
Price |
接口接入方设置的手续费 |
银行手续费 |
bank_commission_fee |
Price |
银行收取的手续费 |
微信手续费 |
pay_platform_fee |
Price |
支付平台收取的手续费 |
净收入 |
net_money |
Price |
扣取总费用后的净收入 |
代金券金额 |
coupon_fee |
Price |
单位为分!“代金券或立减优惠”金额<=订单总金额,订单总金额-“代金券或立减优惠”金额=现金支付金额,详见支付金额 |
清算方费率 |
liquidator_commission_rate |
String |
清算方的费率 |
银行费率 |
bank_commission_rate |
String |
银行的费率 |
微信费率 |
pay_platform_rate |
String |
微信的费率 |
平台方订单号 |
platform_order_sn |
String |
平台方订单号(微信的) |
网关费率 |
gateway_commission_rate |
String |
网关费率 |
网关手续费 |
gateway_commission_fee |
String |
网关手续费 |
返回值示例
成功返回示例(自动扣除):
{ "return_value":{
{'openid': None,
'is_subscribe': None,
'trade_type': 'MICROPAY',
'bank_type': 'CFT',
'fee_type': None,
'total_fee': 0.01,
'cash_fee': 0.01,
'coupon_fee': 0.0,
'transaction_id': '2018121516022401311532413870N',
'time_end': '20181215160225',
'trade_no': '2018121516022401311532413870N',
'out_trade_no': 'c0ec4c5e003f11e98c83f0189878df3f',
'platform_order_no': '4200000230201812158720957286',
'bank_commission_fee': 0.0,
'bank_commission_rate': 0.1,
'gateway_commission_rate': 0.1,
'gateway_commission_fee': 0.0,
'liquidator_commission_fee': 0.0,
'liquidator_commission_rate': 0.1,
'pay_platform_fee': 0.0,
'pay_platform_rate': 0.1,
'net_money': 0.01}
},"success":true
}
成功返回示例(输入密码):
{'return_value': {
'trade_no': '2018121516081501555359589121N',
'out_trade_no': '928a68ae004011e9ad29f0189878df3f'
},
'error_code': '100',
'error_message': '用户正在支付中。。。',
'success': False
}
失败返回示例
{
"error_code": "-101",
"error_message": "无效参数",
"success": false
}