ウェブショップ購入制限検証API¶

「ウェブショップ購入制限検証」は、ウェブショップで決済された商品が最大購入数量を超過しているかを検証する機能です。Hiveサーバーでは、この機能としてウェブショップ決済情報検証APIを提供します。

事前準備¶

ウェブショップ決済情報検証APIを呼び出す前に、Hive Consoleで最大購入数量を設定します。Hive Console > コミュニティ & ウェブショップ > ウェブショップ > 商品管理で、購入数量制限検証設定を通じてウェブショップ商品にアカウント別購入制限と購入数量制限を設定します。それぞれに最大購入数量を設定できます。

動作フロー¶

1. アプリ: WebショップでPG決済時、アプリサーバーで商品を付与するプロセスを構築します。関連設定は決済通知設定を参照してください。
2. アプリサーバー: Webショップでユーザーが購入数量制限商品を購入した場合、商品付与前にWebショップ決済情報検証APIを呼び出します。
3. Hiveサーバー: ユーザーの商品注文が最大購入数量を超過しているか検証し、結果をAPIレスポンスとしてアプリサーバーへ送信します。
4. アプリサーバー: APIレスポンスを確認し、検証条件を通過した場合のみ商品を付与します。最大購入数量を超過した注文の場合は商品を付与せず、決済をキャンセルします。Webショップは検証結果に問題がない場合のみ販売完了数量として反映し、残数量を減少させます。無効な決済と判定された場合、アプリサーバーはユーザーに商品を付与せず、決済をキャンセルする必要があります。

ウェブショップ決済情報検証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."
  }
}

レスポンスコード¶