Casino Sessions Request
Client
→
MTS
This request contains information about online gaming events and their outcomes. The information includes elements such as: end customer identification, channel, game type, game provider, game progress, stake, payout, timestamps, etc. The data collected helps MTS maintain a profile of the end customer, which in turn enables MTS's clients to conduct automated marketing campaigns, analyse their services, manage end customer churn and more.
Envelope and Content table:
The Envelope provides the content's (Casino sessions request) context and contains the following fields (besides Content):
operatorId
correlationId
timestampUtc
operation
version
{
"operatorId": 10234,operatorId
ID to uniquely identify the client from which the ticket originated, ID is provided to the client by Sportradar, The client is obliged to include it in every ticket
M
Integer
"content": {content
See Content object description below
M
Object
...........
...........
},
"correlationId": "kL20vAyh",correlationId
Client defined string to facilitate the request-response pairing, Sportradar is obliged to return the same string in the corresponding response
M
String
"timestampUtc": 1703852995000,
timestampUtc
Timestamp of ticket placement as submitted by the client (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000
M
Integer
"operation": "casino-sessions-inform",operation
Declaration of operation type, should be "casino-sessions-inform" in the case of a Casino sessions request
M
String
"version": "3.0"version
Indicates the ticket format version
M
String
}
Content object (Casino sessions request)
This object constitutes the ticket itself and contains the following fields:
type
reportId
sessions (array)
context
Content object table:
"content": {
Object
"type": "casino-sessions-inform",type
Declaration of content type, should be "casino-sessions-inform" in the case of a Casino sessions request
M
String
"reportId": "Report_862801",reportId
Client defined string to identify the report (unique in the client's system), minimal string length = 1, maximum string length = 128
O
String
"sessions": [sessions
See description, minimal number of sessions (array elements) per content (request) = 1, maximum number = 50
M
Array
...............
...............
],
"context": {context
Additional information related to the request
M
Object
"channel": {channel
Specifies the means of delivery of service to client's end customers (bettors), also called distribution channel
M
Object
"type": "mobile",type
Declaration of channel type, enumerator:
agent
call-centre
internet
mobile
mobile-app
phone (used for USSD betting - USSD is a communication protocol in mobile networks)
retail
sms
terminal
tv-app
M
String
"ip": "109.74.24.155",ip
IP address of the end customer's device
May be present only if "type": "internet" or "type": "mobile" or "type": "mobile-app" or "type":" tv-app"
M
if "type": "internet" , "type": "mobile" , "type": "mobile-app" , "type":" tv-app"
String
"deviceId": "device_133123",deviceId
ID of the end customer's device
May be present only if "type": "mobile" or "type": "tv-app" or "type": "internet" or "type": "retail" or "type": "sms"
Minimal string length = 1, maximum length = 36, allowed characters : uppercase and lowercase letters, numerals, #, :, -, _, \ Java regex: ^[0-9A-Za-z#:\\-_]{1,36}$
O
String
"shopId": "shop_789135",shopId
ID of the shop
May be present only if "type": "retail" or "type": "terminal"
Minimal string length = 1, maximum length = 36, allowed characters : uppercase and lowercase letters, numerals, #, :, -, _, \
M if "type": "retail" or "type": "terminal"
String
"terminalId": "term_2313",terminalId
May be present only if "type": "terminal"
Minimal string length = 1, maximum length = 36, allowed characters : uppercase and lowercase letters, numerals, #, :, -, _, \
M if "type": "terminal"
String
"lang": "ES" lang
End customer's user interface language code according to ISO 639-1 (string length = 2)
May be present only if "type": "internet" or "type": "mobile" or "type": "mobile-app" or "type": "terminal" or "type": "tv-app"
M
if "type": "internet" , "type": "mobile" , "type": "mobile-app" , "type": "terminal" , "type": "tv-app"
String
},
"endCustomer": {endCustomer
Data about client's end customer (bettor), it can only be omitted if the bet is placed by an unregistered bettor in retail or on a terminal
M
Object
"id": "endCustomer_e34t45",id
End customer's unique ID (in client's system). It should be an anonymous value which cannot be used to identify a physical person. minimal string length = 1, maximum length = 36, allowed characters are : uppercase and lowercase letters, numerals, #, :, -, _, \ Java regex: ^[0-9A-Za-z#:\\-_]{1,36}$
M
String
"confidence": "1.15"confidence
End customer's suggested CCF Java regex: ^\\d{1,8}(\\.\\d{1,8})?$
O
String
},
"walletId": Wallet_67209walletId
Client defined string to identify the wallet (ID or type), minimal string length = 1, maximum string length = 128
O
String
}
},
Sessions array
Sessions array elements convey information about the actual casino sessions. They consist of the following fields:
id
game
startUtc
endUtc
spins
stake
payout
Sessions array table:
"sessions": [
Array of casino sessions, minimal number of elements per content (request) = 1, maximum number = 50
M
Array
{
"id": "Session_21018993",id
Unique casino session id (in the client's system), minimal string length = 1, maximum length = 128
O
String
"game": {game
M
Object
"id": "Game_TZU345",id
Unique casino game id (in the client's system), minimal string length = 1, maximum length = 128
M
String
"provider": "PR_008"provider
Casino game provider identifier (in the client's system), minimal string length = 1, maximum length = 128
M
String
},
"startUtc": 1703845795000,startUtc
Timestamp of start of the game (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000
O
Integer
"endUtc": 1703845825000,endUtc
Timestamp of end of the game (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000
O
Integer
"spins": [spins
Array of casino game spins, minimal number of spins per session =1, maximum number = 5
O
Array
{
"type": "ordinary",type
Spin type, enumerator:
ordinary
bonus
M
String
"count": 3,count
M
Integer
"winningCount": 1winningCount
O
Integer
}
],
"stake": [stake
Array of session stakes, minimal number of stakes per session =1, maximum number = 5
M
Array
{
"type": "cash",type
Stake type, enumerator:
cash (used for stake and payout)
bonus (amount added on top of end customer's winnings in case a bet is won )
M
String
"currency": "DKK",currency
Currently MTS does not support multiple sessions with stakes in different currencies,
See description
M
String
"amount": "12",amount
See description
M
String
"mode": "total",mode
Stake mode enumerator (default = total):
unit - stake amount relates to each sub-bet (a sub-bet is one combination (in case of system bets))
total - stake amount relates to all sub-bets (each sub-bet receives a portion of the amount)
O
String
"traceId": "Source_2099"traceId
A string to help identify the source of operation/action/state
Minimal string length = 1, maximum length = 128,
O
String
}
],
"payout": [ payout
Session payout array, minimal number of payouts per session =1, maximum number = 5
M
Array
{
"type": "cash",type
Enumerator:
cash
withheld
M
String
"currency": "EUR",currency
3 or 4 letter currency code, BTC and mBTC are also supported (4 letters only apply to mBTC). For more details please check https://www.iso.org/iso-4217-currency-codes.html
M
String
"amount": "100",amount
String pattern: 1 up to 8 digits, optionally followed by a decimal point and 1 up to 8 digits, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$
M
String
"traceId": "Source_2099"traceId
A string to help identify the source of operation/action/state
Minimal string length = 1, maximum length = 128,
O
String
}
]
}
],
Last updated
Was this helpful?