Skip to content

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:

Operation Type Reason Direction Description
Sport Bet withdrawal bet Money out Standard bet placement
Sport Rollback Bet rollback sport rollback Reverse Cancel bet and return funds
Sport Settle deposit settle Money in Bet settlement (win/lose/return)
Sport Resettle (positive) deposit resettle Money in Adjust settlement with additional payout
Sport Resettle (negative) withdrawal resettle Money out Adjust settlement by taking back funds
Sport Cancel Settle withdrawal cancelsettle Money out Revert 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)

Example scenarios:

Scenario Transaction Flow Explanation
Event cancelled after settlement Cancel Settle → Settle (return) Original settlement removed, bet refunded
Wrong outcome applied Cancel Settle → Settle (correct) Original settlement removed, correct result applied
Odds correction Resettle (adjustment amount) Direct payout adjustment without full reversal
Partial payout correction Resettle (adjustment amount) Add or remove funds based on 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).

Partial Cashout Operations (Optional - Requires Configuration)

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

Operation Type Reason Direction Description
Sport Partial Settle deposit partial settle Money in Partial bet settlement (cashout)
Sport Partial Resettle (pos) deposit partial resettle Money in Adjust partial settlement with payout
Sport Partial Resettle (neg) withdrawal partial resettle Money out Adjust partial settlement by taking back
Sport Partial Cancel Settle withdrawal partial cancelsettle Money out Revert previous partial settlement

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:

Operation Type Reason Direction Description
Sport Bonus Award award bonus award Bonus in Grant bonus with wagering requirements
Sport Bonus Release (limited) release bonus limit release Bonus out Convert bonus to cash (with max limit)
Sport Bonus Retract retract bonus release Bonus out Remove 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:

Operation Type Reason Direction Description
Sport Freebet Award award freebet award Bonus in Grant freebet to player
Sport Freebet Bet withdrawal freebet Bonus out Place bet using freebet
Sport Freebet Rollback rollback rollback freebet Reverse Cancel freebet bet and return freebet
Sport Freebet Settle deposit settle freebet Money in Settle freebet bet (winnings only)
Sport Freebet Cancel Settle withdrawal cancelsettle freebet Money out Revert freebet settlement
Sport Freebet Resettle (pos) deposit resettle freebet Money in Adjust freebet settlement with additional payout
Sport Freebet Resettle (neg) withdrawal resettle freebet Money out Adjust freebet settlement by taking back funds
Sport Freebet Retract retract freebet release Bonus out Remove unused freebet

Learn more: Freebet Integration Guide

Transaction Types

All possible transaction type values:

Type Required Description Used For
withdrawal Yes Deduct funds from player balance Bets, cancel settlements, negative resets
deposit Yes Add funds to player balance Settlements, winnings, positive resets
rollback Yes Reverse a previous transaction Bet cancellations, freebet rollbacks
award Optional Grant bonus funds to player (bonus integration only) Bonus awards, freebet awards
release Optional Convert bonus to cash or remove with limit (bonus integration only) Bonus wagering completion
retract Optional Remove 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