Cashback a Prize

Notify LoyaltyGyre that a player has chosen to cash back a prize. This call logs the player's decision, allowing LoyaltyGyre to track that the prize was redeemed as a cashback rather than retained or ignored.

Endpoint

POST /prize/cashback

Query Parameters

Parameter	Type	Description
player_id Required	string / number	The unique identifier for the player in the casino's system.
prize_id Required	string / number	The unique identifier for the prize that the player has chosen to cash back.

Example Request

cURL

curl -X POST "https://app.loyaltygyre.com/api/prize/cashback" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"player_id": "12345", "prize_id": "202"}'

Responses

200 OK

The cashback decision was successfully recorded.

Response

{
  "status": "success",
  "message": "Cashback decision recorded"
}

400 Bad Request

The request is missing required parameters or contains invalid data.

Response

{
  "status": "error",
  "message": "Missing or invalid player_id or prize_id"
}

401 Unauthorized

The API key is missing or invalid.

Response

{
  "status": "error",
  "message": "Invalid or missing API key"
}

404 Not Found

The specified prize was not found or is unavailable for cashback.

Response

{
  "status": "error",
  "message": "Prize not found or unavailable for cashback"
}

500 Internal Server Error

An internal error occurred while processing the request.

Response

{
  "status": "error",
  "message": "An error occurred while recording the cashback decision."
}