Skip to content

Frequently asked questions

Sportsbook Betting API

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

Yes, the data format is the same for all sports. Details:

Are there sports where additional callbacks are sent?

No, all callbacks are same in terms of 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). Details: https://www.rfc-editor.org/rfc/rfc3339.

SPA

What is the abbreviation of SPA?

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

CashOut

What is the cash-out flow?

CashOut has two statuses:

  • Accepted: a bet is placed, a cash-out is initiated, the respective callback bet/cash-out-orders/accepted is sent, and the bet status changes to "settled".
  • Declined: the cash-out hasn't been validated (no callback is sent), or a bet cashout had been accepted, but eventually the bet refund was initiated on our end (for example, due to a technical error). In the latter case, the bet gets refunded manually, and cash-out becomes irrelevant. The respective callback bet/cash-out-orders/declined is sent.

Please refer to Bet Lifecycle → Details → Diagram to check how cash-out works within the full bet cycle.

There is also another flow in which the cash-out is not immediately available to the player because of the restrictions (check the list of restrictions). Depending on the restriction, two options are possible:

  • a player clicks the Cash-out button, and a warning about re-calculation required is displayed in the UI. After the re-calculation the player can initiate the cash-out again. If the restrictions are no longer applicable, the cash-out gets the Accepted status.
  • the cash-out is not available, and the Cash-out button is not even displayed for a player. No callbacks are sent in this scenario.

When is the feature available to the player?

Cash-out is available for the player from the moment the bet is placed within the period when the bet is active (the event has not yet finished).

Bet insurance

Do you provide bet insurance?

Yes, you could find the details in the Bet insurance.

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.

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. And for security reasons we advise you to update the common token every hour at least.

Integration

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 integrated basic bet processing (bet callbacks and heartbeat callbacks implementation) and deployed it into a pre-prod environment.
  2. You have created a user with positive balance for us to check bets and their balance responds to bets correctly.
  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.