Section 02

Technical concepts

Wallet types, catalog, currency and language.

Wallet Type#

The wallet type defines how the player's balance is communicated between your platform and the games. AIC Aggregator supports two types: with Seamless communication is continuous and real-time; with Transfer it happens at two moments, when the game session opens and when it closes.

Seamless Wallet#

The player's balance stays on your platform throughout the game. Every player action (bet, win, cancellation) triggers an immediate call from AIC to your API to query or move the balance, including:

The transaction amount
An operation identifier
The game session token, so you can reconcile every movement

Transfer Wallet#

When the game opens, the player's full balance is transferred to the game, which handles bets and wins internally. When the session closes, the resulting balance returns to your platform, reflecting what was won or lost during play.

How is the wallet type defined?#

There is no standard wallet type: it is agreed with you, supplier by supplier, based on the intent of your integration and the wallet types each supplier supports.

A single integration can combine both types (some suppliers on Seamless, others on Transfer). Your API must support the flows of the types you agree on.
Each game in the game list states its wallet type in the gameModel field (SEAMLESS or TRANSFER).

Tip

If your platform already works with suppliers on one wallet type, mention it during the agreement: it is usually the shortest path for a first integration.

Game catalog#

AIC enables for your project the catalog of the agreed suppliers, organized in categories such as Slots, Live, Crash, Fishing, Bingo, Arcade, Keno, Plinko and Jackpot, plus our own AIC Games catalog. The games available to your project are retrieved with getGameList; your platform decides which games to show and in what order.

Currency#

Each project operates in a single currency, defined at onboarding and fixed from then on. All amounts exchanged between AIC and your platform are expressed in that currency, which is why they carry no currency field.

Language and device#

When opening a game you can specify the language and device type (desktop or mobile). They apply when the game's supplier supports them.