Prizes

THNDR calls this endpoint to notify the Operator of a prize transaction, instructing them to credit the player’s balance. The prize may originate from a tournament or other promotional sources.

This feature is optional - it is not required to go live with our games.

Endpoint

POST {operatorURL}/thndr/prizes

Prize Transaction

The PRIZE Transaction is sent by THNDR to notify the Operator that a player has been awarded a prize.

The Operator must process this request to credit the player’s balance.

{
   "type": "PRIZE",
   "transactionId": "a395479b-7d31-406e-abab-2dd66a61d5ee-PRIZE",
   "requestedAt": "2025-08-21T14:30:00.123Z",
   "userId": "{USER_ID}",
   "currency": "USD",
   "amount": 100,
   "source": {
      "type": "TOURNAMENT",
      "tournamentId": "86b40c46-07de-4914-9ae4-eadbaec69f51"
  }
}

• transactionId - Unique transaction identifier. Must be persisted by the Operator for idempotency.

• requestedAt - The date and time when the request was initially made, in ISO 8601 format (e.g., 2025-08-21T14:30:00.123Z).

• userId - Player identifier on the Operator’s platform.

• currency - Match currency (read more in Currencies).

• amount - Prize amount, in the smallest unit of the currency (e.g., cents for USD, pence for GBP).

• roomId - Identifier for the game room. Players sharing the same roomId are participating in the same PvP match.

• source - Information about the origin of the prize (e.g., tournament, promotion, campaign).

  • type - Type of prize source. Example values: TOURNAMENT

  • tournamentId - Identifier of the tournament if the prize originates from one.