交易與支付模組介面文件

许凌铎發表於2024-12-06

一、發起支付

1、基本資訊：

請求路徑：/trade/request
請求方式：POST
介面描述：該介面用於對一個商品進行購買時發起支付請求

2、請求引數：
請求引數格式：application/x-www-form-urlencoded

引數名稱 說明 型別 是否必須 備註
id 商品id number 是
return_url 支付完成後需要返回的地址 String 是 可以為空但不能不傳

3、請求樣例：

~/trade/request?id=2&return_url

4、響應資料：
響應型別：html/utf-8
響應引數說明：html程式碼用於頁面重定向
響應資料樣例：

<form name="punchout_form" method="post"
    action="https://openapi-sandbox.dl.alipaydev.com/gateway.do?charset=UTF-8&method=alipay.trade.wap.pay&sign=g5BakLqgnCDBrOPOi5e7kS%2BYOlP78Zb5pfHsh6j8mUGH4Biv9kxG1CO9Ghqlqhx3FJnb0iAhB8hwCtECdoFZsIsYbK5AY5clauDrv9x765sFlv3kyAC8Pof9FJF5YDinIR80T70pGWOzP8wj6x3GySXGnygK%2Fz%2Bmz9IlGeuNX4I7Lyw8UX9bw94YDrL20slsf9RkoC9utQlM43zz9HI%2F2APknkzEMoDQ7sG5R8Bff%2FpUzCTW%2FmRev6FnPvb2P0wQq7bDCn0NmuwxQD420hTJWFgAW8YIRZMLimJwdr%2FFNwDJv4JQGnetuQkVbnPyz7VXILXa2kPhtbIXJE6DoE%2FEzw%3D%3D&notify_url=http%3A%2F%2Fuxqmjb.natappfree.cc%2Ftrade%2FpayNotify&version=1.0&app_id=9021000142633600&sign_type=RSA2&timestamp=2024-12-06+03%3A07%3A41&alipay_sdk=alipay-sdk-java-4.39.134.ALL&format=json">
    <input type="hidden" name="biz_content" value="{&quot;out_trade_no&quot;:&quot;1733425661078a245c8c2&quot;,&quot;passback_params&quot;:&quot;id=2=user_id=2&quot;,&quot;product_code&quot;:&quot;QUICK_WAP_WAY&quot;,&quot;quit_url&quot;:&quot;&quot;,&quot;seller_id&quot;:&quot;2088721051176121&quot;,&quot;subject&quot;:&quot;軟體工程導論&quot;,&quot;time_expire&quot;:&quot;2024-12-06 03:17:41&quot;,&quot;total_amount&quot;:&quot;9.99&quot;}">
    <input type="submit" value="立即支付" style="display:none" >
</form>
<script>
    document.forms[0].submit();
</script>

二、支付時間查詢

1、基本資訊：

請求路徑：/trade/searchEndTime
請求方式：GET
介面描述：該介面用於查詢支付狀態的商品最晚支付時間，可以用於計算並顯示剩餘支付時間

2、請求引數：
請求引數格式：application/x-www-form-urlencoded

引數名稱 說明 型別 是否必須 備註
id 商品id number 是

3、請求樣例：

~/trade/searchEndTime?id=2

4、響應資料：
響應型別：applocation/json
響應引數說明：

引數名稱 型別 是否必須 預設值 備註 其他資訊
code number 是 響應碼，0-成功，1-失敗
message String 否 提示資訊
data String 是 返回的資料

響應資料樣例：

2024-12-06 03:17:41

三、支付頁面找回

1、基本資訊：

請求路徑：/trade/resetPage
請求方式：POST
介面描述：該介面用於對支付狀態下商品的支付頁面進行找回

2、請求引數：
請求引數格式：application/x-www-form-urlencoded

引數名稱 說明 型別 是否必須 備註
id 商品id number 是

3、請求樣例：

~/trade/resetPage?id=2&return_url

4、響應資料：
響應型別：html/utf-8
響應引數說明：html程式碼用於頁面重定向
響應資料樣例：

<form name="punchout_form" method="post"
    action="https://openapi-sandbox.dl.alipaydev.com/gateway.do?charset=UTF-8&method=alipay.trade.wap.pay&sign=g5BakLqgnCDBrOPOi5e7kS%2BYOlP78Zb5pfHsh6j8mUGH4Biv9kxG1CO9Ghqlqhx3FJnb0iAhB8hwCtECdoFZsIsYbK5AY5clauDrv9x765sFlv3kyAC8Pof9FJF5YDinIR80T70pGWOzP8wj6x3GySXGnygK%2Fz%2Bmz9IlGeuNX4I7Lyw8UX9bw94YDrL20slsf9RkoC9utQlM43zz9HI%2F2APknkzEMoDQ7sG5R8Bff%2FpUzCTW%2FmRev6FnPvb2P0wQq7bDCn0NmuwxQD420hTJWFgAW8YIRZMLimJwdr%2FFNwDJv4JQGnetuQkVbnPyz7VXILXa2kPhtbIXJE6DoE%2FEzw%3D%3D&notify_url=http%3A%2F%2Fuxqmjb.natappfree.cc%2Ftrade%2FpayNotify&version=1.0&app_id=9021000142633600&sign_type=RSA2&timestamp=2024-12-06+03%3A07%3A41&alipay_sdk=alipay-sdk-java-4.39.134.ALL&format=json">
    <input type="hidden" name="biz_content" value="{&quot;out_trade_no&quot;:&quot;1733425661078a245c8c2&quot;,&quot;passback_params&quot;:&quot;id=2=user_id=2&quot;,&quot;product_code&quot;:&quot;QUICK_WAP_WAY&quot;,&quot;quit_url&quot;:&quot;&quot;,&quot;seller_id&quot;:&quot;2088721051176121&quot;,&quot;subject&quot;:&quot;軟體工程導論&quot;,&quot;time_expire&quot;:&quot;2024-12-06 03:17:41&quot;,&quot;total_amount&quot;:&quot;9.99&quot;}">
    <input type="submit" value="立即支付" style="display:none" >
</form>
<script>
    document.forms[0].submit();
</script>

四、支付結果查詢

1、基本資訊：

請求路徑：/trade/check
請求方式：GET
介面描述：該介面用於查詢一個經過支付請求的商品是否完成支付

2、請求引數：
請求引數格式：application/x-www-form-urlencoded

引數名稱 說明 型別 是否必須 備註
id 商品id number 是

3、請求樣例：

~/trade/check?id=2

4、響應資料：
響應型別：applocation/json
響應引數說明：

引數名稱 型別 是否必須 預設值 備註 其他資訊
code number 是 響應碼，0-成功，1-失敗
message String 否 提示資訊
data String 是 返回的資料
響應資料樣例： 
支付未完成：
{
    "code": 1,
    "massage": "尚未支付",
    "data": null
}


支付完成：
{
    "code": 0,
    "massage": "操作成功",
    "data": "當前時間： 00:40:18.886273200 來自於 MiniShopping "
}

相關文章