Get started
Environments & credentials
Use the sandbox to build and test. Production endpoints are issued during go-live.
Environments
| Environment | Partner API | Status |
|---|---|---|
| Sandbox | https://api.koigames.app | Available. Demo wallets only, no real money. |
| Production | Issued per partner | Provided with production credentials at go-live. |
All requests use HTTPS and JSON (Content-Type: application/json).
Access token
Your access token authenticates every request you send to KOI and signs every callback KOI sends to you.
Authorization: Bearer <access-token>Generate and view tokens in the KOI Back Office under Integration › Tokens. Treat the token as a password: keep it on your servers, never in a browser, a game client or a log.
Wallet endpoints
Register four HTTPS endpoints in the Back Office under Integration › Webhooks:
| Type | Called for | Page |
|---|---|---|
register | Debit a bet | Bet |
rewards | Credit a win | Win |
rollback | Revert a bet | Rollback |
balance | Read the player balance | Balance |
Your endpoints must be reachable from the internet over HTTPS and answer within the timeouts in Idempotency & retries.
Enabled games
KOI enables games per partner account. List games returns exactly the games your account can launch.