網頁商店購買限制驗證 API¶

「網頁商店購買限制驗證」用於驗證在網頁商店付款的商品是否超過最大購買數量。Hive 伺服器透過網頁商店付款資訊驗證 API提供此功能。

準備事項¶

呼叫網頁商店付款資訊驗證 API 前，請在 Hive Console 中設定最大購買數量。在 Hive Console > 社群 & 網頁商店 > 網頁商店 > 商品管理 中，透過購買數量限制驗證設定為網頁商店商品設定帳號購買限制和購買數量限制，並可分別設定最大購買數量。

運作流程¶

1. 應用程式：在網頁商店進行 PG 付款時，建構由應用程式伺服器發放商品的流程。相關設定請參閱付款通知設定。
2. 應用程式伺服器：使用者在網頁商店購買購買數量限制商品時，在發放商品前呼叫網頁商店付款資訊驗證 API。
3. Hive 伺服器：驗證使用者商品訂單是否超過該商品最大購買數量，並將結果作為 API 回應值傳送給應用程式伺服器。
4. 應用程式伺服器：確認 API 回應值後，僅在通過驗證條件時發放商品。如果訂單超過最大購買數量，則不發放商品並取消付款。網頁商店僅在驗證結果無問題時反映為銷售完成數量並減少剩餘數量。若 API 回應值顯示為無效付款，應用程式伺服器不得向使用者發放商品，且必須取消付款。

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

Validates whether the payment is valid based on completed Web PG payment information, including whether the product exceeds the maximum purchase quantity.

Request information¶

Request header¶

Request header 範例¶

Content-Type : application/json
X-Access-Token: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InByb2plY3RfYWJjMTIzIn0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5leGFtcGxlIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJwcm9qZWN0IiwiaWF0IjoxNzE1NTg0MDAwLCJleHAiOjE3MTU1ODc2MDAsImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoiIiwiaXNfd2hpdGVsaXN0Ijp0cnVlfQ.signature

Request body¶

Request body 範例¶

{
  "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¶

• Products should be granted normally only for result_code responses 100 and 101.
• result_code 3001 is an already validated order. Grant the product only if it was not granted previously.
• result_code 3002 means the product maximum purchase quantity was exceeded. You must cancel the payment for that order. For details, see Grant result processing.

Response body 範例¶

成功¶

{
  "result_code": 100,
  "result_msg": "success",
  "token_validation": {
    "result_code": 0,
    "result_msg": "success"
  }
}

JWT 驗證失敗¶

{
  "result_code": 2499,
  "result_msg": "JWT validation failed. See token_validation for details.",
  "token_validation": {
    "result_code": 2408,
    "result_msg": "The access token is expired. Please refresh your token."
  }
}

回應代碼¶