微信刷卡支付接口

接口说明

  • 收银员使用扫码设备读取微信用户刷卡授权码以后,二维码或条码信息传送至服务商方收银台,由服务商收银台或者服务商后台调用该接口发起支付

请求方式

  • POST

方法名

  • 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
}

results matching ""

    No results matching ""