Settlement

Once the event is settled on the GR8 Platform, every settlement result triggers a deposit transaction to your wallet — including a losing result, which is sent with an amount of 0.

Flow

The retry budget for settlement transactions is documented in Rollback and Retry Logic. Once it is exhausted, the bet is blocked for further operations until the GR8 Tech operations team intervenes.

Settlement results

Each of these results triggers one deposit transaction with reason: settle:

win
lose
return
techreturn
return025
return075
cashout
deadheat

Note

A lose result still produces a transaction — with "cash": "0". Your wallet must accept it, not reject it as an empty operation.

Deposit transaction

Deposit request

Deposit settle transaction


{
  "currency": "USD",
  "platform": "sport",
  "id": "id",
  "type": "deposit",
  "initiatedAt": "2021-01-20T00:00:00Z",
  "createdAt": "2021-01-20T00:00:00Z",
  "context": {
    "channel": "DESKTOP_AIR_PM",
    "product": "sportsbook",
    "reason": "settle",
    "betAmount": 10,
    "betId": "4494226fa9c24b978b975823e353616b"
  },
  "amountBreakdown": {
    "cash": "20" // Lose result - "cash": "0"
  }
}

Deposit success response


{
  "balances": {
    "sport": {
      "main": {
        "USD": {
          "cash": "100",
          "bonus": "0",
          "locked": "0"
        }
      },
      "sportsbook": {
        "USD": {
          "cash": "100",
          "bonus": "0",
          "locked": "0"
        }
      }
    }
  },
  "alreadyProcessed": false,
  "currency": "USD",
  "platform": "sport",
  "id": "id",
  "type": "deposit",
  "initiatedAt": "2021-01-20T00:00:00Z",
  "createdAt": "2021-01-20T00:00:00Z",
  "context": {
    "channel": "DESKTOP_AIR_PM",
    "product": "sportsbook",
    "reason": "settle",
    "betId": "4494226fa9c24b978b975823e353616b"
  },
  "amountBreakdown": {
    "cash": "20"
  }
}

Deposit error response

In case of an unsuccessful wallet response, the settlement fails. The error envelope is the same as for bet placement — see Wallet Error Codes for the codes.

Requests Flow Overview - How the stages fit together
Settlement Corrections - Resettle and cancel settle
Partial Cashout - Partial settlement of a bet
Rollback and Retry Logic - Retry budgets per operation type