Multibet Front-End Integration

Owned by Aleksandr Tihhonjuk
Last updated: Apr 17, 2024 by Polina Lyzenkova


In this document, you’ll find a brief description of the new Multibet widget front-end structure. The multibet widget product is designed to allow bettors to place several bets related to a fixture in pre-match or in-play. Initially, American football and football (soccer) are supported, although the widget is intended to be sport agnostic, small tasks are required to support new sports.

It is intended for bookmakers to implement on their websites offering their users a range of configurable markets per event according to their needs. The Widget allows different customizations such as colors and fonts, which will allow our customers to use their brand properties offering their end users a seamless experience on their site.

Multibet Widget Integration

Our customers should embed the Multibet Widget through an iframe. When a player made his choice and requests a bet, the Multibet Widget will make a call to the customer’s bet slip with all the required data to populate it with the selection details.

The technical information for the front-end integration can be found in the following space - SmartStream Integrations.

Customers that have already integrated with other Fan Engagement products such as betting widgets, Game Trackers, and Scoreboards can re-use the existing iframe implementation for the Multibet Widget.

Reverse Proxy

Customer should setup a reverse proxy to protect from unauthorized access and malicious traffic. The detailed information can be found in https://geniussports.atlassian.net/wiki/spaces/BID/pages/4284776797/Authenticating+User-Session+Using+a+Proxy+Service

Embedding a Multibet Widget

How do I embed a Multibet widget under a specific fixture? 

The Multibet Widget offered by Genius Sports is fixture specific and does not accommodate an event viewer and selector page, therefore it should be embedded under a specific fixture within the Sportsbook page. Using an URL parameter fixtureId which is expecting Genius Sports Fixture Id as a value:

https://gsm-widgets.betstream.betgenius.com/multibet?fixtureId=6102728&productName=[clientName]&culture=es-ES

Other parameters will be required like:

  • Product Name: this is the customer name given by Genius.

  • Culture: is the parameter related to the language preferred.

<iframe src="https://gsm-widgets.betstream.betgenius.com/multibet?fixtureId=6102728&productName=[clientName]&culture=es-ES" width="1180" height="622"></iframe>

Event listener

The customer must have a listener to receive the events that the Multibet Widget will send when the player sends his bet in the "Add to betslip" action.

The following is an example of the structure of these events:


Note: we are transforming the RMC response to this one

{
    "command": "addToBetslip",
    "sportsbookMarketContext": `{"Identifier":"10458-10083737-PreMatch-d73df3b0cab4500a84aa13f1f80d91d6","SportsBookFixtureId":"10083737","MarketId":"100263079","SportsBookId":"10458","SportsBookMarketId":"100263079","SportsBookContext":"10458-10083737-PreMatch-d73df3b0cab4500a84aa13f1f80d91d6","ErrorCode":200,"ErrorMessage":"OK","TimeStampUtc":"2023-05-24T20:43:25.1624406Z","ConsumerFixtureId":10083737,"IsOfferedOnSite":true}"`, "marketId": "100120022",
"sportsbookFixtureId: "10083737", "sportsbookMarketId": "100263079", "decimalPrice": "3.8" }

  • sportsbookFixtureId - customer fixture ID

  • marketId - Genius Sports market ID

  • sportsbookMarketId - customer market ID

  • sportsbookMarketContext - customer market context. This field will be populated only if customer provided it in UpdategramResponse

  • decimalPrice - the price that was displayed in the Multibet Widget when player pressed "Add to betslip" button. This value should NOT be used for bet acceptance

Customer-Based API Authentication Method

Genius SSM AWS must have configured per customer: client_id, client_secret and api-key to be able to get response from Multibet widget

creation secrets path: /fep-platform/widgets/multibet/[clientName]

secret structure :

{
  "x_api_key": "[client_x_api_key]",
  "client_id": "[client_id]",
  "client_secret": "[client_secret]"
}


Configuration in SSM service:

Multibet Widget Customization

Customer can easily customize the look of the Multibet Widget. More details are available on https://geniussports.atlassian.net/wiki/spaces/BID/pages/4284776787/UI+Widget+Customization


Note: Supported minimum sizes for Widget: 300px/560px