微信刷卡支付

接口说明

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

请求方式

  • POST

方法名

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

results matching ""

    No results matching ""