Full endpoint = Base URL + relative path
Example: https://wallet.operator.com/api/balance/get

Content-Type: application/json
X-Signature: {base64_hmac_sha256}
X-Timestamp: {unix_time_ms_utc}
X-Nonce: {unique_random_value}
X-Provider-Code: GoLetsPlay

{
  "launchToken": "GUID"
 }

{
  "playerId": 2,
  "operatorPublicId": "GUID",
  "displayName": "player1",
  "gameId": 1,
  "currencyCode": "PHP",
  "languageCode": "en-PH",
  "countryCode": "PH",
  "balance": 1000.00
}

{
  "error": "Invalid or expired launch token."
}

Content-Type: application/json
X-Signature: {base64_hmac_sha256}
X-Timestamp: {unix_time_ms_utc}
X-Nonce: {unique_random_value}
X-Provider-Code: GoLetsPlay

{
  "playerId": 1
 }

{
  "playerId": 1,
  "currencyCode": "PHP",
  "balance": 1000.00
}

{
  "error": "Player not found."
}

Content-Type: application/json
X-Signature: {base64_hmac_sha256}
X-Timestamp: {unix_time_ms_utc}
X-Nonce: {unique_random_value}
X-Provider-Code: GoLetsPlay

{
  "playerId": 1,
  "gameId": 1,
  "roundId": "R-001",
  "transactionId": "T-001",
  "amount": 10.00,
  "currencyCode": "PHP"
}

{
  "playerId": 1,
  "currencyCode": "PHP",
  "balance": 990.00,
  "transactionId": "T-001"
}

- amount is the bet/debit amount only and should be positive.
- The response balance is the player's balance AFTER the deduction.
- Example: starting balance 1000.00, bet amount 10.00, response balance 990.00.
- Reject if the wallet does not have enough available balance.
- transactionId must be idempotent: same request returns same result, different payload with same transactionId should be rejected.

{
  "error": "Insufficient funds."
}

Content-Type: application/json
X-Signature: {base64_hmac_sha256}
X-Timestamp: {unix_time_ms_utc}
X-Nonce: {unique_random_value}
X-Provider-Code: GoLetsPlay

{
  "playerId": 1,
  "gameId": 1,
  "roundId": "M-10021",
  "transactionId": "SETTLE-M-10021-P1-0007",
  "amount": 25.00,
  "currencyCode": "PHP",
  "playerActivity": {
    "matchId": "M-10021",
    "totalHands": 12,
    "totalBetsAmount": 5400,
    "totalTipsAmount": 30,
    "totalWinsAmount": 6200,
    "totalLoseAmount": 6000,
    "totalRakeAmount": 145,
    "netAmount": 25
  }
}

{
  "playerId": 1,
  "currencyCode": "PHP",
  "balance": 1015.00,
  "transactionId": "SETTLE-M-10021-P1-0007"
}

- amount is the win/payout credit only. It should be positive.
- Do not send a negative amount here.
- The original bet deduction should already have happened in POST /api/bet/place.
- The response balance is the player's balance AFTER the credit.
- Example: balance after bet is 990.00, settle amount is 25.00, response balance becomes 1015.00.
- If rake applies, the settle amount should already be net of rake before this request is sent.
- playerActivity is an audit/detail object for the player's completed match activity.
- playerActivity.matchId should be the same value as roundId for poker integration.
- playerActivity.netAmount should normally match the top-level amount sent to settle.

{
  "error": "Duplicate transaction."
}

Content-Type: application/json
X-Signature: {base64_hmac_sha256}
X-Timestamp: {unix_time_ms_utc}
X-Nonce: {unique_random_value}
X-Provider-Code: GoLetsPlay

{
  "playerId": 1,
  "gameId": 1,
  "roundId": "R-001",
  "transactionId": "T-003",
  "originalTransactionId": "T-001",
  "amount": 10.00
}

{
  "playerId": 1,
  "currencyCode": "PHP",
  "balance": 1000.00,
  "transactionId": "T-003"
}

- amount should be positive.
- Always send originalTransactionId so your backend can look up the original transaction type.
- If the original transaction type is a debit (bet, tip, jackpot contribute), rollback should add the amount back to the wallet.
- If the original transaction type is a credit (settle/win, free bet, jackpot payout), rollback should deduct the amount back from the wallet.
- In simple terms: rollback should reverse the financial effect of the original transaction.
- transactionId for the rollback request itself must also be idempotent.

{
  "error": "Transaction not found."
}

Content-Type: application/json
X-Signature: {base64_hmac_sha256}
X-Timestamp: {unix_time_ms_utc}
X-Nonce: {unique_random_value}
X-Provider-Code: GoLetsPlay

{
  "playerId": 1,
  "gameId": 1,
  "roundId": "R-001",
  "transactionId": "T-010",
  "amount": 5.00,
  "currencyCode": "PHP"
}

{
  "playerId": 1,
  "currencyCode": "PHP",
  "balance": 995.00,
  "transactionId": "T-010"
}

{
  "error": "Insufficient balance."
}

Content-Type: application/json
X-Signature: {base64_hmac_sha256}
X-Timestamp: {unix_time_ms_utc}
X-Nonce: {unique_random_value}
X-Provider-Code: GoLetsPlay

{
  "gameId": 1,
  "matchId": "match-123",
  "handId": "match-123-000001",
  "tableId": "table-01",
  "amount": 12.50,
  "currencyCode": "PHP",
  "payloadJson": "{...}"
}

{
  "gameRakeEventId": 1001
}

- Do not deduct this amount from the player's wallet in this endpoint.
- This endpoint is for record keeping, audit, and revenue tracking only.
- The rake should already be accounted for in the game result before settle is sent.
- In practice, the settle amount sent to POST /api/bet/settle should already be net of rake.

{
  "error": "MatchId is required."
}