Pre-validated Ticket Placement Response

Destination
Source

Client

MTS

Ticket structure

The Pre-validated ticket placement response, like any other ticket, consists of the envelope and content.

The content part represents the ticket itself and is included in the Content object. Its most complex part, the BetDetails array, is described in a separate table below.

Envelope and Content table:

The Envelope provides the content's (Pre-validated ticket placement response) context and contains the following fields (besides Content):

  • correlationId

  • timestampUtc

  • operation

  • version

Example
Field Name
Field Description
Mandatory/ Optional
Data Type
{

  "content": {
       ...........
       ...........
   },    

content

See Content object description below

M

Object

  "correlationId": "62ka01mxre",

correlationId

Same string as submitted by the client in the Pre-validated ticket placement request

M

String

  "timestampUtc": 1689752904000,

timestampUtc

Timestamp of the response placement (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000

M

Integer

  "operation": "ticket-placement-inform",

operation

Should be "ticket-placement-inform" in the case of a Pre-validated ticket placement response

M

String

  "version": "3.0"

version

Indicates the ticket format version

M

String

}

Content object (Pre-validated ticket placement response)

The Content object includes the following fields:

  • type

  • signature

  • status

  • ticketId

  • code

  • message

  • betDetails

  • exchangeRate

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": "ticket-reply. For description, see Error-reply Response.

Content object table

Example
Field Name
Field Description
Mandatory/ Optional
Data Type
  "content": {

Object

      "type": "ticket-inform-reply",

type

Declaration of the content type, should be "ticket-inform-reply" in the case of a Pre-validated ticket placement response

or "error-reply" in the case of major ticket errors or internal system errors (see also Error-reply Response).

M

String

      "signature": "gOxOcWAjiPn8hEjyPlzDY
u0B7aNA85fOeAB8m1j+Wm0=",

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

status

Suggestion on ticket acceptance, provided by MTS, enumerator:

  • accepted

  • rejected

M

String

      "ticketId": "Ticket_10150",

ticketId

Used to identify the ticket that this response relates to, minimal string length = 1, maximum string length = 128

M

String

      "code": 0,

code

Ticket response validation code (the main reason the ticket has eventually been rejected), see list of validation codes

M

Integer

      "message": "Transaction processed",

message

Readable ticket response validation code, minimal string length = 1, maximum string length = 128 (example is shortened)

O

String

      "betDetails":   [
         ........
         ........
         ],

betDetails

Code and message fields in the betDetails array indicate potential errors in the requested bet in the Pre-validated ticket placement request. For syntax, see the betDetails array description.

O

Array

      "exchangeRate":   [

exchangeRate

MTS has a system currency (used for defining liability limits etc.), this rate was used at ticket acceptance time when converting the actual bet currency to the MTS system currency

O

Array

          { 
            "fromCurrency": "USD",
  • fromCurrency

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

            "toCurrency": "EUR",
  • toCurrency

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

            "rate": "1.07326"
           }
       ]
  },          
  • rate

Non-system currency unit per one system currency unit, 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

Last updated

Was this helpful?