Win

The win request is sent when a game round is complete and money needs to be credited to the player’s account. The operator cannot deny this request and the game server will continue sending it until it is accepted by the wallet platform. The player cannot continue playing a game if there are pending win transactions for that game.

All successful game rounds will end with a Win request, even if the win is zero.

Important: This API call is idempotent, multiple calls with the same IrisTransactionID should not be processed again and return the latest balance of the user.

API Request URL

POST /Win

To settle bets placed by players.

API Request Body Example

{
    "traceId": "23289jfjk902",
    "playerId": "nexid",
    "gameCode": "nexmines",
    "winloss": "1000.00",
    "turnover": "2000.00",
    "returnToWallet": "3000.00",
    "vendorTransactionId": "V#didfn92783",
    "irisTransactionId": "sdfwefr2f3",
    "transactionTime": "2024-08-08T18:08:18.123Z"
}

Request Fields

Name	Type	Description
traceId*	String	Used to track end to end requests for all transactions
playerId*	String	Unique player ID
gameCode*	String	Game code of this transaction List of game codes
winloss*	String	Winloss amount of this transaction
turnover*	String	Effective turnover of this transaction
returnToWallet*	String	Amount to be credited back to player's wallet
vendorTransactionId*	String	Unique transaction ID of this transaction by Vendor
irisTransactionId*	String	Unique transaction ID of this transaction by Iris
transactionTime*	DateTime	ISO 8601 datetime format Date time of this transaction

API Response Example

{
    "traceId": "23289jfjk902",
    "statusCode": 10001,
    "message": "success",
    "data":{
         "balance": "10006020.00",
         "currency": "IDR"
        }
}

Response Fields

Name	Type	Description
traceId*	String	Used to track end to end requests for all transactions
statusCode*	Integer	Status of request List of status codes
message	String	Custom message
balance*	String	Player's account balance
currency*	String	ISO-4217 currency code List of currency supported