POST /tournament-prize
This operation is idempotent.
| Name | Type | Description |
|---|
| X-Auth-Token | string | Custom authentication header in the format X-Auth-Token: your_token_here. This token is required to authorize API requests. |
Request Parameters
| Name | Type | Description |
|---|
| playerId | string | Unique identifier of the player. |
| amount | decimal | Amount to debit. |
| transactionId | string | Unique identifier of the game round transaction. |
| transactionTimestamp | integer | Timestamp of the transaction in milliseconds. |
| currency | string | Currency code of the player. |
Response Parameters
| Name | Type | Description |
|---|
| balance | decimal | The updated balance of the player. |
Error
If an error occurs while processing a request, the API must return a response with HTTP Status Code: 400 Bad Request
| Name | Type | Description |
|---|
| error_code | string | Error code describing the specific issue. |
Show Possible Error Codes
| Error Code | Description |
|---|
| INVALID_PLAYER_ID | The provided player ID is invalid or does not exist in the system. |
| INVALID_PLAYER_CURRENCY | The player’s currency is invalid or mismatched. |
| TECHNICAL_ERROR | An unexpected error occurred. |
| NOT_AUTHORIZED | The request is not authorized due to invalid X-Auth-Token header. |
POST /tournament-prize
Content-Type: application/json
{
"playerId": "123e4567-e89b-12d3-a456-426614174000",
"amount": 1500.00,
"transactionId": "d1c4f1d6-7e35-4e62-84af-ef83b474d8a9",
"transactionTimestamp": 1632771475000
}