支付寶 alipay.trade.pay(統(tǒng)一收單交易支付接口)

收銀員使用掃碼設(shè)備讀取用戶手機(jī)支付寶“付款碼”/聲波獲取設(shè)備（如麥克風(fēng)）讀取用戶手機(jī)支付寶的聲波信息后，將二維碼或條碼信息/聲波信息通過本接口上送至支付寶發(fā)起支付。

公共參數(shù)

請(qǐng)求地址

公共請(qǐng)求參數(shù)

請(qǐng)求參數(shù)

公共響應(yīng)參數(shù)

響應(yīng)參數(shù)

請(qǐng)求示例

JAVA

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayTradePayRequest request = new AlipayTradePayRequest();
request.setBizContent("{" +
"\"out_trade_no\":\"20150320010101001\"," +
"\"scene\":\"bar_code\"," +
"\"auth_code\":\"28763443825664394\"," +
"\"product_code\":\"FACE_TO_FACE_PAYMENT\"," +
"\"subject\":\"Iphone616G\"," +
"\"buyer_id\":\"2088202954065786\"," +
"\"seller_id\":\"2088102146225135\"," +
"\"total_amount\":88.88," +
"\"discountable_amount\":8.88," +
"\"body\":\"Iphone616G\"," +
"\"goods_detail\":[{" +
"\"goods_id\":\"apple-01\"," +
"\"goods_name\":\"ipad\"," +
"\"quantity\":1," +
"\"price\":2000," +
"\"goods_category\":\"34543238\"," +
"\"body\":\"特價(jià)手機(jī)\"," +
"\"show_url\":\"http://www.alipay.com/xxx.jpg\"" +
"}]," +
"\"operator_id\":\"yx_001\"," +
"\"store_id\":\"NJ_001\"," +
"\"terminal_id\":\"NJ_T_001\"," +
"\"extend_params\":{" +
"\"sys_service_provider_id\":\"2088511833207846\"" +
"}," +
"\"timeout_express\":\"90m\"" +
"}");
AlipayTradePayResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("調(diào)用成功");
} else {
System.out.println("調(diào)用失敗");
}

.NET

IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);
AlipayTradePayRequest  request= new AlipayTradePayRequest() ;
request.BizContent="{" +
"\"out_trade_no\":\"20150320010101001\"," +
"\"scene\":\"bar_code\"," +
"\"auth_code\":\"28763443825664394\"," +
"\"product_code\":\"FACE_TO_FACE_PAYMENT\"," +
"\"subject\":\"Iphone616G\"," +
"\"buyer_id\":\"2088202954065786\"," +
"\"seller_id\":\"2088102146225135\"," +
"\"total_amount\":88.88," +
"\"discountable_amount\":8.88," +
"\"body\":\"Iphone616G\"," +
"\"goods_detail\":[{" +
"\"goods_id\":\"apple-01\"," +
"\"goods_name\":\"ipad\"," +
"\"quantity\":1," +
"\"price\":2000," +
"\"goods_category\":\"34543238\"," +
"\"body\":\"特價(jià)手機(jī)\"," +
"\"show_url\":\"http://www.alipay.com/xxx.jpg\"" +
"}]," +
"\"operator_id\":\"yx_001\"," +
"\"store_id\":\"NJ_001\"," +
"\"terminal_id\":\"NJ_T_001\"," +
"\"extend_params\":{" +
"\"sys_service_provider_id\":\"2088511833207846\"" +
"}," +
"\"timeout_express\":\"90m\"" +
"}";
AlipayTradePayResponse response=client.execute(request);
Console.WriteLine(response.Body);

PHP

$aop = new AopClient ();
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->appId = 'your app_id';
$aop->rsaPrivateKey = '請(qǐng)?zhí)顚戦_發(fā)者私鑰去頭去尾去回車，一行字符串';
$aop->alipayrsaPublicKey='請(qǐng)?zhí)顚懼Ц秾毠€，一行字符串';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='GBK';
$aop->format='json';
$request = new AlipayTradePayRequest ();
$request->setBizContent("{" .
"\"out_trade_no\":\"20150320010101001\"," .
"\"scene\":\"bar_code\"," .
"\"auth_code\":\"28763443825664394\"," .
"\"product_code\":\"FACE_TO_FACE_PAYMENT\"," .
"\"subject\":\"Iphone616G\"," .
"\"buyer_id\":\"2088202954065786\"," .
"\"seller_id\":\"2088102146225135\"," .
"\"total_amount\":88.88," .
"\"discountable_amount\":8.88," .
"\"body\":\"Iphone616G\"," .
"\"goods_detail\":[{" .
"\"goods_id\":\"apple-01\"," .
"\"goods_name\":\"ipad\"," .
"\"quantity\":1," .
"\"price\":2000," .
"\"goods_category\":\"34543238\"," .
"\"body\":\"特價(jià)手機(jī)\"," .
"\"show_url\":\"http://www.alipay.com/xxx.jpg\"" .
"}]," .
"\"operator_id\":\"yx_001\"," .
"\"store_id\":\"NJ_001\"," .
"\"terminal_id\":\"NJ_T_001\"," .
"\"extend_params\":{" .
"\"sys_service_provider_id\":\"2088511833207846\"" .
"}," .
"\"timeout_express\":\"90m\"" .
"}");
$result = $aop->execute ( $request); 


$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";
$resultCode = $result->$responseNode->code;
if(!empty($resultCode)&&$resultCode == 10000){
echo "成功";
} else {
echo "失敗";
}

HTTP請(qǐng)求源碼

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.trade.pay&app_id=4407&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
"out_trade_no":"20150320010101001",
"scene":"bar_code",
"auth_code":"28763443825664394",
"product_code":"FACE_TO_FACE_PAYMENT",
"subject":"Iphone6 16G",
"buyer_id":"2088202954065786",
"seller_id":"2088102146225135",
"total_amount":88.88,
"discountable_amount":8.88,
"body":"Iphone6 16G",
      "goods_detail":[{
        "goods_id":"apple-01",
"goods_name":"ipad",
"quantity":1,
"price":2000,
"goods_category":"34543238",
"body":"特價(jià)手機(jī)",
"show_url":"http://www.alipay.com/xxx.jpg"
        }],
"operator_id":"yx_001",
"store_id":"NJ_001",
"terminal_id":"NJ_T_001",
"extend_params":{
"sys_service_provider_id":"2088511833207846"
    },
"timeout_express":"90m"
  }


//為確保安全通信，需自行驗(yàn)證響應(yīng)示例中的sign值是否為螞蟻金服所提供。

響應(yīng)示例

JSON 示例

{
    "alipay_trade_pay_response": {
        "code": "10000",
        "msg": "Success",
        "trade_no": "2013112011001004330000121536",
        "out_trade_no": "6823789339978248",
        "buyer_logon_id": "159****5620",
        "total_amount": 120.88,
        "receipt_amount": "88.88",
        "buyer_pay_amount": 8.88,
        "point_amount": 8.12,
        "invoice_amount": 12.5,
        "gmt_payment": "2014-11-27 15:45:57",
        "fund_bill_list": [
            {
                "fund_channel": "ALIPAYACCOUNT",
                "amount": 10,
                "real_amount": 11.21
            }
        ],
        "card_balance": 98.23,
        "store_name": "證大五道口店",
        "buyer_user_id": "2088101117955611",
        "discount_goods_detail": "[{\"goods_id\":\"STANDARD1026181538\",\"goods_name\":\"雪碧\",\"discount_amount\":\"100.00\",\"voucher_id\":\"2015102600073002039000002D5O\"}]",
        "voucher_detail_list": [
            {
                "id": "2015102600073002039000002D5O",
                "name": "XX超市5折優(yōu)惠",
                "type": "ALIPAY_FIX_VOUCHER",
                "amount": 10,
                "merchant_contribute": 9,
                "other_contribute": 1,
                "memo": "學(xué)生專用優(yōu)惠",
                "purchase_buyer_contribute": 2.01,
                "purchase_merchant_contribute": 1.03,
                "purchase_ant_contribute": 0.82
            }
        ],
        "business_params": "{\"data\":\"123\"}"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

XML 示例

<alipay_trade_pay_response>
<code>10000</code>
<msg>Success</msg>  <trade_no>2013112011001004330000121536</trade_no>
  <out_trade_no>6823789339978248</out_trade_no>
  <open_id>2088102122524333</open_id>
  <buyer_logon_id>159****5620</buyer_logon_id>
  <total_amount>120.88</total_amount>
  <receipt_amount>88.88</receipt_amount>
  <buyer_pay_amount>8.88</buyer_pay_amount>
  <point_amount>8.12</point_amount>
  <invoice_amount>12.50</invoice_amount>
  <gmt_payment>2014-11-27 15:45:57</gmt_payment>
  <fund_bill_list list="true">
    <trade_fund_bill>
      <fund_channel>ALIPAYACCOUNT</fund_channel>
      <amount>10</amount>
      <real_amount>11.21</real_amount>
      <fund_type>DEBIT_CARD</fund_type>
    </trade_fund_bill>
  </fund_bill_list>
  <card_balance>98.23</card_balance>
  <store_name>證大五道口店</store_name>
  <buyer_user_id>2088101117955611</buyer_user_id>
  <discount_goods_detail>[{"goods_id":"STANDARD1026181538","goods_name":"雪碧","discount_amount":"100.00","voucher_id":"2015102600073002039000002D5O"}]</discount_goods_detail>
  <async_payment_mode>SYNC_DIRECT_PAY</async_payment_mode>
  <voucher_detail_list list="true">
    <voucher_detail>
      <id>2015102600073002039000002D5O</id>
      <name>XX超市5折優(yōu)惠</name>
      <type>ALIPAY_FIX_VOUCHER</type>
      <amount>10.00</amount>
      <merchant_contribute>9.00</merchant_contribute>
      <other_contribute>1.00</other_contribute>
      <memo>學(xué)生專用優(yōu)惠</memo>
      <purchase_buyer_contribute>2.01</purchase_buyer_contribute>
      <purchase_merchant_contribute>1.03</purchase_merchant_contribute>
      <purchase_ant_contribute>0.82</purchase_ant_contribute>
    </voucher_detail>
  </voucher_detail_list>
  <business_params>{"data":"123"}</business_params>
</alipay_trade_pay_response>

異常示例

JSON 示例

{
    "alipay_trade_pay_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系統(tǒng)繁忙"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

業(yè)務(wù)錯(cuò)誤碼

公共錯(cuò)誤碼

觸發(fā)通知類型

觸發(fā)通知示例

https://www.merchant.com/receive_notify.htm?notify_type=trade_status_sync¬ify_id=91722adff935e8cfa58b3aabf4dead6ibe¬ify_time=2017-0