The Bet Brothers
HomeNewsLinkedIn
  • The Bet Brothers APIS
    • ๐ŸงฉCore Concepts
    • ๐Ÿ”API Flow
  • OPERATOR API
    • ๐Ÿ”—Operator Integration Service
    • ๐Ÿ”‘Protocol API
      • Create api-token
      • Revoke api-token
  • ๐Ÿš€Game Launcher API
    • Get Game Providers
    • Get Games
    • Launch Game in Demo Mode
    • Launch game in Real Mode
  • ๐Ÿ’ฐWallet API
    • Balance
    • Bet
    • Win
    • Refund
    • Rollback Win
  • โšกFree Spin API
    • Add Free Spin
    • Cancel Free Spin
  • ๐ŸŽฎGame Insights
    • Get Game Bet Levels
    • Get Round Info
  • ๐Ÿ“–Addendum
    • TBB Error Codes
    • Wallet Error Response
  • SUPPLIER API
    • ๐Ÿ”—Supplier Integration Service
    • ๐Ÿ”‘Supplier Protocol API
    • ๐Ÿš€Game Launcher API
      • Launch Game in Demo Mode
      • Launch Game in Real Mode
  • ๐ŸŽฒGame Events
    • Balance
    • Bet
    • Win
    • Refund
  • ๐Ÿ“–Addendum
    • TBB Error Codes
Powered by GitBook
On this page
  1. Wallet API

Bet

PreviousBalanceNextWin

Last updated 10 days ago

The endpoint is triggered when a user places a bet (debit transaction). It is the responsibility of the Operator to reduce the player's balance by the specified bet amount and return the updated balance.

Each bet is assigned a unique identifier, transaction_id, for tracking purposes. Before adjusting the user's balance, the Operator must verify that the bet has not been previously processed.

Additionally, the Operator must confirm that the player has sufficient balance to place the bet.

๐Ÿ’ฐ
post

Process a bet request by deducting the specified amount from the player's balance.

The amount is specified in subunits (e.g., cents for EUR) according to 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 (e.g., cents for EUR).

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 "bet".

Possible values:
Responses
200
Bet successfully processed.
application/json
402
Payment Required - The player does not have enough money for the action.
application/json
post
POST /operator/wallet HTTP/1.1
Host: 
X-REQUEST-SIGN: text
Content-Type: application/json
Accept: */*
Content-Length: 276

{
  "amount": 10,
  "is_mobile": false,
  "currency_code": "EUR",
  "player_id": "6",
  "action": "bet",
  "payload": {
    "reference": "Monkey",
    "session_token": "c9cbb3d5-439f-acf6-9415ea68b20a",
    "provider_transfer_data": {
      "transaction_id": "95303151",
      "round_id": "864238",
      "table_reference": "c9cbb3d5-439f"
    }
  }
}
{
  "transaction_id": "563214566",
  "balance": 54636,
  "currency_code": "EUR"
}