# Operator Integration Service

We have made every effort to ensure the accuracy of the content provided in this document at the time of publication. However, please be aware that this document is subject to future changes. As necessary updates arise, we will release new versions to ensure the most accurate and up-to-date information is available.

The Seamless Wallet integration allows you to add The Bet Brothers games to your platform using your own wallet and authentication systems. With this integration, you maintain full control over the player and wallet, and all debits/credits are performed against your wallet in real-time.

***

* **API Protocol API** – Allows Operators to request and receive an API token used to authenticate all other requests to the TBB platform.
* **Game Launcher API** – Allows Operators to:
  * Retrieve a list of available games and game providers integrated by TBB.
  * Generate game launch sessions for players.
* **Wallet API** – A Seamless Wallet integration. TBB triggers this API to:
  * Request the player's **balance**.
  * Send **bet** and **win** transactions to update the user's balance.\
    The Operator must **provide the corresponding endpoints** and implement them according to the provided API structure.
* **Free Spin API** – Enables the Operator to grant promotional rewards such as free spins to players.\
  ⚠️ *Note*: Not all games are compatible with free spins.
* **Game Insights**  – Allows Operators to:
  * Retrieves valid bet levels (amounts) for the specified game and currency, which are used during free spin creation. 
  * Retrieve the historical game graphic link for a given round ID.
* Addendum — Error Codes Reference. 
  * This page provides a detailed list of error codes that Operators may encounter when interacting with the platform. It includes descriptions for each error code to help troubleshoot and resolve any issues during API interactions.

***

<mark style="color:red;">Important Notice: Avoid Strict API Contracts</mark>

<mark style="color:red;">It is recommended to avoid implementing strict contracts for the APIs. Periodically, additional fields may be introduced to existing methods to maintain API compatibility. If strict contracts are enforced, these changes could lead to compatibility issues and potentially disrupt API functionality.</mark>

***

## Getting Started

To begin integrating with TBB, ensure you have the following:

* **TBB URL** for generating gameplay sessions and fetching games and providers
* **Brand ID**
* **Secret key**, used for generating the API token and signing requests (HASH)
* **Wallet URL** – *you*, as the operator, must provide this URL to TBB

To receive the required credentials, please contact us at[ info@thebetbrothers.com.](mailto:info@thebetbrothers.com) Our technical integrations team will guide you through the setup process.

## Request Signing with HMAC-SHA256

All request bodies must be signed using **HMAC-SHA256** with your secret key. The signature must be included in the `X-REQUEST-SIGN` header of the request.

<figure><img src="/files/uaVPpU1HbcDhuLI6SBBE" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://the-bet-brothers.gitbook.io/doc/operator-api/operator-integration-service.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.