Skip to main content
Before a game session begins, the smatvirtual gateway needs to verify the player’s identity and their current wallet balance. To do this, you must provide a Details URL in your Merchant Dashboard.

​
The Handshake Flow

  1. Trigger: A player clicks “Play” and your system calls our /games/generate-launch-url API.
  2. Verification: Our system immediately makes a GET request to your Details URL.
  3. Response: Your server returns the player’s balance and currency.
  4. Launch: If successful, the game loads with the player’s actual funds.

​
Your Endpoint Specification

Our server will call your provided endpoint with the following query parameters:

​
Expected Response

Your server must return a JSON object in the following format:
Currency Format: Use standard ISO shortcodes (e.g., NGN, USD, GHS). Ensure the balance is returned as a number or a high-precision string to avoid rounding errors.

​
Security & Reliability

  • Whitelist our IP: Ensure your firewall allows incoming requests from the smatvirtual gateway.
  • Latency: This request happens in real-time while the player is waiting for the game to load. Your endpoint should respond in under 200ms.