Skip to Content
WalletBonusesCash Bonus

Cash Bonus

Overview

Cash bonus awards money directly to the player’s cash balance without wagering requirements. The funds are immediately available for use or withdrawal.

Key characteristics:

  • No wagering requirements
  • Funds added directly to cash balance
  • Can be used in combination with bet insurance or bet collection (cashback)

Transaction Types

Cash bonus integration requires implementing one transaction type:

Transaction TypeReasonTypeDescription
Bonus Releasebonus releasereleaseAwards cash directly to player balance
Warning

Cash Bonus vs Sport Bonuses

Cash bonus transactions do NOT include SportBonusOfferId and SportBonusPlayerOfferId fields in the context object. These fields are only present in sport-related bonuses (Sport Bonus Amount, Freebet). Cash bonus uses platform: "CRM" and product: "crm" instead of sport-specific identifiers.

Transaction Example

Bonus Release

Cash is awarded directly to the player’s main balance.

When it happens:

  • Bonus conditions are met (if any)
  • Cashback is calculated and awarded
  • Insurance payout is triggered
Cash Bonus Release Request
{
  "currency": "USD",
  "platform": "CRM",
  "id": "{transactionId}",
  "type": "release",
  "initiatedAt": "2024-06-28T13:09:33.000Z",
  "createdAt": "2024-06-28T13:09:33.000Z",
  "context": {
    "product": "crm",
    "reason": "bonus release"
    // Note: SportBonusOfferId and SportBonusPlayerOfferId are NOT present
    // Cash bonus is a CRM product, not a sport bonus
  },
  "amountBreakdown": {
    "cash": "1000.0"  // Cash amount granted to user
  }
}

Response Format

Warning

Transaction Responses All transaction responses follow the same structure as requests, with the addition of:

  • balances - Updated player balances after the transaction
  • alreadyProcessed - Flag indicating if the transaction was already processed (idempotency)

Use Cases

Cash bonuses are commonly used with:

Bet Insurance

When a bet loses under specific conditions, the player receives a cash refund:

  • Player places a qualifying bet
  • Bet loses according to insurance conditions
  • Cash bonus is released to compensate the loss

Learn more about Cash Bonus with Conditions 

Bet Collection (Cashback)

Players receive a percentage of their losses back as cash:

  • System calculates cashback based on player activity
  • Cash bonus is released at specified intervals
  • No wagering requirements apply

Learn more about Cash Bonus without Conditions 

Additional Resources

For detailed configuration and use cases:

Lifecycle & ErrorsTaxes