Skip to content

Frequently asked questions

Sportsbook Integration

What is the minimum integration setup needed to go live?

For minimum setup, you need:

Optional integrations include:

What is required from the partner so that DATA.BET can check the integration (pre-prod testing)?

In order for us to check your integration on our end, please make sure:

  1. You have finished the minimum integration setup from the previous question and deployed it into a pre-prod environment.
  2. You have created a user with a positive balance so that we can check bets and verify that their balance updates correctly in response to bets.
  3. All the callbacks are processed idempotently: for instance, if the same callback has been initiated two or more times, it must be processed only once.
  4. The integrated functionality fits well in your website visually.

Do all events received within callback server have the same format for different sports?

Yes, all callbacks use the same data format regardless of the sport. The callback structure, field names, and data types remain consistent across all sports (including esports).

Are there any sports where additional callbacks are sent?

No, all callbacks have the same format for all sports.

What W3C format does the system use?

We use the ISO 8601 standard for representation of dates and times (e.g. 2023-09-02T13:48:20.076Z).

What is the abbreviation of SPA?

A single-page application can be described as a synonym for our iFrame solution. Details: SPA.

How should we integrate your SPA into our SPA solution?

When the user leaves the betting page, you need to call the bettingAPI.destroy() method. When currency/locale or isAuthorized state updates, you need to re-generate the token and call bettingAPI.updateBettingOptions().

Is it possible to integrate switcher dark/light mode?

Yes, since the theme configuration is stored on your side, you can call bettingAPI.updateThemeConfig() method when the user switches theme.

Token

What is a token's expiration time?

Currently, there is no ttl (time to live), but you can configure this parameter on your website if required.

Should a new token be created with every page render?

This isn't mandatory; you can store the token on your end and delete it when clearing your session for faster page loading. In this case, regenerating it for each page render is also acceptable.

Should a new token be generated per new user, or per new session?

Each unique logged-in user must have their own token. We recommend that you generate a token either for each page opening for a logged-in user or for a session.

You can also generate a common guest token for non-logged-in users as well. But you should update the common token when you need to change some user's session parameters, like currency, language etc. For security reasons, we also recommend updating the common token at least once every hour.

Bets

What should be done if the user had already withdrawn money, but the decline callback was received?

According to /bet/decline callback specification it could be sent only after /bet/place callback. So, you must hold the money on the balance on /bet/place callback, and it will prevent the money withdrawal by the user.

When is the bet finally settled?

The bet is settled, as soon as all markets of the bet acquire the Settled status.

Do you provide opportunity to check full bet flow?

Sure, you can test bets with our assistance. Please feel free to reach out to your integration manager, and they will help you run a bet through different statuses.

What are the minimum and maximum stakes you suggest to be set?

The minimum bet amount is $0.5. The maximum bet depends on the tournament settings on our side, specifically the maxBet parameter. Our risk management team can also limit the maximum bet if they find it appropriate based on the match, tournament, and other data.

Is it possible to render the bet history in the client's admin backoffice?

Yes, for that purpose you can use Bet Actions API.

Is it possible to cancel some specific bet from the client side?

Yes, for that purpose you can use Bet Actions API.

Cash Out

When is the feature available to the player?

Cash out is available for the player from the moment the bet is placed until the bet is settled. However, cash out availability could be limited and can be configured per sport, match phase, and markets per your request to our Trading Support.