Product limit validation

Hive 主控台 > 社群 & 網頁商店 > 網頁商店 > 商品管理 可為網頁商店商品設定帳號購買限制與購買數量限制，並可為兩項設定各自配置最大購買數量。

網頁商店購買限制驗證用於檢查網頁商店中已付款的商品是否超出上述兩項設定的最大購買數量。為此提供網頁商店付款資訊驗證 API。

概述¶

包含呼叫 網頁商店付款資訊驗證 API 在內的網頁商店購買限制驗證整體流程如下：

1. 開發者：參考PG 付款實作與PG 設定，建構使用者在網頁商店透過 PG 付款後發放商品的流程。
2. 開發者：當使用者在網頁商店購買具帳號購買限制或購買數量限制的商品時，在發放商品前呼叫網頁商店付款資訊驗證 API。
3. Hive 伺服器：驗證該訂單是否超出商品最大購買數量。驗證結果作為 API 回應傳回開發者伺服器。
4. 開發者：僅在驗證條件（例如：未超出最大購買數量）通過時發放商品。若訂單超出最大購買數量，則不發放商品並執行付款取消。網頁商店僅在驗證結果無問題時才會將數量反映為已售並減少剩餘數量。若 API 回應判定為無效付款，伺服器不得向使用者發放商品，且必須執行付款取消。

網頁商店付款資訊驗證 API¶

依據已完成的網頁 PG 付款資訊驗證付款是否有效，包括是否超出商品最大購買數量。

Request information¶

Request header¶

Request header sample¶

Content-Type : application/json
Authorization : Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY

Request body¶

Request body sample¶

{
    "type": "paid",
    "market_pid": "com.com2us.hivesdk.windows.microsoftstore.global.normal.item01",
    "order_id" : "H3175513391360875943",
    "server_id" : "1",
    "appid" : "com.com2us.hivesdk.windows.hivepc", 
    "cs_code" : "20000023100", 
    "paid_datetime": "2025-08-14 10:12:18",
    "quantity": "10",
    "iap_payload": "{\"cs_code\":20000023100,\"data\":{\"server_id\":\"1\",\"server_name\":\"Server 1\",\"channels\":{\"channel_id\":\"11\",\"channel_name\":\"Channel 11\",\"characters\":{\"character_id\":\"111\",\"character_name\":\"Character 111\"}}}}",
}

Response body¶

• 僅對 100, 101 回應進行正常發放。
• 3001 表示該訂單已完成驗證。僅在尚未發放商品時再次發放。
• 3002 表示超出商品最大購買數量。必須執行付款取消。 詳情參閱發放結果處理。

Response body sample¶

{
    "code": 100,
    "msg": "success"
}

Response codes¶

以下為回應代碼(code)說明。