Skip to main content
Seamless Integration lets you manage your players’ balances directly in your own system. Instead of storing funds with iGamingAce, your backend remains the source of truth — the API sends callback requests to your server to check balances and apply updates as bets and wins occur. This gives you full control over deposits, withdrawals, transaction history, and statistics across every game session.

​
Basic insights

Seamless Integration is built around a bidirectional flow: your casino calls the iGamingAce API to launch games, and iGamingAce calls your backend to read and write player balances during gameplay.
  • iGamingAce sends callback requests to your server to retrieve each player’s current balance and verify their authority before processing bets
  • Your backend is updated on every bet and win, keeping balances in sync in real time
  • Player funds remain entirely within your system, protecting you from any potential malicious activity by an API provider
  • You can integrate multiple game APIs within the same casino without conflicts — each API operates against your unified backend
  • If a bet or win is not processed correctly due to an unexpected error, all funds are automatically refunded so players never lose money due to a system failure

​
Process flow

1

Creating players

Before a player can launch any game, you must link them to the iGamingAce API so the system can identify who is playing. Your existing casino user table is not automatically visible to iGamingAce — you need to explicitly create the association.Once a player is linked, iGamingAce assigns them a unique string called playerId. This becomes the player’s permanent identifier within your system and can be referenced in all subsequent API calls.We recommend calling the player-link endpoint every time a player signs in to your platform. This keeps the association current and ensures accurate tracking, authentication, and session continuity across all game launches.
2

Game launch

When a player selects a game, your casino calls the iGamingAce API to request a one-time-use game URL. The API generates a short-lived URL tied to that specific player and session. Your casino then redirects the player’s browser to that URL, which loads the game directly.The URL is single-use and expires after the session begins, so a new URL must be requested each time a player opens a game. From this point on, the game handles input from the player and communicates back to your server via callbacks.
3

Game play

Once the game is running, the player places bets. For each spin or round:
  • iGamingAce generates the result based on your casino’s configured RTP settings
  • The transaction is recorded in the game’s history
  • The API sends a callback to your server to deduct the bet amount and, if applicable, credit any winnings
If a bet or win cannot be processed correctly due to an unexpected issue, iGamingAce automatically rolls back the transaction and refunds all funds to the player. No manual intervention is required.

​
Integration roadmap

Follow these four steps in order to go live with Seamless Integration.
1

Setting a callback URL

A callback URL is the endpoint on your server that iGamingAce will call during gameplay to check balances and post transaction results. To register it, navigate to [Settings] in the iGamingAce back office.The URL must begin with http:// or https:// — for example, https://yourcasino.com/callback. After saving, allow up to 10 minutes for the change to propagate to the live servers.
2

Writing callback processing code

Create a server-side endpoint at the callback URL you registered. This endpoint is responsible for handling all balance-related requests from iGamingAce during active game sessions.Your endpoint must:
  1. Listen for POST requests — iGamingAce sends all callbacks as HTTP POST requests
  2. Parse the JSON body — each request contains structured data describing the transaction or balance inquiry
  3. Return balance and status — respond with the player’s current balance and a statusCode indicating success or failure
For the full request and response specifications, see the Seamless Wallet API reference page.
You are responsible for any failures resulting from incomplete or incorrect implementation of the callback endpoint. Unhandled callbacks can cause transaction errors and player-facing disruptions.
3

Game testing

Once your callback endpoint passes all automated tests, use the Main API endpoints to run end-to-end game tests with real game sessions. Verify that balances update correctly in your system as bets and wins are processed during actual gameplay.