支付寶 App支付請(qǐng)求參數(shù)說明

接口功能：外部商戶App喚起快捷SDK創(chuàng)建訂單并支付。

請(qǐng)求參數(shù)是商戶在與支付寶進(jìn)行數(shù)據(jù)交互時(shí)，提供給支付寶的請(qǐng)求數(shù)據(jù)，以便支付寶根據(jù)這些數(shù)據(jù)進(jìn)一步處理。

公共參數(shù)

業(yè)務(wù)參數(shù)

業(yè)務(wù)擴(kuò)展參數(shù)說明

渠道說明

外部用戶ExtUserInfo參數(shù)說明

請(qǐng)求示例

請(qǐng)求參數(shù)組裝分下列3步，以最后第三步獲取到的請(qǐng)求為準(zhǔn) 1.請(qǐng)求參數(shù)按照key=value&key=value方式拼接的未簽名原始字符串：

app_id=2015052600090779&biz_content={"timeout_express":"30m","product_code":"QUICK_MSECURITY_PAY","total_amount":"0.01","subject":"1","body":"我是測試數(shù)據(jù)","out_trade_no":"IQJZSRC1YMQB5HU"}&charset=utf-8&format=json&method=alipay.trade.app.pay¬ify_url=http://domain.merchant.com/payment_notify&sign_type=RSA2×tamp=2016-08-25 20:26:31&version=1.0

2.再對(duì)原始字符串進(jìn)行簽名，參考簽名規(guī)則：

app_id=2015052600090779&biz_content={"timeout_express":"30m","product_code":"QUICK_MSECURITY_PAY","total_amount":"0.01","subject":"1","body":"我是測試數(shù)據(jù)","out_trade_no":"IQJZSRC1YMQB5HU"}&charset=utf-8&format=json&method=alipay.trade.app.pay¬ify_url=http://domain.merchant.com/payment_notify&sign_type=RSA2×tamp=2016-08-25 20:26:31&version=1.0&sign=cYmuUnKi5QdBsoZEAbMXVMmRWjsuUj+y48A2DvWAVVBuYkiBj13CFDHu2vZQvmOfkjE0YqCUQE04kqm9Xg3tIX8tPeIGIFtsIyp/M45w1ZsDOiduBbduGfRo1XRsvAyVAv2hCrBLLrDI5Vi7uZZ77Lo5J0PpUUWwyQGt0M4cj8g=

3.最后對(duì)請(qǐng)求字符串的所有一級(jí)value（biz_content作為一個(gè)value）進(jìn)行encode，編碼格式按請(qǐng)求串中的charset為準(zhǔn)，沒傳charset按UTF-8處理，獲得最終的請(qǐng)求字符串：

app_id=2015052600090779&biz_content=%7B%22timeout_express%22%3A%2230m%22%2C%22product_code%22%3A%22QUICK_MSECURITY_PAY%22%2C%22total_amoun

特殊說明（很重要）

1.商戶在請(qǐng)求參數(shù)中，自己附屬的一些額外參數(shù)，不要和支付寶系統(tǒng)中約定的key（下表中 公共請(qǐng)求參數(shù)\請(qǐng)求參數(shù)）重名，否則將可能導(dǎo)致未知的異常。 比如以下示例中app_id=2014072300007148**&version=1.0&biz_content的key是公共請(qǐng)求參數(shù)，業(yè)務(wù)方自己的擴(kuò)展參數(shù)需要放在biz_content內(nèi)部,比如示例中tips屬性,很顯然下面total_amount屬性是商戶按照自己的業(yè)務(wù)屬性賦值的，但是由于total_amount也是支付寶關(guān)鍵key，支付寶將會(huì)認(rèn)為這個(gè)total_amount是支付寶業(yè)務(wù)的參數(shù)應(yīng)該是金額，這個(gè)最終將導(dǎo)致誤解析。下列請(qǐng)求串為了展示清晰，未進(jìn)行encode并且做了格式化處理，下同。

app_id=2014072300007148&charset=UTF-8&version=1.0×tamp=2016-07-01 08:08:08&method=alipay.trade.app.pay¬ify_url=https://api.**.com/pay_receive_notify.html&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
    "body":"對(duì)一筆交易的具體描述信息。如果是多種商品，請(qǐng)將商品描述字符串累加傳給body。",
    "subject":"大樂透",
    "out_trade_no":"70501111111S001111119",
    "timeout_express":"90m",
    "total_amount":"一共花費(fèi)了10元",
    "product_code":"QUICK_MSECURITY_PAY",
    "tips":"測試一筆支付"
  }

2.商戶的請(qǐng)求參數(shù)中，所有的key（支付寶關(guān)鍵key或者商戶自己的key），其對(duì)應(yīng)的value中都不應(yīng)該出現(xiàn)支付寶關(guān)鍵key，否則該類交易將可能被支付寶攔截禁止支付。 比如以下的請(qǐng)求中"subject":“大樂透 這個(gè)辣條不錯(cuò) out_trade_no=123 total_fee=123.5”,其value值中有支付寶關(guān)鍵key"out_trade_no"、“total_fee”，這樣的業(yè)務(wù)請(qǐng)求參數(shù)支付寶將會(huì)攔截。

app_id=2014072300007148&charset=UTF-8&version=1.0×tamp=2016-07-01 08:08:08&method=alipay.trade.app.pay¬ify_url=https://api.**.com/pay_receive_notify.htm&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
    "body":"對(duì)一筆交易的具體描述信息。如果是多種商品，請(qǐng)將商品描述字符串累加傳給body。",
    "subject":"大樂透 這個(gè)辣條不錯(cuò) out_trade_no=123 total_fee=123.5",
    "out_trade_no":"70501111111S001111119",
    "timeout_express":"90m",
    "total_amount":10.0,
    "product_code":"QUICK_MSECURITY_PAY"
  }

3.商戶支付請(qǐng)求參數(shù)的安全注意點(diǎn)： a）請(qǐng)求參數(shù)的sign字段請(qǐng)務(wù)必在服務(wù)端完成簽名生成（不要在客戶端本地簽名）； b）支付請(qǐng)求中的訂單金額total_amount，請(qǐng)務(wù)必依賴服務(wù)端，不要輕信客戶端上行的數(shù)據(jù)（客戶端本地上行數(shù)據(jù)在用戶手機(jī)環(huán)境中無法確保一定安全）。