支付宝统一收单线下交易预创建(扫码支付)

接口说明

  • 收银员通过收银台或商户后台调用支付宝接口,生成二维码后,展示给用户,由用户扫描二维码完成订单支付

请求方式

  • POST

方法名

  • fshows.liquidation.submerchant.alipay.trade.precreate

请求参数

参数 类型 是否必填 最大长度 描述
out_trade_no String 必须 64 服务商订单号,64 个字符以内、可 包 含字母、数字、下划线;需保证 在 接入的服务商系统中不重复 20150320010101001
notify_url String 可选 - 支付成功后回调地址,如果不填会用清算平台默认地址
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.precreate",
  "app_id":"2016072300007148",
  "sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
  "version":"1.0"
  "content":{
      "out_trade_no":"CQL201709060934560196423",
      "sub_merchant":{"merchant_id":"20170720205421027980"},
      "subject":"支付宝订单",
      "total_amount":0.01,
      "body":"测试"
   }
}

返回值

参数 类型 是否必填 最大长度 描述
outTradeNo String 必须 64 商户的订单号 6823789339978248
qrCode String 必须 1024 当前预下单请求生成的二维码码串,可以用二维码生成工具根据该码串值生成对应的二维码 https://qr.alipay.com/bavh4wjlxf12tper3a

返回值示例

成功请求示例:

{ "return_value":{
      "qrCode":"https://qr.alipay.com/bax02824jttnhbmik36x0033",
      "outTradeNo":"CQL201709060934560196423"
      },"success":true
}

失败请求示例

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

results matching ""

    No results matching ""