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

Hiveコンソール > コミュニティ & ウェブショップ > ウェブショップ > 商品管理では、ウェブショップ商品のアカウント別購入制限および購入数量制限を設定できます。両方の設定に対して最大購入数量を構成できます。

ウェブショップ購入制限検証は、ウェブショップで決済された商品がこれら2つの設定で定義された最大購入数量を超えているかどうかを確認する作業です。本項目ではこの作業のためにウェブショップ決済情報検証APIを提供します。

概要¶

ウェブショップ決済情報検証API呼び出しを含む、ウェブショップ購入制限検証の全体的な流れは以下のとおりです。

1. アプリ開発社: PG決済実装およびPG社設定を参照し、ウェブショップでユーザーがPG決済を行う際に商品を付与するプロセスを構築します。
2. アプリ開発社: ユーザーがアカウント別購入制限または購入数量制限がある商品を購入した場合、商品付与前にウェブショップ決済情報検証APIを呼び出します。
3. Hive サーバ: 当該注文で商品の最大購入数量超過の有無を検証します。検証結果はAPIレスポンスとして開発社サーバーへ返却します。
4. アプリ開発社: APIレスポンスを確認し、検証条件(例: 最大購入数量超過の有無)を満たした場合のみ商品を付与します。最大購入数量を超過した注文であれば商品を付与せず、決済をキャンセルします。ウェブショップは検証結果に問題がない場合のみ販売完了数量として反映し、商品の残余数量を減少させます。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)の仕様です。