Wallet API

Rollback

Returns a stake. A rollback is a deposit with action: "rollback": there is no separate endpoint.

Path/deposit

MethodPOST

Content-Typeapplication/json

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

Sent to your /deposit with action: "rollback".

When we call it

A player cancels a bet before the round starts.
A stake was confirmed too late to play (after its round ended).
Your wallet took a stake but left the balance below zero.

Request

Parameter	Type	Description
`user_id`required	string	Your player ID, as your `/auth` returned it.
`session_token`required	string	The launch token the player opened the game with.
`currency`required	string	Currency code, e.g. `KES`.
`amount`required	number	The amount to move, in the agreed unit (see Amounts). Never negative.
`game`required	string	The game code, e.g. `avionix` (see Games).
`action`required	string	Always `rollback`.
`provider`required	string	Who is calling: the same value as `X-Client-ID`.
`provider_tx_id`required	integer	Our transaction ID: the bet's ID for stakes, wins and rollbacks. Unique per game server; store it as text.
`action_id`required	integer	Same value as `provider_tx_id`.
`platform`required	string	Device type. Currently always `mobile`.
`withdraw_provider_tx_id`required	integer	The `provider_tx_id` of the withdraw being returned.

Request body

{
  "user_id": "100245",
  "session_token": "8f3c1d2e9b7a4c5d8e1f2a3b4c5d6e7f",
  "currency": "KES",
  "amount": 100,
  "game": "avionix",
  "action_id": 5823019,
  "action": "rollback",
  "provider": "avionix",
  "provider_tx_id": 5823019,
  "platform": "mobile",
  "withdraw_provider_tx_id": 5823019
}

Response

Field	Type	Description
`code`required	integer	`200` when the money moved (or had already moved, for a repeat).
`message`required	string	`ok`, or the reason for a refusal (shown to the player).
`data.old_balance`required	number	The balance before this transaction.
`data.new_balance`required	number	The balance after it.
`data.operator_tx_id`optional	string	Your transaction ID, for reconciliation.
`data.user_id`optional	string	Echo of the request.
`data.provider`optional	string	Echo of the request.
`data.provider_tx_id`optional	integer	Echo of the request.
`data.currency`optional	string	The balance currency.

Response

{
  "code": 200,
  "message": "ok",
  "data": {
    "operator_tx_id": "884127",
    "user_id": "100245",
    "provider": "avionix",
    "provider_tx_id": 5823019,
    "old_balance": 1400.5,
    "new_balance": 1500.5,
    "currency": "KES"
  }
}

Result codes

Code	Meaning
`200`	Stake returned.
`500`	Unclear: the rollback is retried.

Every method: see Result codes.