Prizes

POST /players/[playerId]/claim

Allows a player to claim a prize, which may be a coin reward or a physical/digital product. If a product is physical, address details are required. Only one prize type can be claimed per request.

Endpoint

POST/players/{playerId}/claim

Request Body

{
  "coinPrize": "integer"
  "productId": "string"
  "addressLine1": "string"
  "city": "string"
  "country": "string"
  "postalCode": "string"
  "email": "string"
}

Atributo	Tipo	Requerido	Descripción
coinPrize	integer	No	Optional. Required if no productId is set. Cannot be used with productId.
productId	string	No	Optional. Required if no coinPrize is set. Cannot be used with coinPrize.
addressLine1	string	No	Required if the product is physical.
city	string	No
country	string	No
postalCode	string	No
email	string	No

Parameters

Atributo	Descripcion	Tipo	Ubicación	Requerido
playerId		string	path	Sí

Responses

200

Prize claimed successfully.

400

Invalid claim data.

500

Failed to process claim.

Orders Catalogs