> For the complete documentation index, see [llms.txt](https://docs.thndr.io/integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thndr.io/integration/server-webhooks/prizes.md).

# 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.

{% hint style="info" %}
This feature is optional - it is not required to go live with our games.
{% endhint %}

### 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**.

```json
{
   "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](/integration/server-webhooks/currencies.md)).
* `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.