Skip to main content

​
Functionality

The endpoint called when the player wins (credit)
  • The Operator is expected to increase player’s balance by payout and return a new balance.
  • Each win has transactionId which is unique for each transaction. Before any altering of player’s balance, Operator has to check that win wasn’t processed before.
  • If the payout fails, the system will automatically retry up to three times. If all retries fail, the bet will also be marked as failed to ensure transaction consistency, and a revert operation will be triggered.
Finally, it returns the updated balance, reflecting the result of the win.

​
Headers

​
string
required
A unique identifier associated with operator calling API.
​
string
required
A SHA256 HMAC signature generated using the request body and timestamp. Format: HMAC_SHA256(JSON.stringify(data) + ’|’ + timestamp), signed using the provided secret key.
​
string
required
An Unix timestamp (milliseconds) when the request was sent. Ensure the same value is used in signature generation.
​
string
required
Must be set to application/json

​
Request Body

​
string
required
The unique transaction identifier. An action with same transactionId shouldn’t be processed more than once.
​
string
required
Unique identifier of the transaction that this transaction is referencing, which is the transactionId of the bet.
​
string
required
A unique identifier for the session.
​
string
required
The unique identifier for the player.
​
string
required
The unique identifier for the game.
​
string
required
Player’s current session currency code.
​
number
required
The amount won by the player.
To maintain precision and avoid floating-point errors, the amount field is processed as an integer value by multiplying the actual amount by 100000.For example, a amount of 12.34567 will be represented as 1234567 in the API.
​
boolean
required
Indicates whether the player won the bet.
​
boolean
required
Indicates whether the bet transaction was placed using a free bet bonus.true → The bet is made using a free bet bonus.false → The bet is made using regular funds.
​
object
required
Contains the currently active bonus information

​
Response

​
string
required
Code indicates status of the request weather it is succeed or failed. We have listed error codes here
​
string
required
An ID of an action that is generated for each of our calls to the Operator, used to sync OppiGame and Operator sides for debugging purposes. The Operator has to respond with the same transactionId as the one received in request.
​
number
required
The updated balance of the player.
To maintain precision and avoid floating-point errors, the balance field is processed as an integer value by multiplying the actual amount by 100000.For example, a balance of 12.34567 will be represented as 1234567 in the API.