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 Type	Reason	Type	Description
Bonus Release	`bonus release`	`release`	Awards cash directly to player balance

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¶

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: