v.1.1.0

Overview

Version 1.1.0 introduces new API endpoints for managing tournament and promotional wins, token regeneration, and improvements to Free Rounds functionality.This version maintains full backward compatibility with v1.0.0.

---

🆕 New Endpoints

2.5 /tournamentWin

Purpose: Register and commit a player’s win in a tournament event.

Request Example:

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

https://stg.otkgaming.com/tournamentWin

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

Details:

• Used when a player achieves a tournament-related win.
• The transaction is processed and reflected in the player’s account balance.
• Follows standard security and validation for tokens, currency, and transaction IDs.

---

2.6 /promoWin

Purpose: Commit promotional wins granted to players (e.g., bonuses, free-round rewards, or special campaign payouts).

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"
}

Notes:

• externalReferenceId must be unique for each transaction.
• Can be used to associate a promotional win with an external system or campaign reference.
• Follows same format and response structure as /win.

---

2.7 /generateNewToken

Purpose: Used to generate a new session token when changing games through the lobby or reinitializing a session.

Request Example:

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

https://stg.otkgaming.com/generateNewToken

{
    "token"     : "valid-session-token",
    "newGameId" : "123"
}

Details:

• Designed for seamless switching between games without player reauthentication.
• The new token inherits all session context and player metadata.
• The old token must be invalidated upon new token issuance.

---

⚙️ Updated Functionality

Free Rounds and Free Rounds by Bet

Enhancements:

• Both endpoints now support multiple player entries.
• Fields playerIds and externalReferenceIds can now be sent as arrays.
• Each value must be unique and have a maximum combined length of 20,000 characters.

Example (Free Rounds):

https://stg.otkgaming.com

{
    "action": "freeRounds",
    "platform": 8,
    "partnerId": 1,
    "time": "24-03-2021 11:03:04",
    "data": {
    "playerIds": ["p123", "p124", "p125"],
    "externalReferenceIds": ["ref-001", "ref-002", "ref-003"],
    "freeRoundValidity": "13-04-2021 11:04:04",
    "numberOfFreeRounds": 40,
    "amount": 0.1,
    "currency": "EUR",
    "gameIds": ["2"]
},
    "hash": "36435dd6e55d8926e2b97c4ae7450bee"
}

Example (Free Rounds by Bet):

https://stg.otkgaming.com

{
    "action": "freeRoundsByBet",
    "platform": 8,
    "partnerId": 1,
    "time": "24-03-2021 11:03:04",
    "data": {
    "playerIds": ["p123", "p124", "p125"],
    "externalReferenceIds": ["ref-101", "ref-102", "ref-103"],
    "freeRoundValidity": "13-04-2021 11:04:04",
    "numberOfFreeRounds": 40,
    "betAmount": 0.1,
    "currency": "EUR",
    "gameId": "2"
},
    "hash": "36435dd6e55d8926e2b97c4ae7450bee"
}

Notes:

• Enables bulk assignment or management of free rounds across multiple players in a single request.
• Reduces API overhead for promotional events and campaigns.

---

Summary of Changes

Category	Description
🆕 New Endpoints	/tournamentWin, /promoWin, /generateNewToken
⚙️ Enhanced	Free Rounds and Free Rounds by Bet — support for multiple players (max 20,000 length)
🔄 Compatibility	Fully backward compatible with v1.0.0
🔒 Security	Maintains SHA-256 hashing and HTTPS-only enforcement

---

© Choice Gaming — Integration API v1.1.0