Request

API URL : {OperatorAPIDomain}/{OperatorEndpoint}
HTTP Method : POST

Body Parameters

data (JSON)
must contain all fields below.

Name	Description	Data type	Status
betId	Unique ID of the bet	String (length: 36)	Required
currency	Currency of the player	String	Required
gameCode	Code of the game	String (length: 255)	Required
groupCode	Auto-generated code of the group in the Naga Games system	String (length: 4)	Required
playerToken	Unique token of the player	String (length: 255)	Required
transactionId	Unique ID of the bet transaction	String (length: 36)	Required
amount	Amount of the bet Note: For free spins, a bet request with a zero bet amount will be sent.	Decimal (20,2)	Required
parentBetId	Unique ID of the parent bet If the bet type is NORMAL and did not generate any free spins during the spin, it will result in ParentBetId = NULL. When a player wins the free spins. parentBetId will be equal to the betId. When a bet includes free spins, the ParentBetId will not be NULL and will not be equal to the betId.	String (length: 36)	Optional
brandCode	Auto-generated code of the brand in the Naga Games database	String (length: 4)	Required
betType	Type of the Bet	String	Optional
isLastFreeSpins	This indicates to the operator that this bet is the last free spin in the entire free spin round.	Boolean	Optional

dataHash (String)
All request data coming from Naga Games would be hashed using SHA-256 as a data checksum and signed with the Private Key, which was generated for each operator using the RSA signing algorithm.

Header Parameters

x-signature (String)
Must be generated from signing process with correct order of data fields & private Key.

🚧
About Signing & Verifying dataHash & Signature
Please check at How to signing & verify dataHash and signature for Seamless mode?

🚧
About Data & Signagure in Request Operator will receive
An operator must process the data in the same order ( data order and the number of data fields passed ) as specified by Naga Games to get the result from the API. Please make sure that the signature generated is valid before requesting, as different data will generate different signature and will result in error ( happens if any order or any data is missing or invalid during the signature generation process ).
Refer ➡️ Data Order before Stringify & Hashing.

Bet Type

Type	Description
NORMAL	Bet from base game
PREPAID	Bet from marketing tool
WIN_FREESPIN	Bet from free game
BUY_FREESPIN	Bet from buy feature
GAMBLE	Bet from gamble feature
JACKPOT	Bet from jackpot feature
GAMBLE_LAST	Last Bet from gamble feature
WIN_FREESPIN_LAST	Last bet from free game
BUY_FREESPIN_LAST	Last bet from Buy feature

Example

curl --location 'https://api-demo-operator.stg.game.topplatform.online/vendor/placebet' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-signature: XRm4olA+PIQIhCKqoscsMGX7In4bFQ3tprVCZxe1/I4RqjvFCGHftdPww0djh8LOwG/H3/0BQC3eX58aV7rOroDZP6Q9BaL5ydIi20s1DVD/QMd3xJhFVfJWraWOBNlH7K2jiozTEUAnjbshz5pIWdDGdPSbCpj18ed+YkkgSvE=' \
--data '{
  "data": {
    "betId": "3a93be66-ec1c-dac5-a765-858f7dc86c12",
    "currency": "THB",
    "gameCode": "fulong",
    "playerToken": "49aea340db7fc8851d8facaa7a84d62a",
    "groupCode": "dpae",
    "transactionId": "3a93be66-ec1c-dac5-a765-858f7dc86c12-101-1682652126658",
    "amount": 10,
    "parentBetId": null,
    "brandCode": "dtdr",
    "isLastFreeSpins": null
  },
  "dataHash": "0ad7b2a651f3f025246ff07fe6a4d04478e1946f7ef0ff711a8d84791561af01"
}'

Response

📘
Response Structure
For Response code please refer here Success Response Structure and Failure Response Structure

Data Response

Name	Description	Data type
currency	Currency of the player	String
balance	Balance of the player	Decimal (20,2)

Example

Success Response Example (HTTP status code 200)

{
    "data": {
        "balance": 99999990,
        "currency": "THB"
    }
}

Failure Response Example (HTTP status code 400)

{
  "data": null,
  "error": {
    "statusCode": 400,
    "message": "Cannot verify data!"
    }
}