StageUpStageUp
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

  1. 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.
  2. 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.
  3. 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.
  4. 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

NameValue
Content-Typeapplication/json
X-API-KEYAPI KEY

Body

NameTypeDescriptionExample
userIDstringUser ID entered by customerplayerID
serverIDstringServer ID (if needed)serverID
amountnumberProduct price1.99
currencystringCurrencyUSD
methodstringSub payment method100000
productIDstringProduct IDcom.game.item.001
paymentIDstringPayment method IDkcp

Response

Success Response (200)
{
  "status": 1,
  "message": "OK"
}
Error Response (400)
{
  "status": -1,
  "message": "error message"
}

On this page