支付宝H5预创建接口

接口说明

  • 清算方通过该接口进行交易的创建下单
  • 清算方在支付宝APP中先调用该接口在清算平台服务后台生成预支付交易单，返回正确的预支付交易后调起支付

请求方式

  • POST

方法名

  • fshows.liquidation.submerchant.alipay.trade.create

请求参数

参数 类型 是否必填 最大长度 描述
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
subject String 必须 256 订单标题 Iphone6 16G
body String 可选 128 对交易或商品的描述 Iphone6 16G
sub_merchant SubMerchant 必须 - 商户信息,此字段为一个类,以下带 └标记的字段为该类的参数
└ merchant_id String 必填 20 移动支付平台为商户分配的惟一 ID,商户入驻后,由平台返回 (与接口 1 中 sub_merchant_id 一致)
buyer_logon_id String 特殊可选 100 买家支付宝账号，和buyer_id不能同时为空
buyer_id String 特殊可选 28 买家的支付宝唯一用户号（2088开头的16位纯数字）,和buyer_logon_id不能同时为空

请求示例 

{  
  "method":"fshows.liquidation.submerchant.alipay.trade.create",
  "app_id":"2016072300007148",
  "sign":"hq1j1tBCQkJCecJbU1I+9VyRDPyjzBjT6ok7S6QWT72ebJ7nNmTJFy5GLh0Zw9lyciT/1Qd7dDeFRVwqxHW10xzv8qBqjGNq4S1TH1sEukMBk7emkD78javGS0m+6KIEtK1K5gePgqy3HRpxqrD58jqZIOu5FIxY5m5a93CJC/o=",
  "version":"1.0"
  "content":{
      "out_trade_no":"CQL201709060948370146039",
      "total_amount":"0.01",
      "subject":"支付宝H5预创建测试",
      "sub_merchant":{"merchant_id":"20170720205421027980"},
      "buyer_logon_id":"[email protected]",
      "discountable_amount":"0",
      "notify_url":"http://cc.ngrok.cc/test"
    }
}

返回值

参数 类型 是否必填 最大长度 描述
out_trade_no String 必填 64 清算方的订单号 6823789339978248
prepay_id String 必填 64 预支付id
trade_no String 必填 64 平台订单号

返回值示例

成功请求示例: 

{ "return_value":{
     "out_trade_no":"CQL201709060948370146039",
     "trade_no":"2017090621475402163669707685",
     "prepay_id":"2017090621001004540200311644"
     },"success":true
}

失败请求示例 

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

results matching ""

    No results matching ""