支付宝统一收单交易支付接口(刷卡/声波)

接口说明

  • 收银员使用扫码设备读取用户手机支付宝“付款码”/声波获取设备（如麦克风）读取用户手机支付宝的声波信息后，将二维码或条码信息/声波信息通过本接口上送至支付宝发起支付

请求方式

  • POST

方法名

  • fshows.liquidation.submerchant.alipay.trade.pay

请求参数

参数 类型 是否必填 最大长度 描述
out_trade_no String 必须 64 服务商订单号,64 个字符以内、可 包 含字母、数字、下划线;需保证 在 接入的服务商系统中不重复 20150320010101001
notify_url String 可选 - 支付成功后回调地址，如果不填会用清算平台默认地址
scene String 必须 32 支付场景 条码支付，取值：bar_code 声波支付，取值：wave_code bar_code,wave_code
auth_code String 必须 32 支付授权码 28763443825664394
total_amount Price 可选 11 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。 如果同时传入【可打折金额】和【不可打折金额】，该参数可以不用传入； 如果同时传入了【可打折金额】，【不可打折金额】，【订单总金额】三者，则必须
discountable_amount Price 可选 11 参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。 如果该值未传入，但传入了【订单总金额】和【不可打折金额】，则该值默认为【订单总金额】-【不可打折金额】 8.88
undiscountable_amount Price 可选 11 不参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]。如果该值未传入，但传入了【订单总金额】和【可打折金额】，则该值默认为【订单总金额】-【可打折金额】 80.00
subject String 必须 256 订单标题 Iphone6 16G
body String 可选 128 订单描述 Iphone6 16G
sub_merchant SubMerchant 必须 - 商户信息,此字段为一个类,以下带 └标记的字段为该类的参数
└merchant_id String 必填 20 移动支付平台为商户分配的惟一 ID,商户入驻后,由平台返回 (与接口 1 中 sub_merchant_id 一致)

请求示例 

{  
  "method":"fshows.liquidation.submerchant.alipay.trade.pay",
  "app_id":"2016072300007148",
  "sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
  "version":"1.0"
  "content":{
      "out_trade_no":"CQL201709060943390148266",
      "auth_code":"282201997776220157",
      "subject":"mx3",
      "sub_merchant":{"merchant_id":"20170720205421027980"}
   }
}

返回值

参数 类型 是否必填 最大长 度 描述
tradeNo String 必填 64 移动支付平台的订单号,在支付平台中惟一
outTradeNo String 必填 64 商户订单号
buyerLogonId String 必填 100 买家支付宝账号
totalAmount String 必填 11 交易金额
receiptAmount String 必填 11 实收金额
buyerPayAmount String 选填 11 买家付款的金额
pointAmount String 选填 11 使用积分宝付款的金额
invoiceAmount String 选填 11 交易中可给用户开具发票的金额
gmtPayment String 必填 32 交易支付时间
fundBillList TradeFundBill [] 必填 - 交易支付使用的资金渠道
└ fundChannel String 必填 32 交易使用的资金渠道，详见 支付渠道列表 ALIPAYACCOUNT
└ amount String 选填 - 该支付工具类型所使用的金额 10
└ realAmount String 选填 11 渠道实际付款金额 11.21
cardBalance String 选填 11 支付宝卡余额 98.23
storeName String 选填 512 发生支付交易的商户门店名称 证大五道口店
discountGoodsDetail String 必填 - 本次交易支付所使用的单品券优惠的商品优惠信息 [{"goods_id":"STANDARD1026181538","goods_name":"雪碧","discount_amount":"100.00","voucher_id":"2015102600073002039000002D5O"}]
buyerUserId String 必填 28 买家在支付宝的用户id
platform_order_no String 必填 20 平台方订单号

返回值示例

成功请求示例: 

{ "return_value":{
      "bankCommissionFee":0.00,
      "pointAmount":"0.00",
      "tradeNo":"2017090621425702017840320315",
      "payPlatformFee":0.00,
      "invoiceAmount":"0.01",
      "discountGoodsDetail":null,
      "buyerLogonId":"irv***@sandbox.com",
      "bankCommissionRate":0.00030,
      "totalAmount":"0.01",
      "receiptAmount":"0.01",
      "gmtPayment":1504705380000,
      "outTradeNo":"CQL201709060943390148266",
      "buyerPayAmount":"0.01",
      "cardBalance":null,
      "netIncome":0.01,
      "storeName":null,
      "buyerUserId":"2088102169470543",
      "liquidatorCommissionFee":0.00,
      "payPlatformRate":0.00200,
      "platform_order_sn":"20170906214257020178403204657",

      "fundBillList":[{"amount":"0.01","fundChannel":"ALIPAYACCOUNT","fundType":null,"realAmount":null}],
      "liquidatorCommissionRate":0.00140
   },"success":true
}

失败请求示例 

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

results matching ""

    No results matching ""