Free Round Bonuses

Free Round Bonuses

Info

Free Round Bonuses (FRBs) are promotional tools that allow casino operators to offer free spins to players. This section covers the complete lifecycle of Free Round Bonuses within the Groove platform.

Overview

Free Round Bonuses are a powerful marketing tool that allow casinos to:

  • Attract new players with risk-free gameplay offers
  • Re-engage existing players with promotional incentives
  • Reward loyal players with bonus gameplay
  • Promote specific games or game providers

The Groove API provides a comprehensive set of endpoints to manage the entire Free Round Bonus lifecycle, from template creation to player redemption and reporting.

FRB Lifecycle

graph TD A[Create FRB Template] -->|Define bonus parameters| B[Configure Template] B -->|Set game, wager, max win| C[Ready for Assignment] C -->|Assign to players| D[Grant FRB to Players] D -->|Bonus activation| E[Player Uses Bonus] E -->|Track usage| F[Monitor Status] F -->|Optional| G[Cancel Unused FRB] H[Create and Grant FRB] -->|Single operation: Create + Grant| E style A fill:#e6f7ff,stroke:#333,stroke-width:2px style B fill:#f0f0f0,stroke:#333,stroke-width:1px style C fill:#f0f0f0,stroke:#333,stroke-width:1px style D fill:#e6f7ff,stroke:#333,stroke-width:2px style E fill:#f0f0f0,stroke:#333,stroke-width:1px style F fill:#e6f7ff,stroke:#333,stroke-width:2px style G fill:#ffe6e6,stroke:#333,stroke-width:1px style H fill:#d4f1d4,stroke:#333,stroke-width:2px

Free Round Bonus Process Flow

The following sequence diagram illustrates how Free Round Bonuses are processed through the Groove platform:

sequenceDiagram participant Casino as Casino Operator participant Groove as Groove Platform participant Game as Game Provider participant Player Casino->>Groove: Create FRB Template Groove->>Casino: Template ID Response Casino->>Groove: Grant FRB to Player Groove->>Casino: FRB Assignment Confirmation Player->>Casino: Login & Launch Game Groove->>Game: Initialize Game with FRB Parameters Game->>Player: Display Game with Free Spins Available rect rgb(240, 240, 240) Note over Player,Casino: Free Spin Usage Player->>Game: Use Free Spin Game->>Groove: Wager Request (amount=0) Groove->>Casino: Forward Wager Request Casino->>Groove: Wager Response Groove->>Game: Forward Response Game->>Player: Display Spin Outcome Game->>Groove: Result Request (win amount) Groove->>Casino: Forward Result Request Casino->>Groove: Result Response Groove->>Game: Forward Response Game->>Player: Display Win & Updated Balance end Casino->>Groove: Get FRB Status Request Groove->>Casino: FRB Status Response alt Unused FRB Expiration Casino->>Groove: Cancel FRB Request Groove->>Casino: Cancel FRB Confirmation end

Key FRB Components

FRB Template

A template defines the parameters of a Free Round Bonus offer, including:

  • Eligible games
  • Number of free spins
  • Bet amount for each spin
  • Maximum win amount
  • Validity period

FRB Grant

The process of assigning a template-based bonus to a specific player or group of players.

FRB Status

Tracking mechanism for monitoring the usage and status of bonuses granted to players.

FRB Cancellation

Method for revoking unused bonuses when needed (e.g., expired offers).

Available FRB Operations

The Groove API provides the following endpoints for managing Free Round Bonuses:

Operation Description Endpoint
Create FRB Template Define bonus parameters /frb/create/{version}/template
Grant FRB to Players Assign bonus to players /frb/grant/{version}/players
Create and Grant FRB Create template and grant in single operation /frb/create/{version}/template-and-grant
Get FRB Status Check bonus usage status /frb/{version}/bonus?operator_id=XXXXX&template_id=XXXXX&player_id=XXXXX
FRB Metadata Retrieve bonus information /frb/games/{version}/metadata
Cancel FRB Revoke unused bonuses /frb/{version}/bonus?operator_id=XXXXX&template_id=XXXXX&player_id=XXXXX

Free Chips (Live Dealer Free Round Bonuses)

Info

Some game providers support **Free Chips**, which is the live dealer equivalent of Free Spins. Free Chips allow casino operators to offer free rounds on live dealer games (e.g., Blackjack, Roulette) using the same FRB API endpoints.

Free Chips work through the same API flow as standard Free Round Bonuses — the same endpoints are used for template creation, granting, status checks, and cancellation. The platform automatically routes the request to the correct flow (Free Spins or Free Chips) based on the game category.

Limitations

Warning

**Mixed game types are not supported.** A template must contain either all slot games or all live dealer games. Templates with a mix of slot and live dealer games will be rejected.

  • The chip value is determined by the provider’s available chip values. Operators must ensure the selected bet value is appropriate for live dealer games, where minimum bets are typically higher than slots.
  • Free Chips availability depends on provider support. Not all game providers support Free Chips for live dealer games.
  • The same template cannot contain both slot and live dealer games. If a mixed game list is submitted, the request will fail.

Implementation Guidelines

When implementing Free Round Bonuses, follow these best practices:

  1. Template Management

    • Create templates with clear identification and purpose
    • Set appropriate limits on maximum wins
    • Define reasonable validity periods

  2. Player Assignment

    • Target specific player segments for maximum effectiveness
    • Provide clear terms and conditions
    • Implement proper validation before granting

  3. Monitoring and Reporting

    • Regularly check bonus usage status
    • Analyze performance of different bonus offers
    • Maintain audit trails for all bonus activities

  4. Error Handling

    • Implement comprehensive error handling for all FRB operations
    • Handle edge cases like attempting to use expired bonuses
Warning

Free Round Bonuses must comply with relevant gambling regulations in your jurisdiction. Ensure your implementation meets all regulatory requirements regarding bonus offers and promotions.

Next Steps

Explore the specific FRB operations in the following sections to implement a complete Free Round Bonus system for your casino.