<?xml version="1.0" encoding="utf-8"?>
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd">
<head>
<link href="../Resources/TableStyles/NewStyle.css" rel="stylesheet" MadCap:stylesheetType="table" />
</head>
<body>
<MadCap:breadcrumbsProxy MadCap:conditions="Default.Web" style="padding-bottom: 10px;border-bottom-style: solid;border-bottom-width: 1px;font-family: 'Segoe UI';border-bottom-color: #acacac;font-weight: bold;" />
<h1 class="main-container-header">Authenticate</h1>
<table style="width: 100%;">
<col style="width: 859px;" />
<col style="width: 1141px;" />
<tbody>
<tr>
<td style="width: 100%;">
<!-- main - container start -->
<div class="main-container">
<!-- main left content start -->
<div class="main-content">
<h6>http://{evi-server-url}/Authenticate</h6>
<p> </p>
<p>Once a player opens a game, an Authentication request will be sent to EVI in order to validate the player.</p>
<p> </p>
<h2>POST Request</h2>
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/NewStyle.css');margin-left: 0;margin-right: auto;" class="TableStyle-NewStyle" cellspacing="3">
<col class="TableStyle-NewStyle-Column-Column1">
</col>
<col class="TableStyle-NewStyle-Column-Column2">
</col>
<col class="TableStyle-NewStyle-Column-Column3">
</col>
<thead>
<tr class="TableStyle-NewStyle-Head-Header1">
<th class="TableStyle-NewStyle-HeadE-Column1-Header1">
<p>Parameter</p>
</th>
<th class="TableStyle-NewStyle-HeadE-Column2-Header1">
<p>Type</p>
</th>
<th class="TableStyle-NewStyle-HeadD-Column3-Header1">
<p>Remarks</p>
</th>
</tr>
</thead>
<tbody>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyE-Column1-Body2" style="font-family: 'Segoe UI';">Account</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body2" style="font-family: 'Segoe UI';">Account</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body2" style="font-family: 'Segoe UI';">
<p>API username and password.</p>
</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body1">
<td class="TableStyle-NewStyle-BodyE-Column1-Body1" style="font-family: 'Segoe UI';">ClientToken</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body1" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body1" style="font-family: 'Segoe UI';">The Token that was passed in the launch game url.</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyE-Column1-Body2" style="font-family: 'Segoe UI';">ExtraData</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body2" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body2">extraData parameter that was passed on the Launch game request.</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body1">
<td class="TableStyle-NewStyle-BodyE-Column1-Body1" style="font-family: 'Segoe UI';">GameCode</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body1" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body1">
<p>Unique Game Code</p>
</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyB-Column1-Body2" style="font-family: 'Segoe UI';">ClientIP</td>
<td class="TableStyle-NewStyle-BodyB-Column2-Body2" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyA-Column3-Body2" style="font-family: 'Segoe UI';">The client IP of the player.</td>
</tr>
</tbody>
</table>
<p> </p>
<h2>Response</h2>
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/NewStyle.css');margin-left: 0;margin-right: auto;" class="TableStyle-NewStyle" cellspacing="3">
<col class="TableStyle-NewStyle-Column-Column1">
</col>
<col class="TableStyle-NewStyle-Column-Column2">
</col>
<col class="TableStyle-NewStyle-Column-Column3">
</col>
<thead>
<tr class="TableStyle-NewStyle-Head-Header1">
<th class="TableStyle-NewStyle-HeadE-Column1-Header1">
<p>Parameter</p>
</th>
<th class="TableStyle-NewStyle-HeadE-Column2-Header1">
<p>Type</p>
</th>
<th class="TableStyle-NewStyle-HeadD-Column3-Header1">
<p>Remarks</p>
</th>
</tr>
</thead>
<tbody>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyE-Column1-Body2" style="font-family: 'Segoe UI';">PlayerId</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body2" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body2" style="font-family: 'Segoe UI';">
<p>The external bonus id on the vendor side.</p>
</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body1">
<td class="TableStyle-NewStyle-BodyE-Column1-Body1" style="font-family: 'Segoe UI';">CurrencyCode</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body1" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body1" style="font-family: 'Segoe UI';">Currency of the player. You must use the relevant ISO (4217) currency code, such as GBP for United Kingdom Pound.</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyE-Column1-Body2" style="font-family: 'Segoe UI';">CountryCode</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body2" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body2" style="font-family: 'Segoe UI';">The country of the player. You must use the relevant ISO (3166-1) code, such as AU for Australia.</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body1">
<td class="TableStyle-NewStyle-BodyE-Column1-Body1" style="font-family: 'Segoe UI';">Token</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body1" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body1" style="font-family: 'Segoe UI';">New generated token. This token will be used on all the requests of the current session.</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyE-Column1-Body2" style="font-family: 'Segoe UI';">Balance</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body2" style="font-family: 'Segoe UI';">Decimal</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body2" style="font-family: 'Segoe UI';">Player's balance</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body1">
<td class="TableStyle-NewStyle-BodyE-Column1-Body1" style="font-family: 'Segoe UI';">OperatorCode</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body1" style="font-family: 'Segoe UI';">String</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body1" style="font-family: 'Segoe UI';">The operator identifier on the EVI side.</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyE-Column1-Body2" style="font-family: 'Segoe UI';">ErrorCode</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body2" style="font-family: 'Segoe UI';">Integer</td>
<td class="TableStyle-NewStyle-BodyD-Column3-Body2" style="font-family: 'Segoe UI';">Error code in case the request had an error.</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body1">
<td class="TableStyle-NewStyle-BodyB-Column1-Body1" style="font-family: 'Segoe UI';">SessionData</td>
<td class="TableStyle-NewStyle-BodyB-Column2-Body1" style="font-family: 'Segoe UI';">SessionData</td>
<td class="TableStyle-NewStyle-BodyA-Column3-Body1" style="font-family: 'Segoe UI';">Holds the player session data – session balance, sum of total wins and sum of total bets. Required for the Spanish Regulation</td>
</tr>
</tbody>
</table>
<p> </p>
<h2>Possible Error Codes</h2>
<table style="width: 100%;mc-table-style: url('../Resources/TableStyles/NewStyle.css');margin-left: 0;margin-right: auto;" class="TableStyle-NewStyle" cellspacing="3">
<col class="TableStyle-NewStyle-Column-Column1" style="width: 210px;">
</col>
<col class="TableStyle-NewStyle-Column-Column2" style="width: 106px;">
</col>
<col class="TableStyle-NewStyle-Column-Column3" style="width: 325px;">
</col>
<col class="TableStyle-NewStyle-Column-Column4">
</col>
<thead>
<tr class="TableStyle-NewStyle-Head-Header1">
<th class="TableStyle-NewStyle-HeadE-Column1-Header1">
<p>Parameter</p>
</th>
<th class="TableStyle-NewStyle-HeadE-Column2-Header1">
<p>Code</p>
</th>
<th class="TableStyle-NewStyle-HeadE-Column3-Header1">
<p>Remarks</p>
</th>
<th class="TableStyle-NewStyle-HeadD-Column4-Header1">Expected Behavior</th>
</tr>
</thead>
<tbody>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyE-Column1-Body2" style="font-family: 'Segoe UI';">AuthenticateFailed</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body2" style="font-family: 'Segoe UI';">1</td>
<td class="TableStyle-NewStyle-BodyE-Column3-Body2" style="font-family: 'Segoe UI';">
<p>The credentials provided in the API are wrong.</p>
</td>
<td class="TableStyle-NewStyle-BodyD-Column4-Body2">Game should crash</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body1">
<td class="TableStyle-NewStyle-BodyE-Column1-Body1" style="font-family: 'Segoe UI';">InvalidRound</td>
<td class="TableStyle-NewStyle-BodyE-Column2-Body1" style="font-family: 'Segoe UI';">4</td>
<td class="TableStyle-NewStyle-BodyE-Column3-Body1" style="font-family: 'Segoe UI';">
<p>Player Id was not found.</p>
</td>
<td class="TableStyle-NewStyle-BodyD-Column4-Body1">Game should crash</td>
</tr>
<tr class="TableStyle-NewStyle-Body-Body2">
<td class="TableStyle-NewStyle-BodyB-Column1-Body2" style="font-family: 'Segoe UI';">GeneralError</td>
<td class="TableStyle-NewStyle-BodyB-Column2-Body2" style="font-family: 'Segoe UI';">900</td>
<td class="TableStyle-NewStyle-BodyB-Column3-Body2">
<p>General error.</p>
</td>
<td class="TableStyle-NewStyle-BodyA-Column4-Body2">Game should crash</td>
</tr>
</tbody>
</table>
<p> </p>
<p> </p>
<p><b>Examples</b>:</p>
<p><b>Authenticate request</b> </p>
<p>{</p>
<p>"ClientToken": "PPT_D8A1CA355FB54904BD061AF331B52C9D",</p>
<p>"ExtraData": "op%3DWTG%26net%3DJDT", "Account": {</p>
<p>"Username": "eviuser", "Password": "evipassword"</p>
<p>},</p>
<p>"GameCode": "EVIGame_Desktop", "ClientIp": "31.154.25.321"</p>
<p>}</p>
<p> </p>
<p><b>Authenticate OK Response </b>
</p>
<p>{</p>
<p>"PlayerId": "PPT_327",</p>
<p>"Token": "DB87E8897E1B4089921032B37EA2ECF4", "Balance": 197545.35,</p>
<p>"CurrencyCode": "GBP", "CountryCode": "GB", "OperatorCode": "PPT", "SessionData": {</p>
<p>"TotalBet":20.0,</p>
<p>"TotalWin":10.0, "SessionBalance":220.0</p>
<p>}</p>
<p>}</p>
<p> </p>
<p><b>Authenticate error response </b>
</p>
<p>{</p>
<p>"Balance": 0,</p>
<p>"ErrorCode": 2</p>
<p>}</p>
</div>
<!-- main left content end -->
<div class="main-content-toc"><b>Table of Contents</b>
<MadCap:menuProxy mc-linked-toc="$topicHeadings" style="mc-toc-depth: 2;mc-context-sensitive: True;mc-include-parent: True;mc-include-siblings: True;mc-include-children: True;">
</MadCap:menuProxy>
<p> </p>
</div>
<!-- main right toc end -->
</div>
<!-- main - container end -->
</td>
</tr>
</tbody>
</table>
</body>
</html>
Preview:
downloadDownload PNG
downloadDownload JPEG
downloadDownload SVG
Tip: You can change the style, width & colours of the snippet with the inspect tool before clicking Download!
Click to optimize width for Twitter