> ## Documentation Index
> Fetch the complete documentation index at: https://docs.smatvirtual.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Everything you need to integrate smatvirtual games into your platform.

**Smatvirtual** is a premium game provider specializing in high-speed, instant-result casino games and industry-leading tournament play. We focus on "Single-Player vs. Computer" dynamics and competitive, multi-user tournament structures that drive high engagement and rapid betting cycles.

## Our Core Product Pillars

We focus on two distinct gaming experiences designed for maximum retention and high-frequency action.

<CardGroup cols={2}>
  <Card title="Instant Games (Single Player)" icon="bolt">
    Our "Single Player vs. Computer" suite features high-speed titles like
    **Odd-Even** and **Spin & Win**. These are optimized for rapid betting
    cycles and instant result gratification.
  </Card>

  <Card title="Tournament Gaming (Flagship)" icon="trophy">
    A one-of-a-kind competitive experience. Our proprietary flagship engine
    allows players to compete against each other in real-time for leaderboard
    dominance and prize pools.
  </Card>
</CardGroup>

## The Unified Casino Gateway

To simplify integration for our partners, we have moved away from legacy subdomain-based mapping. All games in the **smatvirtual** catalog are now accessible via a **Unified Gateway**.

This architecture allows your team to:

* **Simplify Logic:** Interact with a single base URL for all game launches.
* **Dynamic Routing:** Our gateway automatically handles the routing to the specific game application based on the `gameId`.
* **Centralized Auth:** Use one consistent authentication method (`sv-api-key`) for every title in our suite.

## Integration Roadmap

Ready to bring **smatvirtual** games to your lobby? Follow our streamlined integration path:

### 1. Authentication

Secure your requests using your concatenated API key. This identifies your merchant status and operator environment in one header.
[Set up Authentication](/authentication)

### 2. Portfolio Synchronization

Fetch our full list of casino titles, including metadata like Game ID, Category, and localized assets.
[View Portfolio API](/api-reference/endpoint/get-games-list)

### 3. Session Initiation

Generate a signed launch URL to start a player session. This endpoint handles currency mapping and mode selection (Real vs. Demo).
[Explore Launch Logic](/launch-sequence)

## Technical Excellence

* **RNG Certified:** All games are powered by a certified Random Number Generator ensuring absolute fairness.
* **Seamless Wallet:** Real-time balance updates via our standard wallet handshake protocol.
* **No-Plugin Play:** Our entire suite is built on HTML5, requiring no external downloads or legacy plugins.

## Dynamic URL Resolution

To simplify integration, **smatvirtual** uses a Smart Link Generation system. Instead of your team maintaining a manual list of game URLs and subdomains, our API handles the logic for you.

### How it works:

1. **Request:** Your system calls our `launch-url` endpoint with a `gameId`.
2. **Resolution:** Our gateway identifies the specific application hosting that game (Instant or Tournament).
3. **Response:** We return a fully-constructed, signed URL (e.g., `https://tournament.smatvirtual.com/play?token=...`).
4. **Handoff:** Your platform simply redirects the player to the provided URL.

### Benefits for Developers:

* **Zero Maintenance:** When we add new games or move a game to a new server, you don't need to update a single line of code.
* **Security:** Every URL returned is unique to the player session and time-limited.
* **Scalability:** Since our gateway only returns the URL string and doesn't "proxy" the game traffic, your integration remains lightning-fast.

***

### Support & Staging

Integrate and test with confidence using our dedicated staging environment.

**Staging Base URL:** `https://api-staging.smatvirtual.com/api/v1.1/`