Introduction

Groove API Documentation

Info

**Welcome to the Groove API Documentation.** This guide provides comprehensive information for integrating with the Groove Technology Aggregation platform.

Overview

Groove Technology Aggregation is a one-stop solution for all casino content needs. The platform connects casino operators to an ever-expanding collection of games, from the latest releases to all-time classics.

Through the Groove API, casino operators can access content from more than 100 game providers with minimal integration effort. One single integration opens a new world of gaming content for your players!

Groove API Groove API

Core Features

  • Game Aggregation - Access to games from over 100 providers through a single integration
  • Unified Wallet - Seamless transaction handling across all games
  • Free Round Bonuses - Create and manage bonus offers across the platform
  • Detailed Reporting - Access comprehensive game history and transaction data
  • Sportsbook Integration - Dedicated support for sportsbook products

System Architecture

The Groove API uses a RESTful architecture with standard HTTP requests and JSON responses. All API endpoints are secured with authentication to ensure the safety of player data and transactions.

graph TD A[Casino Operator] <-->|API Integration| B[Groove Platform] B <--> C1[Game Provider 1] B <--> C2[Game Provider 2] B <--> C3[Game Provider 3] B <--> C4[Game Provider n] style A fill:#f5f5f5,stroke:#333,stroke-width:2px style B fill:#e6f7ff,stroke:#333,stroke-width:2px style C1 fill:#f0f0f0,stroke:#333,stroke-width:1px style C2 fill:#f0f0f0,stroke:#333,stroke-width:1px style C3 fill:#f0f0f0,stroke:#333,stroke-width:1px style C4 fill:#f0f0f0,stroke:#333,stroke-width:1px

General Flow Diagram

The diagram below illustrates the core workflow when a player interacts with a game through the Groove platform:

sequenceDiagram participant Player participant Casino as Casino Operator participant Groove as Groove Platform participant Game as Game Provider Player->>Casino: Login & Browse Games Casino->>Groove: Request Game Launch Groove->>Casino: Generate Game URL Casino->>Player: Present Game Interface rect rgb(240, 240, 240) Note over Player,Game: Gameplay Transactions Player->>Game: Initiate Game Action Game->>Groove: Send Transaction Request Groove->>Casino: Forward Transaction (Wager/Result) Casino->>Groove: Process Transaction & Return Balance Groove->>Game: Update Player Balance Game->>Player: Display Game Outcome end Player->>Game: Exit Game Game->>Groove: End Session Groove->>Casino: Update Session Status

Integration Process

Integrating with the Groove API involves the following steps:

  1. Setup Phase

    • Receive API credentials from Groove
    • Configure endpoints and security settings
    • Set up webhook URLs for notifications

  2. Basic Integration

    • Implement player authentication
    • Setup balance management endpoints
    • Integrate game launch functionality

  3. Transaction Processing

    • Implement wager and result handling
    • Setup rollback processing
    • Configure jackpot management

  4. Advanced Features

    • Free Round Bonus integration
    • Game history and reporting
    • Marketing tools integration

Documentation Structure

This documentation is organized into the following main sections:

  1. Introduction - Overview and key concepts
  2. Start Game - Game initialization process
  3. Transaction API - Handling wagers, results, and balance management
  4. Free Round Bonuses - Setting up and managing bonuses
  5. Games from Sinatra - Accessing the game catalog and history
  6. Appendices - Status codes, sportsbook integration, and FAQs
Tip

For a better understanding of terminology used throughout this documentation, please refer to the [Definition of Terms](/introduction/definition-of-terms/) page.

Getting Started

To begin your integration with the Groove API, we recommend following these steps:

  1. Review the Definition of Terms to understand key concepts
  2. Explore the Start Game process to learn how to launch games
  3. Study the Transaction API to implement financial transactions
  4. Contact your Groove account manager for credentials and testing environment access
Warning

All integrations must be thoroughly tested in the staging environment before going live. Please ensure all transaction types and error scenarios are properly handled.