Settle Round

Settle a game round by deducting the bet amount and adding the payout amount to the player's wallet.

Signature data: {gameCode}:{roundID}:{currency}:{playerUsername}:{bet}:{payout}

This is the primary transaction endpoint. Each round should be settled exactly once.

Error handling:

Known error statuses (0001-0009, 9999) are mapped to specific error codes and returned immediately.

Unknown/unexpected statuses trigger a fail transaction log to ScyllaDB and are queued for retry via SQS.

Fail transaction log fields:

action, actionTime, ID, gameID, gameCode, roundID, agentID, playerUsername

currency, bet, payout, callbackURL, request body, response body

httpCode, errorMessage, latencyMs

curl --location '/settlement' \ --header 'Accept-Language;' \ --header 'X-PUBLIC-KEY;' \ --header 'X-TIMESTAMP;' \ --header 'X-SIGNATURE;' \ --header 'X-Request-ID;' \ --header 'Content-Type: application/json' \ --data '{ "gameCode": "MJW", "roundID": "550e8400-e29b-41d4-a716-446655440000", "playerUsername": "johndoe123", "currency": "USD", "bet": 10, "payout": 25.5 }'

Request

Responses