Payout
Credit a tournament or campaign payout to a player.
POST /payout
POST{operator endpoint}/payout
Process a payout for a player as a result of a campaign (e.g. tournament prize). This is not a bet/win transaction — it directly credits the player's wallet.
Request
Headers: X-Server-Authorization: hmac_sha256_hash · Authorization: Bearer {token}
{
"sessionId": "321e4567-e89b-45d3-b594-41234174249",
"payoutId": "123e4567-e89b-12d3-a456-426614174000",
"amount": 100.00,
"campaign": {
"id": "15f6402d-c242-4750-900a-805a0f15241c",
"type": "tournament"
}
}
Request Parameters
| Field | Type | Description | |
|---|---|---|---|
| sessionId | string (UUID) | required | Active game session identifier |
| payoutId | string (UUID) | required | Unique identifier for this payout operation. Used for idempotency |
| amount | number | required | Payout amount in the player's currency |
| campaign | object | required | Campaign context for this payout |
| campaign.id | string (UUID) | required | Unique identifier of the campaign triggering this payout |
| campaign.type | string | required | Campaign type. Allowed values: tournament |
Response
✓ 200 OK
{
"balance": 100.57
}
Response Parameters
| Field | Type | Description |
|---|---|---|
| balance | number | Updated player balance after the payout has been credited |