Platform API Auth

The Platform API Gateway is how your backend systems feed data into the Gamanza Engage Platform (PEP). Ingesting player data and publishing real-time events. Every request to it must be authenticated with OAuth 2.0 using the client credentials grant: your system exchanges a Client ID and Client Secret for a short-lived access token, then sends that token to authorize its calls. This is service-to-service access, your backend acts as itself, not on behalf of a player.

How it works

1. Create credentials: in the PEP Admin dashboard, go to Settings > System Settings > Platform Integration > OAuth Clients and generate a Client ID and Client Secret. Store the secret securely; it is shown only once.
2. Request an access token: call the token endpoint with your clientId and clientSecret to receive an accessToken.
3. Authorize your calls: send the access token with each Platform API request. Reuse the token across calls and request a new one only when it expires, rather than generating one per request.

Reference

• Platform Authorization API — OAuth 2.0 — API overview and schemas. Use the Export button there to download the OpenAPI spec.
• Generate access token — the POST /api/oauth/v1/token endpoint: request/response details and a try-it console.

dica

For the full onboarding walkthrough — where to find System Settings and step-by-step screenshots for creating your OAuth credentials — see the Integration Process guide.