Acknowledgement Messages

Source		Destination
Client	→	MTS

Please note that acknowledgement messages are expected to be received in a predefined period to be processed by the MTS service. (Default acceptance period is 10 seconds).

Envelope and Content table:

The envelope provides the Content's (Acknowledgement messages) context and contains the following fields (besides Content):

• operatorId

• correlationId

• timestampUtc

• operation

• version

Example	Field Name	Field Description	Mandatory/ Optional	Data Type
{
"operatorId": 9985,	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": "623dHlyMq82",	correlationId	Client defined string to facilitate the request-response pairing, Sportradar is obliged to return the same string in every response	M	String
"timestampUtc": 1678357235000,	timestampUtc	Timestamp of ticket placement as submitted by the client (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000	M	Integer
"operation": "ticket-placement-ack",	operation	In case of Acknowledgement messages - enumerator: "ticket-placement-ack" "ticket-cancel-ack" "ticket-cashout-ack" "ticket-ext-settlement-ack"	M	String
"version": "3.0"	version	Indicates the ticket format version	M	String
}

Content object (Acknowledgement message)

This object constitutes the message itself and includes the following fields:

• type

• cancellationId or cashoutId or settlementId (depends on acknowledgement message type)

• ticketId

• ticketSignature (or cancellationSignature or cashoutSignature or settlementSignature - depends on acknowledgement message type)

• acknowledged

Example	Field Name	Field Description	Mandatory/ Optional	Data Type
"content": {				Object
"type": "cancel-ack",	type	Declaration of content type, enumerator: ticket-ack cancel-ack cashout-ack ext-settlement-ack Type relates to envelope's "operation" field	M	String
"cancellationId": "CANC_2126",	cancellationId or cashoutId or settlementId	Not included if "type": "ticket-ack", if "type"= "cancel-ack"→ cancellationId, "type": "cashout-ack" → cashoutId, "type": "ext-settlement-ack" → settlementId	M only if "type"= "cancel-ack", or "type"= "cashout-ack" or "type"= "ext-settlement-ack"	String
"ticketId": "Ticket_343243827",	ticketId	ID of original ticket	M	String
"cancellationSignature": "HHDut7XIEl+SmjWB3x DB0AIB6fUZVFOvmGKm6Rcvxm0=",	ticketSignature (or cancellationSignature or cashoutSignature or settlementSignature)	Signature from MTS's response, "type": "ticket-ack" → ticketSignature, "type": "cancel-ack" → cancellationSignature, "type": "cashout-ack" → cashoutSignature, "type": "ext-settlement-ack" → settlementSignature	M	String
"acknowledged": true	acknowledged	Acknowledgement outcome	M	Boolean
}