Web shop purchase limit validation

Hive Console > Community & Web Shop > Web Shop > Product Management lets you set a per-account purchase limit and a purchase quantity limit for each web shop product. For each of these settings you can configure the maximum purchase quantity.

Web store purchase limit validation checks whether the purchased product in the web shop exceeds the maximum purchase quantity defined by those two settings. For this task, the Web store payment information validation API is provided.

Overview¶

The overall flow of web store purchase limit validation, including calling the Web store payment information validation API, is summarized below.

1. Game developer: Build the process that grants the product to the user when a PG (Payment Gateway) payment is made in the web store, referring to Implementing PG payment and PG configuration.
2. Game developer: When a user purchases a product that has a per-account purchase limit and/or purchase quantity limit in the web store, call the Web store payment information validation API before granting the product.
3. Hive server: Validates whether the order exceeds the product's maximum purchase quantity. After validation, returns the result to the developer server as the API response.
4. Game developer: Only grant the product if the validation conditions (e.g., not exceeding the maximum purchase quantity) are satisfied. If the order exceeded the maximum purchase quantity, do not grant the product and perform a payment cancellation. The web store only reflects the purchased quantity and decreases the remaining quantity when the validation passes. If the API response indicates the payment is invalid, the developer server must NOT grant the product and must cancel the payment.

Web store payment information validation API¶

Validates whether the payment (based on completed web PG payment info) is valid, including whether the maximum purchase quantity for the product has been exceeded.

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¶

• Only for responses 100, 101 should the product be granted.
• 3001 means the order has already been validated. Grant the product only if it was not granted previously.
• 3002 means the product's maximum purchase quantity was exceeded. You must cancel the payment. See Grant result processing for details.

Response body sample¶

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

Response codes¶

Below are the specifications for the response codes (code).