Wallet API

Player info

Returns a player's current balance.

Path/info

MethodPOST

Content-Typeapplication/json

HeadersX-Client-IDX-Client-TSX-Client-Signature

Appended to your wallet base URL. Signed: see Securing requests.

When we call it

Before money changes that aren't bets, such as a player making it rain in chat.

Request

Parameter	Type	Description
`user_id`required	string	Your player ID, as your `/auth` returned it.
`session_token`required	string	The player's launch token.
`currency`required	string	Currency code, e.g. `KES`.

Request body

{
  "user_id": "100245",
  "session_token": "8f3c1d2e9b7a4c5d8e1f2a3b4c5d6e7f",
  "currency": "KES"
}

Response

Field	Type	Description
`code`required	integer	`200` when the player was found.
`message`required	string	`ok`, or the reason for a refusal.
`data.user_id`required	string	The player's ID on your side. The game sends it back on every later call.
`data.balance`required	number	The player's balance, in the amount unit agreed for your integration.
`data.username`optional	string	Display name. Other players only ever see it masked (`j***u`).
`data.phone`optional	string	Kept on our side for support; never shown to other players.
`data.currency`optional	string	The balance currency, e.g. `KES`.

Response

{
  "code": 200,
  "message": "ok",
  "data": {
    "user_id": "100245",
    "username": "jkamau",
    "phone": "254712345678",
    "balance": 1500.5,
    "currency": "KES"
  }
}

Result codes

Code	Meaning
`200`	Player found.
`404`	No such player.

Every method: see Result codes.