User Validation

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

• Game ID is the value used to identify the final recipient (user or character) who will receive the item.In the Webshop, it is transmitted as serviceUserId. (Depending on the game structure, it may be used as a UID or a Character ID.)

Request URI

Notice According to the ONE webshop security policy, only the HTTPS protocol and port 443 are supported. Using any other configuration may result in improper operation.

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
signature	String	M	Signature Verification (License Key) The signature key can be found in Developer Center > Integration Mgmt. > Settings for Licensing Guide : How to review the signature

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"
    },
    "signature": "ajkfl;askfjkladfjksl"
  }'

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.)
developerPayload	String	Optional	An identifier for a purchase provided by the developer in the validation response. It is also included in the PNS after payment completion and used for purchase verification.

Example

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

// 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.
  }
}