# Win

This endpoint is triggered when a user wins or loses (where the amount equals 0). The Operator is responsible for increasing the player's balance by the specified amount and returning the updated balance. Each win is assigned a unique identifier, `transaction_id`.

Before modifying the user's balance, the Operator must ensure that the win has not been previously processed.

## POST /operator/wallet

> Process a win result by crediting the specified amount to the player's balance.\
> \
> The \`amount\` is in subunits (e.g., cents for EUR) and follows ISO 4217 standards.\
>

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"Casino API - Result (Win)","version":"1.0.0"},"paths":{"/operator/wallet":{"post":{"description":"Process a win result by crediting the specified amount to the player's balance.\n\nThe `amount` is in subunits (e.g., cents for EUR) and follows ISO 4217 standards.\n","tags":["Result"],"parameters":[{"name":"X-REQUEST-SIGN","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA256 signature of the raw request body using the shared password.\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","currency_code","is_mobile","player_id","action","payload"],"properties":{"amount":{"type":"integer","description":"Amount in subunits. Set to 0 for a lost result."},"currency_code":{"type":"string","description":"Identifier of currency (ISO 4217)."},"is_mobile":{"type":"boolean","description":"True if it's a mobile client."},"player_id":{"type":"string","description":"Unique identifier of player."},"action":{"type":"string","enum":["win"],"description":"Must be set to \"win\"."},"payload":{"type":"object","required":["reference","session_token","provider_transfer_data"],"properties":{"reference":{"type":"string","description":"Game reference (e.g., barbarabang::MadMonkey)."},"session_token":{"type":"string","description":"Session token generated on game launch."},"provider_transfer_data":{"type":"object","required":["transaction_id","round_id","round_close"],"properties":{"transaction_id":{"type":"string","description":"Game Provider transaction ID."},"round_id":{"type":"string","description":"Game Provider round ID."},"round_close":{"type":"boolean","description":"True if the round is being closed."},"table_reference":{"type":"string","description":"Current table reference (required for live casino)."},"promo":{"type":"object","description":"Promotion details related to the transaction.","properties":{"type":{"type":"string","description":"Type of Provider's promotion"},"id":{"type":"string","description":"ID of promotion in Provider's system"}}},"jackpot":{"type":"object","properties":{"is_jackpot":{"type":"boolean"},"jackpot_id":{"type":"string","nullable":true},"jackpot_contribution":{"type":"string","nullable":true},"jackpot_details":{"type":"string","nullable":true}}},"tournament":{"type":"object","properties":{"is_tournament":{"type":"boolean"},"tournament_id":{"type":"string","nullable":true},"score":{"type":"string","nullable":true},"place":{"type":"string","nullable":true}}},"free_spin":{"type":"object","properties":{"is_free_spin":{"type":"boolean"},"free_spin_id":{"type":"string","nullable":true},"free_spin_details":{"type":"string","nullable":true},"freespin_left":{"type":"string","nullable":true}}}}}}}}}}}},"responses":{"200":{"description":"Result processed successfully.","content":{"application/json":{"schema":{"type":"object","required":["transaction_id","balance","currency_code"],"properties":{"transaction_id":{"type":"string","description":"Unique identifier of the operator transaction."},"balance":{"type":"integer","description":"Updated balance in subunits (e.g., cents)."},"currency_code":{"type":"string","description":"Identifier of currency."}}}}}},"503":{"description":"Service is unavailable.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}}}}}}
```
