Getting Started

Reference guide and implementation details for getting started.

Getting started with Aggregator is straightforward. If you run into any issues, please contact support.

Account Setup

1. Create an Account — Register a Aggregator account using the registration form.
2. Verify Your Email — Confirm your email from the backoffice after registration.
3. Configure Callback URL — In Settings, set the endpoint that receives game and balance callbacks.
4. Retrieve API Base URL — Copy it from Settings. All method calls go here.
5. Generate API Credentials — Every request needs api_login and api_password.
6. Whitelist Server IPs — Requests from other IPs are blocked.
7. Integrate the API — Try a method in the API Console, or import the Postman collection.

API Requests

All game-server requests are POST with a JSON body. Always include:

{
  "api_login": "your-api-login",
  "api_password": "your-api-password"
}

Callback Communication

The game server sends GET requests to your callback URL. Respond with JSON:

• error — error code
• balance — integer in cents ($2.50 → 250)

Always HTTP 200. If you cannot resolve the player, return balance 0.

Successful Response

{ "error": 0, "balance": 250 }

Insufficient Balance

{ "error": 1, "balance": 250 }

Processing Error

{ "error": 2, "balance": 0 }

Default API Sequence

Open a Real-Money Game Session

Open a Demo Game Session

Open a Free Spins Bonus Game Session

Then check packages with getFreeRounds. Cancel with deleteFreeRounds.

Supported Game Currencies

Use the currency id when creating a player and opening a game.

Supported Game Languages

Use the language id when opening a game.