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

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.

Header parameters

X-REQUEST-SIGNstringRequired

HMAC-SHA256 signature of the raw request body using the shared password.

Body

amountintegerRequired

Amount in subunits. Set to 0 for a lost result.

currency_codestringRequired

Identifier of currency (ISO 4217).

is_mobilebooleanRequired

True if it's a mobile client.

player_idstringRequired

Unique identifier of player.

actionstring · enumRequired

Must be set to "win".

Possible values:

Responses

200

Result processed successfully.

application/json

503

Service is unavailable.

application/json

post

HTTPcURLJavaScriptPython

POST /operator/wallet HTTP/1.1
Host: 
X-REQUEST-SIGN: text
Content-Type: application/json
Accept: */*
Content-Length: 653

{
  "amount": 100000,
  "is_mobile": false,
  "player_id": "12",
  "currency_code": "EUR",
  "action": "win",
  "payload": {
    "reference": "Monkey",
    "session_token": "8eb654b0-e660-4fe5-9fa2-f9c7d26689ac",
    "provider_transfer_data": {
      "round_id": "20111312111",
      "transaction_id": "11121219dd1f161",
      "round_close": true,
      "table_reference": "c9cbb3d5-439f",
      "promo": {
        "type": "welcome_bonus",
        "id": "promo_1001"
      },
      "jackpot": {
        "is_jackpot": false,
        "jackpot_id": null,
        "jackpot_contribution": null,
        "jackpot_details": null
      },
      "tournament": {
        "is_tournament": false,
        "tournament_id": null,
        "score": null,
        "place": null
      },
      "free_spin": {
        "is_free_spin": false,
        "free_spin_id": null,
        "free_spin_details": null,
        "freespin_left": null
      }
    }
  }
}

{
  "transaction_id": "563214566",
  "balance": 54636,
  "currency_code": "EUR"
}