PromoWin

When the provider needs to grant a player with promo wins, there is a /promoWin call available to commit such transactions.

Request Example

POST /promoWin HTTP/1.1
Content-Type: application/json

https://stg.otkgaming.com/promoWin

{
    "externalToken"       : "valid-session-token",
    "playerId"            : "abc123456",
    "gameId"              : "123",
    "transactionId"       : "124677",
    "externalReferenceId" : "provided externalReferenceId",
    "amount"              : 10,
    "currency"            : "EUR"
}

Property Name	Descriptio	Type	Notes
externalToken	player’s session token	string(255)	value passed upon game launch as query parameter
playerId	unique player identifier	string(100)	unique per platform
gameId	game identifier on game provider side	string(255)	game id where bet was placed (same as was passed during product launch)
transactionId	game transaction id	string(255)	unique transaction id on game provider’s side
amount	transaction amount to process	number	amount of transaction in currency’s minor units
currency	currency of transaction	string(3)	currency of transaction
externalReferenceId	externalReferenceId passed when giving a player free rounds	string(100)	is optional, available only when requesting to settle for free rounds winning

Response Example

https://stg.otkgaming.com/promoWin

{
    "transactionId" : "abc123",
    "externalTrxId" : "abc123",
    "balance"       : 9000
}

Property Name	Descriptio	Type	Notes
transactionId	game provider’s transaction id	string(255)	same as passed to request
externalTrxId	committed transaction id on Platform side	string(255)	transaction id on Platform side
balance	player’s remaining balance	number	in minor units(mostly cents)