Skip to Content
WalletSeamless WalletRequests FlowPartial Cashout

Partial Cashout

Partial cashout settles part of a bet while the rest stays open. It uses its own reason codes — partial settle, partial resettle and partial cancelsettle — so your wallet can tell a partial operation apart from a full one.

Note

Partial cashout is optional and must be enabled for your integration. See Partial Cashout Operations for the full type and reason mapping and how to enable it.

All three operations use the same success and error envelopes as the other stages — see Responses.

Partial settle

Each settlement result triggers a deposit transaction. Unlike a full settlement, the amount is only part of the full bet amount, and it can be greater or smaller than betAmount.

Partial settlement results:

  • cashout
Deposit partial settle transaction
{
  "currency": "USD",
  "platform": "sport",
  "id": "id",
  "type": "deposit",
  "initiatedAt": "2021-01-20T00:00:00Z",
  "createdAt": "2021-01-20T00:00:00Z",
  "context": {
    "product": "sportsbook",
    "reason": "partial settle",
    "betAmount": 10,
    "betId": "4494226fa9c24b978b975823e353616b"
  },
  "amountBreakdown": {
    "cash": "9" // it can be more or less than betAmount
  }
}

Partial resettle

Adjusts an existing partial settlement. Only applies to settled bets. The direction follows the same rule as a full resettle: a bigger payout arrives as a deposit, a smaller one as a withdrawal. A withdrawal can leave the player’s cash balance below zero — see Negative balances.

  • Previous settlement result: cashout
  • New settlement result: return
Withdrawal partial resettle transaction
{
  "currency": "USD",
  "platform": "sport",
  "id": "id",
  "type": "withdrawal", // or "deposit"
  "initiatedAt": "2021-01-20T00:00:00Z",
  "createdAt": "2021-01-20T00:00:00Z",
  "context": {
    "product": "sportsbook",
    "reason": "partial resettle",
    "betId": "4494226fa9c24b978b975823e353616b"
  },
  "amountBreakdown": {
    "cash": "1"
  }
}

Partial cancel settle

Reverts a partial settlement entirely. Like a full cancel settle it is always a withdrawal. Only applies to unsettled bets. It can leave the player’s cash balance below zero — see Negative balances.

  • Previous settlement result: cashout
  • New settlement result: unknown
Withdrawal partial cancel settle transaction
{
  "currency": "USD",
  "platform": "sport",
  "id": "id",
  "type": "withdrawal",
  "initiatedAt": "2021-01-20T00:00:00Z",
  "createdAt": "2021-01-20T00:00:00Z",
  "context": {
    "product": "sportsbook",
    "reason": "partial cancelsettle",
    "betAmount": 10,
    "betId": "4494226fa9c24b978b975823e353616b"
  },
  "amountBreakdown": {
    "cash": "9"
  }
}
Settlement CorrectionsOverview