How to Integrate VFairGames — Launch URL and Partner Wallet

Learn how to integrate VFairGames — POST launch URL, partner wallet balance and transaction API, demo vs real, and what operators own.

VFairGames partner integration — launch URL and wallet API

How to integrate VFairGames is two server-to-server flows: your backend requests a game launch URL, and VFairGames calls your wallet API to read balance and settle bets. Players open the returned URL (iframe or redirect). You do not proxy gameplay traffic.

This guide is a practical overview for operators and engineers. Full API detail lives in partner docs. Product and custom-build offers: services.

Architecture in one picture

Your backend                         VFair API
     │  POST /api/launch (partner JWT)
     ├───────────────────────────────────►  { url }
     │
     │  GET  /balance
     │  POST /transaction
     │◄───────────────────────────────────
Player browser ── game URL ──────────────►  game + session

Step 1 — Launch a game URL

Your backend calls VFairGames with a partner JWT (subject = partner code; IP allow-listing applies):

  • Endpoint: POST https://games-api.vfair.games/api/launch
  • Response includes a URL for that player and game (v_dice, v_limbo, v_mines, v_plinko, v_keno)

Open that URL in an iframe or as a redirect. The game client talks to VFairGames directly.

Docs: Launch URL.

Step 2 — Host a partner wallet

In real mode, VFairGames calls endpoints you host:

  • GET {walletUrl}/balance
  • POST {walletUrl}/transaction

You keep player balances on your side. VFairGames does not need an in-app house escrow to run originals.

In demo mode there is no session wallet traffic — useful to evaluate UX before go-live.

Docs: Wallet API, Authorization.

What partners typically configure

  • Enabled games and currencies
  • RTP where supported (Dice, Limbo, Mines — see configurable RTP)
  • Theme / branding
  • Per-currency bet limits and maxWin caps

Fairness stays HMAC-SHA256 across the catalogue. Players (and you) can re-check rounds at verify.vfair.games. Related: How to verify a result.

Open-source games and custom builds

Integrate the open-source catalogue today, or ask for a custom game when the product needs something new — same partner contact path. See Services and email info@vfair.games.

FAQ

Do I proxy Socket.IO or game assets?

No. Launch returns a URL; the client connects to VFairGames. You own wallet and player account flows.

What is demo mode for?

Evaluation without wallet settlement. Switch to real when balance and transaction endpoints are ready.

Where is the full API reference?

docs.vfair.games — overview, launch, wallet, authorization, and API reference (including verification launch and round fairness).