Responsible Gaming Requests

Source

Destination

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.

Note

Although not included in the Responsible Gaming requests, the Deposit Inform and Withdrawal Inform requests are also instrumental to Bettor Sense and should therefore be sent as part of the Bettor Sense integration update. Similarly, as part of the Bettor Sense integration, the client should also send its betting tickets, either as tickets to be validated by MTS ("ticket-placement" operation, described in Ticket Placement Request ), or as tickets without validation ("ticket-placement-inform" operation, described in Pre-validated Ticket Placement Request ).

This data helps Bettor Sense maintain a more accurate risk profile of the end customer, which in turn enables Bettor Sense's clients to conduct more effective customer interventions, analyse the effect of their actions, manage their RG policies and more.

Envelope and Content table:

The Envelope provides the content's context and contains the following fields (besides Content):

operatorId
correlationId
timestampUtc
operation
version

Example

Field Name

Field Description

Mandatory/ Optional

Data Type

  "operatorId": 19036,

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

Integer

  "content": {

content

See Content object description below

Object

       ...........

       ...........

},

  "correlationId": "bhwL37b1",

correlationId

Client defined string to facilitate the request-response pairing, Sportradar is obliged to return the same string in the corresponding response

String

  "timestampUtc": 1739271971000,

timestampUtc

Timestamp of transaction placement as submitted by the client (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000

Integer

  "operation": "account-limit-inform",

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

String

  "version": "3.0"

version

Indicates the ticket format version

String

}

Content object

The following tables describe fields of each of the four different types of Responsible Gaming request.

Account Limit Inform content object consists of the following fields:

type
endCustomer
limit

Example

Field Name

Field Description

Mandatory/ Optional

Data Type

"content": {

Object

    "type": "account-limit-inform",

type

Declaration of content type, should be "account-limit-inform" in the case of an Account Limit Inform Request

String

    "endCustomer": {

endCustomer

Data about client's end customer (bettor)

Object

        "id": "endCustomer_e34t45",

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}$

String

        "confidence": "1.15"

confidence

End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$

String

},

    "limit": {

limit

Object

       "type": "stake",

type

Enumerator that defines the type of the account limit:

deposit
stake
loss
session

String

       "period": "daily",

period

Not present if "type": "session",

enumerator that defines the frequency of the account limit:

daily
weekly
monthly

Not M if "type": "session"

String

       "duration": 20,

duration

Only present if "type": "session",

duration of the session limit in minutes.

minumum 0, maximum 2147483647

Only if "type": "session"

Integer

       "amount": {

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": "1890.05",

- 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})?$

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

String

Limit Reached Inform content object consists of the following fields:

type
endCustomer
reachedLimit

Example

Field Name

Field Description

Mandatory/ Optional

Data Type

"content": {

Object

    "type": "account-limit-reached-inform",

type

Declaration of content type, should be "account-limit-reached-inform" in the case of a Limit Reached Inform Request

String

     "endCustomer": {

endCustomer

Data about client's end customer (bettor)

Object

         "id": "endCustomer_e34t45",

String

         "confidence": "1.15"

confidence

End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$

String

},

     "reachedLimit": "stake"

reachedLimit

Enumerator that defines which type of limit was reached:

deposit
stake
loss
session

String

Account Status Inform content object consists of the following fields:

type
endCustomer
status
initiator
duration
reason
periodStartUtc
periodEndUtc

Example

Field Name

Field Description

Mandatory/ Optional

Data Type

"content": {

Object

    "type": "account-status-inform",

type

Declaration of content type, should be "account-status-inform" in the case of a Account Status Inform Request

String

    "endCustomer": {

endCustomer

Data about client's end customer (bettor)

Object

        "id": "endCustomer_e34t45",

String

        "confidence": "1.15"

confidence

End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$

String

},

    "status": "active",

status

Enumerator that defines the customer's new status:

active
disabled
excluded

String

    "initiator": "player",

initiator

Enumerator that defines who initiated the new status:

operator
regulator
player
other

String

    "duration": "permanent",

duration

Enumerator that defines the duration of the new status:

temporary
permanent

String

    "reason": "Bettor initiated action",

reason

Reason for the status change. Mandatory if initiator is "other".

may be null, min length: 1, max length 128

String

    "periodStartUtc": 1703869950000,

periodStartUtc

Timestamp of the start of the new status (Unix time in milliseconds format), minimum: 1, maximum: 9223372036854776000

Integer

    "periodEndUtc": 1703917850000

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

Integer

Intervention Inform content object consists of the following fields:

type
endCustomer
method
modelInitiated
comment

Example

Field Name

Field Description

Mandatory/ Optional

Data Type

"content": {

Object

    "type": "account-intervention-inform",

type

Declaration of content type, should be "account-intervention-inform" in the case of an Intervention Inform Request

String

    "endCustomer": {

endCustomer

Data about client's end customer (bettor)

Object

         "id": "endCustomer_e34t45",

String

         "confidence": "1.15"

confidence

End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$

String

},

    "method": "pop-up",

method

Enumerator that defines which intervention method was used:

pop-up
rg-messaging
email
limits-update
care-call
other

String

    "modelInitiated": true,

modelInitiated

Indicates if the intervention was initiated by the Bettor Sense's risk score.

Boolean

    "comment": "Testing purpose"

comment

Optional intervention comment that provides additional context to the intervention.

minimal string length = 1, maximum length = 128

String

PreviousPayment Responses NextResponsible Gaming Responses

Last updated 4 months ago

Was this helpful?