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

# Quickstart

> Get your API key, expose your wallet callback, fetch games, and launch your first game session.

This guide walks you through the minimal steps to integrate your casino site with the PlayStarters aggregator.

<Steps>
  <Step title="Request access">
    [Contact the PlayStarters team](https://www.playstarters.io/en/contact) to receive:

    * Your **Operator API key** (format: `ps_<your_api_key>`).
    * The **base URL** for the Operator API.
    * A **wallet key** to authenticate incoming calls from PlayStarters to your wallet callback (this is your same API key — PlayStarters sends it as a `Bearer` token).
  </Step>

  <Step title="Expose your wallet callback">
    Implement a single `POST` endpoint on your backend (e.g. `https://api.yoursite.com/wallet-callback`) that handles `BALANCE`, `BET`, `WIN`, and `VOID` operations.

    Share the URL with the PlayStarters team. See [Seamless Wallet API](/api/wallet/overview) for the contract.
  </Step>

  <Step title="Fetch the games catalog">
    Call the Operator API to retrieve the list of providers and games enabled for your site.

    ```bash theme={null}
    curl -X GET https://api.playstarters.io/operator/games \
      -H "Authorization: ApiKey ps_YOUR_API_KEY"
    ```

    See [Fetch games](/api/operator/games) for filters and response schema.
  </Step>

  <Step title="Launch a game">
    Request a temporary game URL for a player and open it in an iframe or new window.

    ```bash theme={null}
    curl -X POST https://api.playstarters.io/operator/launch \
      -H "Authorization: ApiKey ps_YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "gameId": "game_uuid",
        "playerId": "your_unique_user_id",
        "currency": "EUR"
      }'
    ```

    See [Launch a game](/api/operator/launch).
  </Step>

  <Step title="Test end-to-end">
    With the wallet callback live and a game launched, PlayStarters will call your wallet endpoint with `BALANCE`, then `BET` / `WIN` / `VOID` as the player interacts with the game. Verify each transaction type is processed correctly and that your idempotency handling works.
  </Step>
</Steps>

<Tip>
  Store your API key as an environment variable (for example `PLAYSTARTERS_API_KEY`) — never commit it to source control.
</Tip>