Getting Started

Getting Started

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

Account Setup

Create an Account

Register a Waija account using the registration form (opens in a new tab).

Verify Your Email

Confirm your email address from the backoffice after registration.

Configure Callback URL

In the Settings section, set your callback URL. This endpoint will receive all game and balance callbacks.

Retrieve API Base URL

From the Settings section, copy your API Base URL. All API requests must be sent to this address.

Generate API Credentials

In Settings, generate your API credentials. These credentials are required for every API request.

Whitelist Server IPs

Add your server IP addresses to the whitelist and save the changes. Requests from non-whitelisted IPs will be blocked.

Integrate the API

Use the provided endpoints and credentials to complete the Waija integration.

PHP Client

If your project uses PHP, we provide a Composer package to speed up integration.

API Requests

All requests to the game server should be sent as POST requests with a JSON body.

Your request body must always include api_login and api_password.
You can find these credentials in the backoffice.

{
  "api_login": "d13b1ceb-6209-4163-b1cf-f304c28b81ec",
  "api_password": "dqRin2nfLosij2n88"
}

Callback Communication

Our game server sends GET requests to your callback URL and expects a JSON response containing:

  • error (error code)
  • balance (player balance)

If you cannot retrieve the player balance for any reason, return 0.

Balance must be an integer in cents.
Example: a balance of 2.50$ must be returned as 250.

Successful Response

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

Insufficient Balance Response

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

Processing Error

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

Default API Sequence

Open a Real-Money Game Session

OrderAPI MethodDocs
#1createPlayerread
#2getGameread

Open a Demo Game Session

OrderAPI MethodDocs
#1getGameDemoread

Open a Free Spins Bonus Game Session

OrderAPI MethodDocs
#1createPlayerread
#2addFreeRoundsread
#3getGameread

Supported Game Currencies

Use the currency ID when creating a player and opening a game session.

Additional currencies may be available on request depending on your project and game provider.

idcurrencysymbol
USDUS Dollar$
EUREuro€
GBPBritish Pound£
BRLBrazillian RealR$
AUDAustralian DollarAU$
CADCanadian DollarCA$
NZDNew Zealand Dollar$
TNDTunisian DinarDT

Supported Game Languages

Use the language ID when opening a game to set the game language.

idlanguage
enEnglish
frFrench
deGerman
trTurkish
ruRussian
nlDutch
ptPortuguese
esSpanish