Responsible Gaming Requests
Client
→
MTS
Responsible gaming requests include the following specific requests:
Account Limit Inform Request provides information information whenever there is a change in a player's financial or session limits. The information includes elements such as: end customer identification, the type of limit that is being changed, the frequency it applies to as well as the amount and currency of the limit. The information ensures that all updates to the player's financial and session boundaries are accurately recorded.
Limit Reached Inform Request provides information whenever a player hits their set limit. The information includes elements such as: end customer identification and the type of limit that has been reached. The information ensures that all instances of players reaching their limits are accurately recorded.
Account Status Inform Request provides information whenever there is either an automatic or manual change in a player's account status. The information includes elements such as: end customer identification, the new account status, the duration of the status (if applicable), the initiator of the status change, reason for the change and relevant dates. The information ensures that all updates to the player's account status are accurately recorded.
Intervention Inform Request provides information whenever an intervention is triggered based on Bettor Sense's provided risk scores. The bookmaker performs the intervention for a specific end customer with the aim of promoting safer gaming practices and the use of responsible gaming tools. Various intervention methods include pop-ups, RG messaging, emails, limit updates, care calls, or other methods. The information includes elements such as end customer identification, the intervention method used, and whether the intervention was initiated by the model.
Envelope and Content table:
The Envelope provides the content's context and contains the following fields (besides Content):
operatorId
correlationId
timestampUtc
operation
version
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
See Content object description below
M
Object
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
Timestamp of transaction placement as submitted by the client (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000
M
Integer
operation
Declaration of operation type, should be "account-limit-inform" in the case of an Account Limit Inform Request or
"account-limit-reached-inform" in the case of a Limit Reached Inform Request or
"account-status-inform" in the case of an Account Status Inform Request or
"account-intervention-inform" in the case of an Intervention Inform Request
M
String
version
Indicates the ticket format version
M
String
}
Content object
The following tables describe the fields of each of the four different types of Responsible Gaming requests.
Account Limit Inform content object consists of the following fields:
type
endCustomer
limit
Object
type
Declaration of content type, should be "account-limit-inform" in the case of an Account Limit Inform Request
M
String
endCustomer
Data about client's end customer (bettor)
M
Object
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
End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$
O
String
limit
M
Object
type
Enumerator that defines the type of the account limit:
deposit
stake
loss
session
M
String
period
Not present if "type": "session",
enumerator that defines the frequency of the account limit:
daily
weekly
monthly
M
Not M if "type": "session"
String
duration
Only present if "type": "session",
duration of the session limit in minutes.
minumum 0, maximum 2147483647
M
Only if "type": "session"
Integer
amount
Not present if "type": "session",
amount of the account limit set by the end-user,
nullable, if null (or the amount object is not present), it means the end-user has removed their limit
M Not M if "type": "session"
Object
value
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
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
Limit Reached Inform content object consists of the following fields:
type
endCustomer
reachedLimit
Object
type
Declaration of content type, should be "account-limit-reached-inform" in the case of a Limit Reached Inform Request
M
String
endCustomer
Data about client's end customer (bettor)
M
Object
id
End customer's unique ID (in the client's system). It should be an anonymous value that 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
End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$
O
String
reachedLimit
Enumerator that defines which type of limit was reached:
deposit
stake
loss
session
M
String
Account Status Inform content object consists of the following fields:
type
endCustomer
status
initiator
duration
reason
periodStartUtc
periodEndUtc
Object
type
Declaration of content type, should be "account-status-inform" in the case of a Account Status Inform Request
M
String
endCustomer
Data about client's end customer (bettor)
M
Object
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
End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$
O
String
status
Enumerator that defines the customer's new status:
active
disabled
excluded
M
String
initiator
Enumerator that defines who initiated the new status:
operator
regulator
player
other
O
String
duration
Enumerator that defines the duration of the new status:
temporary
permanent
O
String
reason
Reason for the status change. Mandatory if initiator is "other".
may be null, min length: 1, max length 128
O
String
periodStartUtc
Timestamp of the start of the new status (Unix time in milliseconds format), minimum: 1, maximum: 9223372036854776000
M
Integer
periodEndUtc
Timestamp of the end of the new status. Should be Non-null for temporary status changes.
(Unix time in milliseconds format), minimum: 1, maximum: 9223372036854776000
O
Integer
Intervention Inform content object consists of the following fields:
type
endCustomer
method
modelInitiated
comment
Object
type
Declaration of content type, should be "account-intervention-inform" in the case of an Intervention Inform Request
M
String
endCustomer
Data about client's end customer (bettor)
M
Object
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
End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$
O
String
method
Enumerator that defines which intervention method was used:
pop-up
rg-messaging
email
limits-update
care-call
other
M
String
modelInitiated
Indicates if the intervention was initiated by the Bettor Sense's risk score.
O
Boolean
comment
Optional intervention comment that provides additional context to the intervention.
minimal string length = 1, maximum length = 128
O
String
Last updated
Was this helpful?