微信公众号支付预创建

场景说明

  • 清算方已有H5商城网站，用户通过消息或扫描二维码在微信内打开网页时，可以调用微信支付完成下单购买的流程

接口说明

  • 除被扫支付场景以外，清算方系统先调用该接口在平台化支付服务后台生成预支付交易单，返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付

请求方式

  • POST

方法名

  • fshows.liquidation.wxpay.mppay

请求参数

参数 类型 是否必填 最大长度 描述
sub_merchant_id String 是 20 移动支付平台为商户分配的惟 一 ID,商户入驻后,由平台返回
body String 是 128 商品描述 ，传入公众号名称-实际商品名称，例如：腾讯形象店- image-QQ公仔
out_trade_no String 是 64 服务商订单号,64 个字符以内、可 包 含字母、数字、下划线;需保证 在 接入的服务商系统中不重复
total_fee Price 是 11 总金额 单位为元，精确到小数点后两位，取值范围[0.01,100000000]
sub_openid String 是 128 用户在子商户appid下的唯一标识
spbill_create_ip String 是 16 APP和网页支付提交用户端ip
notify_url String 可选 - 回调地址
sub_appid String 可选（小程序必传） 32 若在移动支付平台有添加过额外的公众号appid来满足服务商的额外的业务需求，则该参数填写上述添加过的公众号appid。（若申请正式环境时只提交了一个需要使用的公众号appid，则该参数无需填写）
sub_mch_id String 可选 32 微信子商户号
goods_tag String 可选 32 商品标记，代金券或立减优惠功能的参数， 说明详见代金券或立减优惠

请求示例 

{  
  "method":"fshows.liquidation.wxpay.mppay",
  "app_id":"2016072300007148",
  "sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
  "version":"1.0"
  "content":{
      "sub_merchant_id":"20170720205421027980",
      "body":"测试服务商",
      "out_trade_no":"CQL201709061009040181240",
      "total_fee":"0.01" ,
      "sub_openid":"odBg7w0urs07MhHgZT2leFHOfAo1",
      "spbill_create_ip":"123.56.171.228",
      "notify_url":"http://cc.ngrok.cc/test"
    }
}

返回值

参数 类型 是否必填 最大长度 描述
prepay_id String 是 64 预支付回话标识，用于后续接口调用中使用，该值有效期为2小时
total_fee Price 是 11 总金额 单位为元，精确到小数点后两位，取值范围[0.01,100000000]
net_receipt_amount Price 是 11 净收入＝（100%－总费率）＊total_fee
bank_commission_rate Price 是 15 银行佣金费率
bank_commission_fee Price 是 15 银行佣金费
gatewayCommissionRate Price 是 15 网关费率
gatewayCommissionFee Price 是 15 网关手续费
pay_platform_rate Price 是 15 支付平台费率（微信）
pay_platform_fee Price 是 15 支付平台手续费（微信）
liquidator_commission_rate Price 是 15 清算方佣费率,每笔交易，返给清算方的佣金费率
liquidator_commission_fee Price 是 15 清算方佣费率,每笔交易，返给清算方的佣金费
notify_url String 可选 - 回调地址

后续操作

接收到接口返回值，并且返回值中‘success’为True后代表预下单成功。需要调用 `微信公众号H5页面` 来获取唤起微信支付的连接。

返回值示例

成功请求示例: 

{"return_value":{
     "prepay_id":"wx20170906220822dbac5251730459374711",
     "total_fee":0.01,
     "net_receipt_amount":0.01,
     "bank_commission_rate":0.00030,
     "bank_commission_fee":0.00,
     "pay_platform_rate":0.00200,
     "pay_platform_fee":0.00,
     "liquidator_commission_rate":0.00140,
     "liquidator_commission_fee":0.00,
     "gatewayCommissionRate":0.00,
     “gatewayCommissionFee”：0.00,
      "notify_url":"http://cc.ngrok.cc/test"
      },"success":true
}

失败请求示例 

{
   "error_code": "-101",
    "error_message": "无效参数",
    "success": false
}

results matching ""

    No results matching ""