建立交易,擷取交易號,使用小程式方法(my.tradePay)完成支付流程。
公用請求參數
參數 | 類型 | 是否必選 | 最大長度 | 描述 | 樣本值 |
app_id | String | 必選 | 32 | 小程式 id | 2014072300007148 |
method | String | 必選 | 128 | 介面名稱 | trade.create |
format | String | 可選 | 40 | 僅支援 JSON | JSON |
charset | String | 必選 | 10 | 請求使用的編碼格式,如 utf-8,gbk,gb2312 等 | utf-8 |
sign_type | String | 必選 | 10 | 商戶產生簽名字串所使用的簽名演算法類型,目前支援 RSA2 和 RSA,推薦使用 RSA2 | RSA2 |
sign | String | 必選 | 344 | 商戶請求參數的簽名串,詳見簽名 | 詳見樣本 |
timestamp | String | 必選 | 19 | 發送請求的時間,格式 | 2014-07-24 03:07:50 |
version | String | 必選 | 3 | 調用的介面版本,固定為:1.0 | 1.0 |
biz_content | String | 必選 | - | 請求參數的集合,最大長度不限,除公用參數外所有請求參數都必須放在這個參數中傳遞,具體參照各產品快速接入文檔 | - |
業務請求參數
參數 | 類型 | 是否必選 | 最大長度 | 描述 | 樣本值 |
out_trade_no | String | 必選 | 64 | 商戶訂單號,由商家自訂,64 個字元以內,僅支援字母、數字、底線且需保證在商戶端不重複 | 20150320010101001 |
total_amount | String | 必選 | 9 | 訂單總金額。 單位為元,精確到小數點後兩位,取值範圍:[0.01,100000000] | 88.88 |
subject | String | 必選 | 256 | 訂單標題。 重要 不可使用特殊字元,如 /,=,& 等。 | iPhone6 16G |
product_code | String | 必選 | 64 | 小程式情境支付:JSAPI_PAY | JSAPI_PAY |
op_app_id | String | 必選 | 32 | 小程式支付中,商戶實際經營主體的小程式應用的 appid,也即最終喚起收銀台支付所在的小程式的應用id | 2014072300007148 |
buyer_open_id | String | 必選 | 128 | 買家使用者唯一標識 | 074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5 |
body | string | 可選 | 128 | 訂單附加資訊。 如果請求時傳遞了該參數,將在非同步通知、對賬單中原樣返回,同時會在商戶和使用者的 pc 賬單詳情中作為交易描述展示 | iPhone6 16G |
常見請求樣本
預設樣本:
curl 'https://xxxx/gateway.do?charset=UTF-8&method=trade.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=RSA2×tamp=${now}' \
-F 'biz_content={
"out_trade_no":"20150320010101001",
"product_code":"JSAPI_PAY",
"op_app_id":"2014072300007148",
"total_amount":"88.88",
"subject":"iphone6 16G",
"body":"iphone6 16G",
"buyer_open_id":"074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5"
}' 本樣本僅供參考。
公用響應參數
參數 | 類型 | 是否必選 | 最大長度 | 描述 | 樣本值 |
code | String | 必選 | - | 網關返回碼 | 40004 |
msg | String | 必選 | - | 網關返回碼描述 | Business Failed |
sub_code | String | 可選 | - | 業務返回碼,參見具體的 API 介面文檔 | ACQ.TRADE_HAS_SUCCESS |
sub_msg | String | 可選 | - | 業務返回碼描述,參見具體的 API 介面文檔 | 交易已被支付 |
sign | String | 必選 | - | 簽名 | DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo= |
業務響應參數
參數 | 類型 | 是否必選 | 最大長度 | 描述 | 樣本值 |
out_trade_no | String | 必選 | 64 | 商戶訂單號 | 20150423001001 |
trade_no | String | 必選 | 64 | Payme 交易號 | 2015042321001004720200028594 |
響應樣本
{
"trade_create_response": {
"code": "10000",
"msg": "Success",
"out_trade_no": "20150423001001",
"trade_no": "2015042321001004720200028594"
},
"sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}