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
    • 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
      • Launch Game in Demo Mode
      • Launch Game in Real Mode
  • ๐ŸŽฒGame Events
    • Balance
    • Bet
    • Win
    • Refund
  • ๐ŸŽฎGame Insights
    • Bet Levels
    • Round Info
  • โšกFree Spin API
    • Add Free Spin
    • Cancel Free Spin
  • ๐Ÿ“–Addendum
    • TBB Error Codes
Powered by GitBook
On this page
  1. Free Spin API

Add Free Spin

PreviousFree Spin APINextCancel Free Spin

Last updated 5 days ago

This endpoint enables The Bet Brothers platform to create an award for a player on the supplier's side.

โšก
post

Creates the specified number of free spin rounds for the player's account.

Header parameters
X-REQUEST-SIGNstringRequired

HMAC-SHA256 signature of the request body, generated using the shared secret.

Body
provider_namestringRequired

Name of the supplier.

provider_idintegerRequired

Unique identifier of the supplier.

player_idstringRequired

Unique identifier of the player.

game_symbolstringRequired

Symbol of the game for which free spins are being granted.

roundsintegerRequired

Number of free spin rounds to create.

amountnumber ยท floatRequired

Bet amount (decimal value) for each free spin round.

currency_codestringRequired

Currency code (ISO 4217).

start_datestring ยท date-timeRequired

Start date and time for the free spins validity period (ISO 8601 format).

end_datestring ยท date-timeRequired

End date and time for the free spins validity period (ISO 8601 format).

bonus_codestringRequired

Campaign ID on The Bet Brothers platform.

brand_idintegerRequired

Unique identifier of the brand on The Bet Brothers platform.

Responses
200
Free spin rounds successfully granted.
application/json
403
Forbidden โ€“ signature does not match.
application/json
post
POST /supplier_api/freespin/create HTTP/1.1
Host: 
X-REQUEST-SIGN: text
Content-Type: application/json
Accept: */*
Content-Length: 237

{
  "provider_name": "Wazdan",
  "provider_id": 19,
  "game_symbol": "wazdan::426",
  "player_id": "12",
  "brand_id": 100,
  "currency_code": "EUR",
  "rounds": 1,
  "amount": 1.2,
  "bonus_code": "1233",
  "start_date": "2023-06-26T14:30:00",
  "end_date": "2023-06-28T23:59:59"
}
{
  "status": "success",
  "bonus_id": 54636
}