API Name Settlement
Notes
  • The settlement will not try to retry; errors are logged and retried separately.
  • The settlement process is asynchronous.
  • All settlements are reported to the Main Wallet for tracking.
  • Game number in place bet request is used for reporting.
  • FreeGame identifies free game rounds.
  • GameRoundEnd marks the last game section.
  • Warning:
    • Retries use the same transaction ID; Verification on the received transactionid is crucial.
    • Response JSON should always follow the Success Response format.
  • Tournament payouts are treated as settlement requests with gameId = 0.
Path <WalletUrl>/account/settlement
Method POST
Return Format JSON
Header Content-Type: application/json
Request Parameters
  • amount : Double (Required) - Amount of Win/Lost
  • gameid : Integer (Required) - Unique identifier for a game
  • roundid : String (Required) - Unique identifier for a round in the game
  • currency : String (Required) - Player Currency Code
  • transactionid : String (Required) - Transaction unique identifier
  • membercode : String (Required) - Login
  • token : String (Optional) - Game token
  • gamenum : Integer (Optional) - Unique identifier for a gameplay detail
  • freegame : Bit (Required) - Free game identifier (1=true; 0=false)
  • gameroundend : Bit (Required) - Last game identifier (1=true; 0=false)
  • jackpotamount : Double (Required) - Jackpot amount won from amount
  • sessionid : Integer (Required) - Session Id
  • platformid : Integer (Optional) - Game platform that is currently running
  • bonusamount : Double (Optional) - Bonus amount of the Win/Lost
  • maxbonusconversion : Double (Optional) - Maximum amount of bonus balance that can be converted to real balance
  • isbonusroundend : Bit (Optional) - Last game of the bonus round (1=true; 0=false)
  • bonusconverted : Double (Optional) - Amount of bonus money that should be converted to real balance
  • jackpotcontribution : Double (Optional) - Amount of the contribution to the jackpot pot
  • bonusjackpotcontribution : Double (Optional) - Bonus amount of the contribution to the jackpot pot
  • bonusroundid : String (Optional) - Unique identifier for a bonus round in the game
  • bonusfreespinremaining : Integer (Optional) - Number of remaining free spins that the player needs to complete
  • bonuscode : String (Optional) - Code used to identify the specific bonus/coupon
  • transactiondate : String (Optional) - The date and time when the transaction was created, expressed as "YYYY-MM-DDThh:mm:ss.SSS+hh:mm"
  • utctransactiondate : String (Optional) - The date and time when the transaction was created in UTC, expressed as "YYYY-MM-DDThh:mm:ss.SSS+00:00"
Request Example { "amount": 3, "gameid": 458761, "roundid": "-9223372036854774281", "currency": "USD", "transactionid": "RTGS_-9223372036854774250", "membercode": "mapuy4", "token": "", "gamenum": 514, "freegame": false, "gameroundend": true, "jackpotamount": 0, "sessionid": 20090, "platformid": 3, "bonusamount": 0, "maxbonusconversion": 0, "isbonusroundend": false, "bonusconverted": 0, "jackpotcontribution": 0, "bonusjackpotcontribution": 0, "bonusroundid": null, "bonusfreespinremaining": 0, "bonuscode": null, "transactiondate": "2022-03-29T14:49:36.000Z", "utctransactiondate": "2022-03-29T14:49:36.000+00:00" }
Success Response Example { "code": 0, "message": "success", "balance": 9999.99, "bonusbalance": 999.99 }
Error Codes
  • 0: No error
  • 53: Player does not exist
  • 100: Required field missing
  • 104: Invalid amount format
  • 105: Transaction ID too long
  • 404: Insufficient balance
  • 405: Duplicate transaction ID
  • -1: Internal server error