User Validation

Verifies whether the game ID and server information entered by the user are valid and whether the item can be purchased.

Request URI

HTTP Type	HTTPS
HTTP Method	POST
URL	You can register the server URL in Developer Center > Webshop > Integration Mgmt. For setup instructions, refer to the Integration Management Guide.
Header	Content-Type: application/json; charset=UTF-8 Accept: application/json

Request

Name	Type	Mandatory	Description
param.clientId	String	M	ONE webshop Title ID(Product ID)
param.prodId	String	M	ONE webshop Item ID(In-App Product ID)
param.serviceUserId	String	M	User’s Game ID
param.serviceServerId	String	Optional	User’s Server ID ※ This is required when Purchase Input Information = Purchase Identifier + Server

Example

curl -X POST \
  'https://example.com/gameuser/check' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "param": {
      "clientId": "WS00000001",
      "prodId": "item1000",
      "serviceUserId": "USR1234567890",
      "serviceServerId": "asia01"
    }
  }'

Response

Name	Type	Mandatory	Description
result.code	String	M	"0000": Success "1000": Non-member "1001": Not allowed to purchase
result.message	String	M	When result.code is "1001", this message is displayed to the user. It is recommended to provide the message in a language appropriate for the target users. Example messages "구매 가능한 횟수를 초과하였습니다."(You have exceeded the maximum number of purchases allowed.) "이미 구매한 상품입니다."(This product has already been purchased.) "이벤트 기간이 종료된 상품입니다."(This product is no longer available as the event period has ended.)

Example

// Success
{
  "result": {
    "code": "0000",
    "message": "User found"
  }
}

// Non-member
{
  "result": {
    "code": "1000",
    "message": "User not found"
  }
}

//Not allowed to purchase
{
  "result": {
    "code": "1001",
    "message": "구매 가능한 횟수를 초과하였습니다." //You have exceeded the maximum number of purchases allowed.
  }
}