Api
Product Purchase Validation API Request
Web Store Product Purchase Validation Game Server Verification Feature Guide
When selecting products in the web store, this is a feature that verifies the purchasability of the product through the game server.
Generally, not all products need to go through this verification, and it's needed in specific situations as described below.
When verification feature is needed
- When you need to distinguish game users who can purchase specific products
- Example: Only users above a certain level can purchase
- Example: Only users who completed specific quests can purchase
- → The server determines purchase eligibility in real-time based on the user's in-game status.
- When complex purchase conditions are difficult to implement in the web store
- Example: When complex calculations of in-game currency held by users are required
- Example: When purchase conditions vary based on user's game progress
- → Accurately verify conditions using game server data and logic.
- When product purchase eligibility is determined by specific events rather than dates
- Example: Products can only be purchased when specific events are active
- Example: Conversely, product purchases are restricted during specific event periods
- → Manage purchase eligibility in real-time based on in-game event triggers.
- When other complex features are needed
- Example: One-time purchase limit per user
- Example: Complex policies like discounts based on purchase frequency
- → Can be designed to be flexibly expandable on the game server.
Validation API Request
POST /product
This is a webhook to check if the product ID is valid.
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
| X-API-KEY | API KEY |
Body
| Name | Type | Description | Example |
|---|---|---|---|
userID | string | User ID entered by customer | playerID |
serverID | string | Server ID (if needed) | serverID |
amount | number | Product price | 1.99 |
currency | string | Currency | USD |
method | string | Sub payment method | 100000 |
productID | string | Product ID | com.game.item.001 |
paymentID | string | Payment method ID | kcp |

