PlaySuperWebView Integration Overview
Embed the PlaySuper store in native Android, iOS, React Native, and Flutter apps — no Unity SDK required
If your app is not built with Unity — a native Android Studio project, an iOS app, React Native, or Flutter — you can still offer the full PlaySuper store experience by loading it in a WebView. Your app handles authentication via the REST API, then opens the store URL with the player's credentials attached.
Prerequisites: Complete the Console Setup Guide first so you have your API key and coin ID ready. Coin distribution and other server-side operations use the REST API directly.
How it works
- Your app registers and logs in the player through the REST API to obtain an access token.
- Your app opens the store URL in a WebView with the API key and token as query parameters — the store picks them up automatically on first render.
- Your app wraps the WebView in its own screen with its own close/back control (e.g. a toolbar button), so the player can return to the game at any time.
- Your backend distributes coins and receives transaction notifications via the REST API and webhooks — no SDK involved.
What you can do with this integration
- Manage players — create and authenticate players using your app's internal IDs
- Open the store — launch the full PlaySuper rewards store inside your app, with optional deep-linking
- Distribute coins — award coins from your backend when players complete actions
- Check balances and orders — fetch coin balances and purchase history via REST
- React to purchases — receive server-side webhook notifications when players spend or are refunded coins
- Handle multiple players — cleanly switch accounts on the same device with session clearing
Integration steps
Follow these guides in order:
| Step | Guide | What you will do |
|---|---|---|
| 1 | Authentication | Create the player and obtain an access token via the REST API |
| 2 | Store URL | Build the store URL with credentials, deep links, and analytics tags |
| 3 | WebView Setup | Configure the WebView, orientation, and close/back controls |
| 4 | Platform Examples | Complete screens for Kotlin, Java, Swift, React Native, and Flutter |
| 5 | Session Management | Handle token expiry, logout, and switching players |
| 6 | Coins & Transactions | Distribute coins, check balances, and react to store purchases |
| 7 | Complete Example | Full backend + client flow, plus troubleshooting |
If your game is built with Unity, use the Unity SDK instead — it wraps this entire flow and adds offline queuing and transaction sync.
Support
- Email: engineering@playsuper.club