MP Online Tombola API

Welcome to the Mobil Proses Online Tombola API docs. Here you'll find comprehensive guide to help you start working with Mobil Proses as quickly as possible. MP Online Tombola Platform offers a two-way HTTP API with JSON as data format, to implement requests and responses for our tombola services. The API has simple interface and is designed for easy integration process.

Introduction

All the data in requests which are made to our API must be sent as JSON

All the data in requests which are made to merchant's API will be sent as POST parameters.

All the data is returned as JSON.

All currencies in requests or responses are based on ISO 4217 - this means: 3 uppercase letters. Examples: USD, EUR, TRY

All countries in requests or responses are based on ISO 3166-1 alpha-2 - this means: 2 uppercase letters. Examples: US, GB, TR

All dates in requests must be in merchant's timezone and formated with: 'yyyy-MM-ddTHH:mm:ss'.

All dates in responses are in merchant's timezone.

Supported languages: tr-TR, en-US (soon).

There two modes for integration : seamless and transfer. For seamless mode you need to implement all functions except: Deposit (Transfer), Withdraw (Transfer) and Get Balance (Transfer). In case of transfer mode, you need to implement all functions except: Bet (Seamless), Win (Seamless), CancelBet (Seamless) and GetBalance (Seamless)

Hash is calculated with this function:

private static string GetSha256(string text)
{
    var utf8Encoding = new UTF8Encoding();
    var message = utf8Encoding.GetBytes(text);

    var hashString = new SHA256Managed();
    var hex = string.Empty;

    var hashValue = hashString.ComputeHash(message);

    return hashValue.Aggregate(hex, (current, bt) => current + $"{bt:x2}");
}

In case of seamless mode, slots use user's currency, 'Bet', 'Win', 'CancelBet' and 'GetBalance'(seamless) calls will contain user's currency. All other products will work in network's currency. 'Bet', 'Win', 'CancelBet' and 'GetBalance'(seamless) calls will contain network's currency.

In case of transfer mode, all products will work in network's currency. 'Deposit', 'Withdraw', 'GetBalance' calls will contain network's currency.

You can download our sample Tombola seamless API (C# & .Net) from given link ...

1.1. Auth

In order to authenticate user, merchant must generate public token and redirect user to "our given link which will be displayed soon here" with parameters listed below. This pubic token must be active during 1 minute on merchant side. All games on desktop devices must be opened in iframe.

Parameters

#	Name	Format	Is Required	Description
1	Token	string	Yes* (Not required when IsFreeplay = 1)	Player's public token
2	MerchantId	int	Yes	Merchant's unique identifier
3	Lang	string	Yes	Player's language
4	GameId	int	Yes*	Game Id (*not required in table games)
5	ProductId	int	Yes	Product Id
6	IsFreeplay	int (1 - yes, 0 - No)	No*	*Works only for slot games
7	Platform	string	Yes	'desktop' or 'mobile'

After that step, we will call Auth function, which will return private token. Most of further communication will happen with this private token.

Start Game Config Parameters

#	Name	Format	Is Required	Description
1	Token	string	Yes* (Not required when IsFreeplay = 1)	Player's public token
2	MerchantId	int	Yes	Merchant's unique identifier
3	Lang	string	Yes	Player's language
4	GameId	int	Yes*	Game Id (*not required in table games)
5	ProductId	int	Yes	Product Id
6	IsFreeplay	int (1 - yes, 0 - No)	No*	*Works only for slot games
7	Platform	string	Yes	'desktop' or 'mobile'
8	IframeContainerId	string	Yes* (if gameOpenType is iframe)	id of html element where iframe will be created
9	IframeId	string	Yes* (if GameOpenType is iframe)	id of iframe which will be created
10	GameOpenType	string (iframe or redirect)	Yes	Game Open Type
11	AuthUrl	string	Yes	Auth website url
12	WindowWidth	int	No	Width of current window. Default is 1280.
13	ResizeWindow	bool	No	If set true, Window will be resized and adjusted for game according to 'WindowWidth' parameter

Example of starting game


<script src="https://gameapi-stage.mobilproses.com/js/GameStarter.js"></script>

<div id="iframeContainer">        </div>
<script>
    var config = {
        "Token": "54D2A7CA-FD87-46D4-A5A0-6BC0372C43EE",
        "MerchantId": 105,
        "Lang": "tr-TR",
        "GameId": 7001,
        "ProductId": 3,
        "IsFreeplay": 0,
        "Platform": "desktop",
        "IframeContainerId": "iframeContainer",
        "IframeId": "gameIFrame",
        "GameOpenType": "iframe",
        "AuthUrl": "https://gameapi-stage.mobilproses.com/auth/auth/",
        "WindowWidth": 1280,
        "ResizeWindow": true
    };

    MobilProses.GameStarter.startGame(config);
</script>
<style type="text/css">
    #gameIFrame {
        width: 100% !important;
        height: 100% !important;
        border: none;
        text-align: center;
        background-color: Black;
    }

    html, body {
        width: 100% !important;
        height: 100% !important;
        margin: 0;
        padding: 0;
    }
</style>

2. Methods

2.1. Auth

Http Method: POST
Url: {URL is defined by merchant}

Parameters

#	Name	Format	Is Required	Description
1	publicToken	string	Yes	Public token

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	PrivateToken	string (Max length 100)	Player's private token (on every request merchant must return new unique token)
2	StatusCode	int	StatusCode

2.2. Deposit

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/wallet/Deposit
Calculating hash: Parameters must be concatenated with | symbol in this order: Amount, Currency, MerchantId, TransactionId, Token, UserId, key . Hash must be generated with SHA 256 algorithm.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	Amount	int	Yes	Amount of money
2	MerchantId	int	Yes	Merchant's unique identifier
3	TransactionId	string (50)	Yes	Merchant's unique identifier for transaction
4	Token	string (100)	Yes	Player's private token (we will call "GetPlayerInfo" function with this token)
5	UserId	string (100)	Yes	Player Id
6	Hash	string	Yes	Hash
7	Currency	string (3)	Yes	Currency

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	TransactionId	string (100)	Transaction Id
3	TransactionDate	datetime	Transaction Date
4	Balance	long	Current Balance

2.3. Withdraw

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/wallet/Withdraw
Calculating hash: Parameters must be concatenated with | symbol in this order: Amount, Currency, MerchantId, TransactionId, Token, UserId, Key . Hash must be generated with SHA 256 algorithm.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	Amount	int	Yes	Amount of money
2	MerchantId	int	Yes	Merchant's unique identifier
3	TransactionId	string (50)	Yes	Merchant's unique identifier for transaction
4	Token	string (100)	Yes	Player's private token (we will call "GetPlayerInfo" function with this token)
5	UserId	string (100)	Yes	Player Id
6	Hash	string	Yes	Hash
7	Currency	string (3)	Yes	Currency

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	TransactionId	string (100)	Transaction Id
3	TransactionDate	datetime	Transaction Date
4	Balance	long	Current Balance

2.4. Get Balance

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/wallet/GetBalance
Calculating hash: Parameters must be concatenated with | symbol in this order: Currency, MerchantId, Token, UserId, Key . Hash must be generated with SHA 256.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	MerchantId	int	Yes	Merchant's unique identifier
4	Token	string (100)	Yes	Player's private token (we will call "GetPlayerInfo" function with this token)
5	UserId	string (100)	Yes	Player Id
6	Hash	string	Yes	Hash
7	Currency	string(3)	Yes	Currency

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	Balance	long	Current Balance

2.5. Bet

Merchant must implement this function to make possible making bets
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: Amount, BetTypeId, CampaignId, CampaignName, Currency, GameId, ProductId, RoundId, Token, TransactionId, TransactionDate, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	token	string (100)	Yes	Player's private token
2	amount	long	Yes	amount of money
3	transactionId	string (100)	Yes	Transaction Id
4	transactionDate	datetime	Yes	Transaction Date
5	betTypeId	int	Yes	Transaction type (See bet types below)
6	gameId	int	Yes	Game Id
7	productId	int	Yes	Product Id
8	roundId	int (64)	Yes	Round Id
9	hash	string	Yes	Hash
10	currency	string (3)	Yes	Currency
11	campaignId	int	No	Id of current campaign
12	campaignName	string (500)	No	Name of current campaign

Bet Types

#	BetTypeId	Name	Description
1	1	Normal	Normal

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	BetTransactionId	string (100)	Beting Transaction Id from merchant's system
3	CurrentBalance	long	Current Balance

2.5.1 ReBet

Merchant must implement this function to make possible making rebet.
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: Amount, BetTypeId, CampaignId, CampaignName, Currency, GameId, ProductId, RoundId, Token, TransactionId, TransactionDate, CancelTransactionId, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	token	string (100)	Yes	Player's private token (from cancelTransactionByRef method must be used)
2	amount	long	Yes	amount of money
3	transactionId	string (100)	Yes	Transaction Id
4	transactionDate	datetime	Yes	Transaction Date
5	betTypeId	int	Yes	Transaction type (See bet types below)
6	gameId	int	Yes	Game Id
7	productId	int	Yes	Product Id
8	roundId	int (64)	Yes	Round Id
9	hash	string	Yes	Hash
10	currency	string (3)	Yes	Currency
11	campaignId	int	No	Id of current campaign
12	campaignName	string (500)	No	Name of current campaign
13	cancelTransactionId	string (100)	Yes	Transaction Id from method cancelBetbyRef

Bet Types

#	BetTypeId	Name	Description
1	1	Normal	Normal

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	BetTransactionId	string (100)	Beting Transaction Id from merchant's system
3	CurrentBalance	long	Current Balance

2.6. Win

Merchant must implement this function to make possible making win requests
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: Amount, CampaignId, CampaignName, Currency, GameId, ProductId, RoundId, Token, TransactionId, TransactionDate, WinTypeId, BetTransactionId, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	token	string (100)	Yes	Player's private token (in case of win you should not check if this token is active, you should check if it exists)
2	amount	long	Yes	amount of money
3	transactionId	string (100)	Yes	Transaction Id
4	transactionDate	datetime	Yes	Transaction Date
5	winTypeId (see win types below)	int	Yes	Transaction type
6	gameId	int	Yes	Game Id
7	productId	int	Yes	Product Id
8	roundId	int (64)	Yes	Round Id
9	hash	string	Yes	Hash
10	currency	string (3)	Yes	Currency
11	campaignId	int	No	Id of current campaign
12	campaignName	string (500)	No	Name of current campaign
13	betTransactionId	string (100)	Yes	Mechant's bet transaction Id

Win Types

#	WinTypeId	Name	Description
1	-1	Lost	Kaybetti
2	0	One Line	1. Çinko
3	1	Two Lines	2. Çinko
4	2	Full House	Tombala
5	3	Jackpot	Jackpot

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	TransactionId	string (100)	Transaction Id in merchant's system
3	CurrentBalance	long	Current Balance

If win request is already processed, merchant must return 201 status code.

2.7. Cancel Bet

Merchant must implement this function to make possible cancelling bets
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: Amount, BetTransactionId, BetTypeId, Currency, GameId, ProductId, RoundId, Token, TransactionId, TransactionDate, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	token	string (100)	Yes	Player's private token (in case of cancelbet you should not check if this token is active, you should check if it exists)
2	amount	long	Yes	amount of money
3	transactionId	string (100)	Yes	Transaction Id
4	transactionDate	datetime	Yes	Transaction Date
5	betTypeId	int	Yes	Transaction type
6	gameId	int	Yes	Game Id
7	productId	int	Yes	Product Id
8	roundId	int (64)	Yes	Round Id
9	hash	string	Yes	Hash
10	currency	string (3)	Yes	Currency
11	betTransactionId	string (100)	Yes	Marchant's bet transaction Id

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	TransactionId	string (100)	Transaction Id in merchant's system
3	CurrentBalance	long	Current Balance

If cancel bet request is already processed, merchant must return 201 status code. If bet does not exist in merchant's system, merchant must return 200 status code.

2.7.1 Cancel Bet by Ref

Merchant must implement this function to make possible cancelling bets. This function also points a bet transaction reusable. Returning transactionId used by reBet function.
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: Amount, BetTransactionId, BetTypeId, Currency, GameId, ProductId, RoundId, Token, TransactionId, TransactionDate, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	token	string (100)	Yes	Player's private token (in case of cancelbet you should not check if this token is active, you should check if it exists)
2	amount	long	Yes	amount of money
3	transactionId	string (100)	Yes	Transaction Id
4	transactionDate	datetime	Yes	Transaction Date
5	betTypeId	int	Yes	Transaction type
6	gameId	int	Yes	Game Id
7	productId	int	Yes	Product Id
8	roundId	int (64)	Yes	Round Id
9	hash	string	Yes	Hash
10	currency	string (3)	Yes	Currency
11	betTransactionId	string (100)	Yes	Marchant's bet transaction Id

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	TransactionId	string (100)	Transaction Id in merchant's system
3	CurrentBalance	long	Current Balance

If cancel bet request is already processed, merchant must return 201 status code. If bet does not exist in merchant's system, merchant must return 200 status code.

2.8. Get Balance

Merchant must implement this function to make possible getting user balance
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: Currency, GameId, ProductId, Token, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	token	string (100)	Yes	Player's private token
2	gameId	int	Yes	Game Id
3	productId	int	Yes	Product Id
4	hash	string	Yes	Hash
5	currency	string (3)	Yes	Currency

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	CurrentBalance	long	Current Balance

2.9. Get Player Info

Merchant must implement this function to make possible getting user information
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: Token, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	token	string (100)	Yes	Player's private token
2	hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	UserId	string (100)	User id in merchant's system. UserId must be unique per merchant.
3	UserName	string (100)	Username in merchant's system. Username must be unique per merchant.
4	FirstName	string (100)	FirstName of player
5	LastName	string (100)	LastName of player
6	Email	string (100)	Email of player
7	CountryCode	string (2)	Country Code
8	CountryName	string (100)	Country Name
9	Gender	int	(1 -> male, 2 -> female)
10	Currency	string (3)	Currency
11	CurrentBalance	long	Current Balance

2.9. Query Bet

Merchant must implement this function to query information
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: TransactionId, TransactionDate, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	transactionId	string	Yes	Transaction ID
2	transactionDate	string	Yes	Transaction Date
3	hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	BetTransactionId	string (100)	Beting Transaction Id from merchant's system

2.9.1 Query Bet 2

Merchant must implement this function to query information
Http Method: POST
Url: {URL is defined by merchant}
Calculating hash: Parameters must be concatenated with | symbol in this order: GameId, ProductId, TransactionId, TransactionDate, Secret Key, . Hash must be generated with SHA 256.

Example of calculating hash

Parameters

#	Name	Format	Is Required	Description
1	gameId	int	Yes*	Game Id
2	productId	int	Yes	Product Id
3	transactionId	string	Yes	Transaction ID
4	transactionDate	string	Yes	Transaction Date
5	hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	StatusCode	int	StatusCode
2	BetTransactionId	string (100)	Beting Transaction Id from merchant's system

2.10. Sale Reconciliation

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/Reconciliation/GetSaleReconciliationTransactions
Calculating hash: Parameters must be concatenated with | symbol in this order: MerchantId, StartDate, EndDate, Key . Hash must be generated with SHA 256 algorithm.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	MerchantId	int	Yes	Merchant's unique identifier
2	StartDate	datetime	Yes	Start Date
3	EndDate	datetime	Yes	End Date
4	Hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	MemberId	string (100)	Member's unique identifier
2	MerchantId	int	Merchant's unique identifier
3	Date	DateTime	Date
4	Amount	Long	Amount
5	AccountTransId	Long	Account Transaction Id
6	MerchantTransId	String (50)	Merchant Transaction Id

2.11. Refund Reconciliation

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/Reconciliation/GetRefundReconciliationTransactions
Calculating hash: Parameters must be concatenated with | symbol in this order: MerchantId, StartDate, EndDate, Key . Hash must be generated with SHA 256 algorithm.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	MerchantId	int	Yes	Merchant's unique identifier
2	StartDate	datetime	Yes	Start Date
3	EndDate	datetime	Yes	End Date
4	Hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	MemberId	string (100)	Member's unique identifier
2	MerchantId	int	Merchant's unique identifier
3	Date	DateTime	Date
4	Amount	Long	Amount
5	AccountTransId	Long	Account Transaction Id
6	MerchantTransId	String (50)	Merchant Transaction Id

2.12. Won Reconciliation

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/Reconciliation/GetWonReconciliationTransactions
Calculating hash: Parameters must be concatenated with | symbol in this order: MerchantId, StartDate, EndDate, Key . Hash must be generated with SHA 256 algorithm.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	MerchantId	int	Yes	Merchant's unique identifier
2	StartDate	datetime	Yes	Start Date
3	EndDate	datetime	Yes	End Date
4	Hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	MemberId	string (100)	Member's unique identifier
2	MerchantId	int	Merchant's unique identifier
3	Date	DateTime	Date
4	Amount	Long	Amount
5	WinType	int	WinType
6	AccountTransId	Long	Account Transaction Id
7	MerchantTransId	String (50)	Merchant Transaction Id

2.13. Total Sale Reconciliation

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/Reconciliation/GetTotalSaleReconciliation
Calculating hash: Parameters must be concatenated with | symbol in this order: MerchantId, StartDate, EndDate, Key . Hash must be generated with SHA 256 algorithm.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	MerchantId	int	Yes	Merchant's unique identifier
2	StartDate	datetime	Yes	Start Date
2	EndDate	datetime	Yes	End Date
3	Hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	Count	int	Total number of records
2	Total	long	Total

2.14. Total Refund Reconciliation

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/Reconciliation/GetTotalRefundReconciliation
Calculating hash: Parameters must be concatenated with | symbol in this order: MerchantId, StartDate, EndDate, Key . Hash must be generated with SHA 256 algorithm.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	MerchantId	int	Yes	Merchant's unique identifier
2	StartDate	datetime	Yes	End Date
3	EndDate	datetime	Yes	End Date
4	Hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	Count	int	Total number of records
2	Total	long	Total

2.15. Total Won Reconciliation

Http Method: POST
Request content type: application/json
Url: https://gameapi-stage.mobilproses.com/v1/Reconciliation/GetTotalWonReconciliation
Calculating hash: Parameters must be concatenated with | symbol in this order: MerchantId, StartDate, EndDate, Key . Hash must be generated with SHA 256 algorithm.

Example of calculating hash and making request

Parameters

#	Name	Format	Is Required	Description
1	MerchantId	int	Yes	Merchant's unique identifier
2	StartDate	datetime	Yes	Start Date
3	EndDate	endate	Yes	End Date
4	Hash	string	Yes	Hash

Failed response example (json)

Successful response example (json)

Response Parameters

#	Name	Format	Description
1	Count	int	Total number of records
2	Total	long	Total

3. Status codes

Status Codes List

#	Status Code	Description
1	200	Success
2	201	Already Processed Transaction (should be used in win and cancelbet methods)
3	401	Inactive Token
4	402	Insufficient Balance
5	403	Invalid Hash
6	404	Invalid Token
7	405	Transfer Limit
8	406	User Not Found
9	407	Invalid Amount
10	408	Duplicated TransactionId (should be used in bet, deposit and withdraw methods)
11	409	Session Expired
12	410	Invalid Currency
13	411	Invalid Request
14	412	Invalid Ip
15	500	General Error