Payment Requests

Source		Destination
Client	→	MTS

Payment requests include the following specific requests:

• Balance change request - provides information about any changes to the end customer's wallet balance

• Deposit request - provides information about a deposit to a wallet (increase of the end customer's wallet balance)

• Withdrawal request - provides information about a withdrawal from a wallet (decrease of the end customer's wallet balance)

This data helps MTS maintain a profile of the end customer, which in turn enables MTS's clients to conduct automated marketing campaigns, analyse their services, manage end customer churn 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	M	Integer
"content": {	content	See Content object description below	M	Object
...........
...........
},
"correlationId": "3l1qH8e3",	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":1703858850000,	timestampUtc	Timestamp of ticket placement as submitted by the client (Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000	M	Integer
"operation": "balance-change-inform",	operation	Declaration of operation type, should be "balance-change-inform" in the case of a Balance change request or "balance-deposit-inform" in the case of a Deposit request or "balance-withdrawal-inform" in the case of a Withdrawal request	M	String
"version": "3.0"	version	Indicates the ticket format version	M	String
}

Content object (Payment requests)

This object constitutes the request itself and contains the following fields:

• type

• balanceChangeId (or depositId or withdrawalId)

• walletId

• endCustomer

• status

• gateway

• amount

• initiatedAtUtc

• executedAtUtc

• source

Content object table:

Example	Field Name	Field Description	Mandatory/ Optional	Data Type
"content": {				Object
"type": "balance-change-inform",	type	Declaration of content type, should be "balance-change-inform" in the case of a Balance change request or "deposit-inform" in the case of a Deposit request or "withdrawal-inform" in the case of a Withdrawal request	M	String
"balanceChangeId": "BC_117281",	balanceChangeId or depositId or withdrawalId	Client defined string to identify the transaction type: "balanceChangeId" in the case of a Balance change request or "depositId" in the case of a Deposit inform request or "withdrawalId" in the case of a Withdrawal inform request, minimal string length = 1, maximum length = 36, allowed characters : uppercase and lowercase letters, numerals, :, -, _, \ Java regex: ^[0-9A-Za-z:\\-_]{1,36}$	M	String
"walletId": Wallet_38209,	walletId	Client defined string to identify the wallet (ID or type), minimal string length = 1, maximum string length = 128	O	String
"endCustomer": {	endCustomer	Data about client's end customer (bettor)	M	Object
"id": "endCustomer_e34t45",	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": "1.15"	confidence	End customer's suggested CCF, Java regex: ^\\d{1,8}(\\.\\d{1,8})?$	O	String
},
"status": "approved",	status	Enum: approved rejected pending cancelled	M	String
"gateway":  {	gateway	Not included if "type": "balance-change-inform"	O	Object
"provider": "PROVIDER_00345",	provider	Client specific gateway provider identifier, Minimal string length = 1, maximum length = 36, allowed characters : uppercase and lowercase letters, numerals, :, -, _, \ Java regex: ^[0-9A-Za-z:\\-_]{1,36}$	M	String
"referenceId": "2387321",	referenceId	Client specific gateway reference ID, Minimal string length = 1, maximum length = 36, allowed characters : uppercase and lowercase letters, numerals, :, -, _, \ Java regex: ^[0-9A-Za-z:\\-_]{1,36}$	M	String
"method": "credit-card",	method	Enum: credit-card	M	String
"initiatedAtUtc": 1703858776000,	initiatedAtUtc	(Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000	O	Integer
"executedAtUtc": 1703858780000	executedAtUtc	(Unix time in milliseconds format), minimal: 1, maximum: 9223372036854776000	M	Integer
},
"amount": {	amount	Payment amount	M	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})?$	M	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	M	String
},
"initiatedAtUtc": 1703858775000,	initiatedAtUtc	Not included if "type": "balance-change-inform", Unix time in milliseconds format, minimal: 1, maximum: 9223372036854776000	O	Integer
"executedAtUtc": 1703858780000,	executedAtUtc	Unix time in milliseconds format, minimal: 1, maximum: 9223372036854776000	M	Integer
"source":  {	source	Only included if "type": "balance-change-inform"	M only if "type": "balance-change-inform"	Object
"type": "ticket",	type	Enum: ticket deposit withdrawal	M	String
"id": "SRC_890",	id	Client defined source ID, minimal string length = 1, maximum string length = 128	M	String
"action": "place"	action	Only included if "type": "ticket", Enum: place payout	M only if "type": "ticket"	String
}
}
},