...
Property | Type | Required | Explanation | Comments |
id | string (50) | Required | A unique identifier for the bet. It needs to be unique for the entire service per bookmaker. | When using Risk Services with Bet Assessment, make sure that both use the same bet identifier. |
betPlacedTimestampUTC | DateTime | Required | UTC Timestamp of when the bet was placed . | Please use the format "yyyy-MM-ddTHH:mm:ss.ffffZ". Details are here. Initial value should stay the same for every other update. |
betUpdatedTimestampUTC | DateTime | Required | UTC Timestamp of the change trigger, i.e. when the bet data changed. | Determines whether this call is the latest state for the Bet, based on existing data. Please use the format "yyyy-MM-ddTHH:mm:ss.ffffZ". Details are here. |
bookmakerName | string (50) | Required | Name of the bookmaker | |
playerId | string (50) | Required | A unique identifier for the player placing the bet. |
|
totalStake | decimal | Required | The total stake of the bet. | This must only contain the original stake of the bet. In the case of Cash Out or Partial Cash Out, please update the cashedOutTotalStake and cashedOutAmount properties. |
currencyCode | string (3) | Required | The ISO 4217 code of the stake’s currency | The currency of the stake. |
systemBetType | string (50) | Optional | Identifies the type of the System Bet, see Appendix A: Supported System Bet Types definitions for a list of supported system bet types. A required field for system bets. This should be empty for Single/Multi bets. | If the bet has multiple legs and this field is not populated, we assume this bet is a Multi Bet. Please, also check the Appendix B: Fallback scenarios to define a bet type for liability calculations section below. |
priority | number | Optional | The priority with which a bet should be processed. Can be 1 (High Priority) or 2 (Low Priority) . | This is used to route messages into a high-priority processing queue. The bookmaker determines which bets are high-priority, and passes the priority into the API. If not supplied, defaults to low priority. |
legs | An array of Leg (see below) | Required | Details of the bet. |
|
status | string (50) | Required | Current status of the bet. Supported values: ["Open"/"Settled"/“Cancelled“] | “Open” represents a bet with any legs that are currently Open. “Settled” is when all legs have been settled. “Cancelled” is when the whole bet is cancelled. If the bet has been fully cashed-out, you should set the bet status to “Settled”. If the bet has only been partially cashed-out, you should set the bet status to “Open”. |
cashedOutTotalStake | decimal | Optional | The amount of the original total stake that has been /wiki/spaces/GSG/pages/1311607730. | For example, if the cashedOutTotalStake is 20.00 and the original totalStake was 80.00, then 20.00 of the original 80.00 was cashed out. Therefore, the currently remaining total stake of the bet is 60.00. A bet may be partially cashed out one or more times, and the cashedOutTotalStake must be the cumulative value. |
cashedOutAmount | decimal | Optional | The total amount paid out for the /wiki/spaces/GSG/pages/1311607730 total stake. | |
payout | decimal | Optional | The total settlement amount of all legs. A required field for fully settled and fully cancelled bets. | Only sent upon bet settlements, so not required in the contract. Let's say that there is a Multi bet with 3 legs: A, B, C. Each leg is resulted at different times since the majority of the fixtures finish at different times. So, let's say that leg B was resulted as a loser. Then the entire bet is a loser, and Legs A and C would probably not be resulted by a settlement engine. Until a bet has lost legs, all won legs are going to be settled. Let's assume that leg A had a price of 1.20, leg B had a price of 2.0, and leg C had a price of 3.0, and the player bets 10 EUR. If the entire bet wins fully, the player would get 1.20 * 2 * 3 = 7.2 → 72. Therefore the payout field should be set to 72. When the whole bet is cancelled (“Bet Status” = “Cancelled”) then “Payout” should be equal to initial Stake of the bet. |
...