Overview

CloudAggregator is a next-generation casino game aggregation platform that seamlessly connects online casino operators with a curated portfolio of world-class game providers. By integrating once with the CloudAggregator platform, operators gain immediate access to an extensive library of Slot Games, Rummy, Bingo, Lottery products — all through a single, unified API. This document provides comprehensive technical guidance for casino operators (referred to as "Operators" throughout this guide) on how to integrate their platforms with CloudAggregator. It covers accessing games list, authentication, game launch flows, wallet transaction handling, error management, and platform-specific considerations.

CloudAggregator acts as the middleware between your player-facing casino platform and the underlying game providers (GPs), handling all protocol translation, session management, and transaction routing transparently.

This document outlines the integration process for launching Rummy games via the aggregator platform. It covers:

Secure environment access
In‑game transaction APIs
Game launch flow
Fetching available games
Wallet integration requirements

Integration Architecture Overview

The CloudAggregator platform follows a two-sided integration model:

Operator → CloudAggregator: The Operator calls CloudAggregator APIs to launch games, retrieve game catalogs, and manage promotional content (Free Rounds, Jackpots, etc.).
CloudAggregator → Operator: CloudAggregator calls back to the Operator's wallet endpoint to perform balance queries and financial transactions (wager, result, refund, etc.) in real time.

This bidirectional architecture ensures that the player's wallet always resides with the Operator, giving you full control over funds while CloudAggregator manages the complexity of communicating with dozens of game providers.

Key Terms

Term	Definition
CloudAggregator	The game aggregation gateway platform (this service).
Operator	The licensed online casino or gaming platform integrating with CloudAggregator.
Game Provider (GP)	A company that supplies games, either by producing or reselling them. CloudAggregator connects to many GPs simultaneously.
Demo Mode	A play mode in which the player uses virtual credits. No real-money transactions are processed; wallet callbacks are suppressed.
Real Mode	A play mode in which the player wagers real money. Every transaction requires Operator wallet endpoint confirmation.
Operator ID	A unique identifier assigned to the Operator by CloudAggregator during onboarding.
Session ID	A unique identifier generated by the Operator each time a player launches a game. Max 36 characters; must be prefixed with the Operator ID (e.g., 42_abc123-xyz).
Transaction ID	A globally unique identifier for each financial transaction. Used as the idempotency key. Different GPs may share IDs, but each GP must produce unique IDs within itself.
Round ID	A grouping identifier that ties all wager and result transactions belonging to the same game round together.
FRB	Free Rounds Bonus — a promotional mechanic granting the player free spins or free game rounds.
Game Status	Indicates the state of a game round: pending (round still in progress) or completed (round closed).
Idempotency	The property of an operation that produces the same result regardless of how many times it is executed with the same input. CloudAggregator uses Transaction IDs as idempotency keys.
Open Round	A game round where a wager has been placed but no completed result has been received. Operators must handle open round scenarios gracefully.
Rollback	A transaction that reverses a previously placed wager when the corresponding result cannot be delivered due to a technical failure.
Jackpot	A special result transaction sent by CloudAggregator when a player wins a progressive or fixed jackpot prize.

API Parameter Standards

Parameter	Standard/Format	Notes
Currency	ISO 4217	Operators must register accepted currencies with CloudAggregator during onboarding.
Language	ISO 639-1 + ISO 3166-1 alpha-2	Format: {language}_{COUNTRY} e.g., en_US, sv_SE, de_DE.
Country	ISO 3166-1 alpha-2	Required in real mode; dummy value acceptable in demo mode.
Account ID	Alphanumeric [0-9a-zA-Z], max 32 chars	The Operator's internal player identifier. Must be consistent across all requests in a session.
Amounts	Decimal (18,2)	All monetary values are in the major currency unit (e.g., EUR, not cents). Max 2 decimal places.
Timestamps	ISO 8601 UTC	All timestamp fields use UTC timezone.
Boolean	true / false (lowercase string)