Getting Started

This page walks you through the three integration methods, a step-by-step setup checklist, and the environment URLs you will need.

Choose your integration method

Unity Games

Best for: Unity 2022.3+ projects Time to integrate: ~30 minutes

Install the PlaySuper Unity SDK, initialize it with your API key, and call two methods — one to distribute coins and one to open the store:

// Use isDev: true for the development environment
PlaySuperUnitySDK.Initialize("YOUR_API_KEY", isDev: true);
PlaySuperUnitySDK.Instance.DistributeCoins(coinId, amount);
PlaySuperUnitySDK.Instance.OpenStore();

Follow the full walkthrough in the Unity SDK Guide.

WebView (any mobile app)

Best for: React Native, Flutter, native Android, or native iOS apps Time to integrate: ~1 hour

Load the PlaySuper store in a WebView, pass the player's credentials as query parameters, and wrap it in your own screen with a close button. The WebView Integration guide walks through the complete flow with ready-to-use snippets for Kotlin, Java, Swift, React Native, and Flutter.

Direct API Integration

Best for: Apps that need a fully custom rewards UI Time to integrate: 2–4 hours

Use the REST API directly to manage players, distribute coins, list rewards, and process purchases — then build your own frontend on top. See the API Reference for all available endpoints.

Step-by-step setup

Step 1: Create your account and game (5 min)

Sign in to the PlaySuper Console, create your organization and game, then generate an API key. The Console Setup Guide walks through each screen.

Step 2: Create a coin and link it to your game (5 min)

Open the Coins section in the console. Create a coin, set its conversion rate (how much real-world value one coin represents), and copy the coinId — you will pass it to every distribute or purchase call.

Then link the coin to your game from the game's page in the console — distribute and reward calls fail for unlinked coins. Organization-wide coins are linked to all your games automatically. See Console Setup: Link the coin.

Step 3: Integrate (30–60 min)

Pick the method that matches your app (Unity SDK, WebView, or REST API) and follow the corresponding guide linked above.

Step 4: Test and go live (1–2 hrs)

Use the development environment to verify coin distribution, store opening, and reward redemption. When ready, switch your API key and base URL to production.

Environments

Development

Production

United States

PlaySuper runs a separate, fully independent environment for the US region. Games integrating for a US audience must register on the US console:

Keep in mind:

• Registrations do not carry over between regions. An organization, game, or API key created on the standard console does not exist in the US environment (and vice versa) — complete the Console Setup steps again on the US console.
• Credentials are region-specific. The API key and coinId you generate on the US console only work against the US environment; using them with the standard endpoints returns 401 Unauthorized.
• Serving both audiences? Register your game in each region separately and route players to the right credentials based on their region.
• Same setup, same guides. The console flow (organization → game → coin → link coin → API key) and all integration guides in these docs apply unchanged — only the URLs differ.

Next steps