Wallet, on your server
wallet.balance
Gets the player’s balance.
Who calls it
We → you
POST {your server}/v1/wallet.balanceWe send it when the game opens, or when the player comes back to it. The game shows the balance. We sign the call with our private key. Check it with our public key for the environment. See Signing calls. You answer within 3 seconds.
Request
| Field | Type | What it is |
|---|---|---|
sessionId | string | Links the money to our session. |
casinoSessionId | string | Links the money to your own session. |
playerId | string | Whose balance. |
currency | string | Which money. |
traceId | string | One search finds the whole chain on both sides. |
Answer
| Field | Type | What it is |
|---|---|---|
balance | integer | The new balance. |
If you do not answer in time, the game shows “Can’t load balance” with a retry button. After any retry of another wallet call, the game calls wallet.balance for a fresh balance.
Errors
No refusal codes are defined for this call.
Example
Request
{
"sessionId": "s-01JC8Z…",
"casinoSessionId": "c-5531",
"playerId": "p-82731",
"currency": "EUR",
"traceId": "tr-01JC…"
}
Answer
{ "ok": true, "result": { "balance": 25000 } }