Skip to Content
WalletSeamless WalletPerform TransactionTransaction Types

Transaction Types and Reasons Reference

This page provides a complete reference of all transaction types and reason codes used in the wallet integration.

Complete Type-Reason Mapping

Core Sportsbook Operations (Required)

These transactions are required for basic sportsbook integration:

OperationTypeReasonDirectionDescription
Sport BetwithdrawalbetMoney outStandard bet placement
Sport Rollback Betrollbacksport rollbackReverseCancel a bet placement and return the stake
Sport SettledepositsettleMoney inBet settlement (win/lose/return)
Sport Resettle (positive)depositresettleMoney inAdjust settlement with additional payout
Sport Resettle (negative)withdrawalresettleMoney outAdjust settlement by taking back funds
Sport Cancel SettlewithdrawalcancelsettleMoney outRevert previous settlement

Settlement Corrections: Cancel Settle vs Resettle

When a bet result needs to be corrected, there are two different approaches:

Cancel Settle - Complete settlement reversal:

  • Completely reverts the previous settlement
  • Bet returns to unsettled state
  • After cancel settle, a new Settle transaction will follow with the corrected result
  • Use when: Result was completely wrong (e.g., event cancelled, wrong outcome applied)

Resettle - Direct adjustment:

  • Adjusts the payout directly without reverting to unsettled state
  • Can be positive (deposit) or negative (withdrawal)
  • No additional Settle transaction follows
  • Use when: Result needs adjustment but wasn’t completely wrong (e.g., odds changed, partial correction)

Important: Both Cancel Settle and Resettle apply to all bet types (regular bets, freebet bets, bonus bets). The same logic applies regardless of the reason code (e.g., cancelsettle, cancelsettle freebet, resettle, resettle freebet).

Caution

Cancel Settle is not a rollback

  • Rollback (type: rollback) reverses a bet placement. It always carries context.parentId, follows the rollback retry policy, and fails with decline.parent.notfound / decline.parent.failed.
  • Cancel settle (type: withdrawal, reason: cancelsettle) reverses a settlement. It carries no parentId, follows the settlement retry policy, and must never return decline.parent.*.

There is no rollback for a settlement — a settlement is corrected with cancelsettle or resettle. See What a Rollback Is (and Is Not) for the full comparison.

Partial Cashout Operations (Optional - Requires Configuration)

These transactions are only needed if you enable the Partial Cashout feature :

OperationTypeReasonDirectionDescription
Sport Partial Settledepositpartial settleMoney inPartial bet settlement (cashout)
Sport Partial Resettle (pos)depositpartial resettleMoney inAdjust partial settlement with payout
Sport Partial Resettle (neg)withdrawalpartial resettleMoney outAdjust partial settlement by taking back
Sport Partial Cancel Settlewithdrawalpartial cancelsettleMoney outRevert previous partial settlement
Note

Enabling Partial Cashout To enable partial cashout functionality, contact your AM/PM from the GR8 Tech team. Learn more about this feature in the Cashout documentation .

Bonus Operations (Optional - Requires Bonus Integration)

These transactions are only needed if you integrate with the GR8 Tech Bonus System:

OperationTypeReasonDirectionDescription
Sport Bonus Awardawardbonus awardBonus inGrant bonus with wagering requirements
Sport Bonus Release (limited)releasebonus limit releaseBonus outConvert bonus to cash (with max limit)
Sport Bonus Retractretractbonus releaseBonus outRemove bonus funds (cancel/expire)

Learn more about bonus integration:

Freebet Operations (Optional - Requires Bonus Integration)

These transactions are only needed if you integrate Freebet bonuses:

OperationTypeReasonDirectionDescription
Sport Freebet Awardawardfreebet awardBonus inGrant freebet to player
Sport Freebet BetwithdrawalfreebetBonus outPlace bet using freebet
Sport Freebet Rollbackrollbackrollback freebetReverseCancel freebet bet and return freebet
Sport Freebet Settledepositsettle freebetMoney inSettle freebet bet (winnings only)
Sport Freebet Cancel Settlewithdrawalcancelsettle freebetMoney outRevert freebet settlement
Sport Freebet Resettle (pos)depositresettle freebetMoney inAdjust freebet settlement with additional payout
Sport Freebet Resettle (neg)withdrawalresettle freebetMoney outAdjust freebet settlement by taking back funds
Sport Freebet Retractretractfreebet releaseBonus outRemove unused freebet

Learn more: Freebet Integration Guide

Transaction Types

All possible transaction type values:

TypeRequiredDescriptionUsed For
withdrawalYesDeduct funds from player balanceBets, cancel settlements, negative resets
depositYesAdd funds to player balanceSettlements, winnings, positive resets
rollbackYesReverse a bet placement (never a settlement)Bet placement cancellations, freebet placement rollbacks
awardOptionalGrant bonus funds to player (bonus integration only)Bonus awards, freebet awards
releaseOptionalConvert bonus to cash or remove with limit (bonus integration only)Bonus wagering completion
retractOptionalRemove bonus funds without conversion (bonus integration only)Bonus cancellation, expiration

Reason Codes by Category

Core Sportsbook Reasons (Required)

Standard sportsbook operations required for basic integration:

bet
settle
resettle
cancelsettle
sport rollback

Partial Cashout Reasons (Optional)

Only needed with partial cashout feature :

partial settle
partial resettle
partial cancelsettle

Bonus Reasons (Optional)

Only needed with bonus system integration:

bonus award
bonus release
bonus limit release

Freebet Reasons (Optional)

Only needed with freebet integration:

freebet award
freebet
freebet release
rollback freebet
settle freebet
cancelsettle freebet
resettle freebet
OverviewExamples