Cancellation Response
Client
←
MTS
Envelope and Content table:
The envelope provides the Content's (Cancellation response) context and contains the following fields (besides Content):
correlationId
timestampUtc
operation
version
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 every response
M
String
timestampUtc
Timestamp of ticket placement as submitted by the client (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000
M
Integer
operation
Declaration of ticket content type, should be "ticket-cancel" in case of Cancellation response
M
String
version
Indicates the ticket format version
M
String
}
Content object (Cancellation response)
The Content object includes the following fields:
type
cancellationId
signature
status
ticketId
code
message
Please note that in the case of major ticket errors or internal system errors, the content object has a different structure and contains "type": "error-reply" instead of "type": "cancel-reply. For description, see Error-reply Response.
Content object table:
Object
type
Declaration of the content type, should be "cancel-reply" in the case of Cancellation response
or "error-reply" in the case of major ticket errors or internal system errors (see also Error-reply Response).
M
String
cancellationId
ID from the corresponding request, minimal string length = 1, maximum string length = 128
O
String
signature
String calculated and sent by MTS to be used as a proof that the response has actually been provided by MTS, minimal string length = 1, maximum string length = 128
M
String
status
Request outcome, enumerator:
accepted
rejected
M
ticketId
ID of the initial ticket (defined by client) which is to be affected with this cancellation
M
String
code
Cancellation response code, see list of codes below
M
Integer
message
Readable ticket response validation code, minimal string length = 1, maximum string length = 128
O
}
Cancellation response codes
For general validation codes , please refer to Validation codes.
Transaction processed
Ticket not found
Client (bookmaker) not found
Cannot be cancelled because ticket contains live selection
Ticket time for cancellation expired
Cannot be cancelled because ticket contains pre-match selection
Cannot be cancelled because particular cancellation option is not active
Cannot be cancelled because ticket is already settled
Cannot be cancelled because ticket is already cancelled
Cancel factor is out of bounds (when the cancellation factor is outside the allowed range of 0-100%)
Cancel factor is lower than existing (when the cancellation factor is lower than the previous one)
Cannot be cancelled because bet id was not found
Ticket already settled manually
Cannot be cancelled because ticket contains inactive market
Cannot be cancelled because code is not compatible with partial cancellation
Generic exception code
Last updated
Was this helpful?