Get started

Quickstart

Settle your first round in the sandbox in five steps.

1. Get your credentials

Ask your KOI account manager for a sandbox partner account. Then, in the Back Office, generate an access token under Integration › Tokens.

2. Register your wallet endpoints

Under Integration › Webhooks, register your register, rewards, rollback and balance URLs. Each must answer as described in How the wallet works.

3. List your games

bash

curl https://api.koigames.app/games/activated \
  -H "Authorization: Bearer $KOI_ACCESS_TOKEN"

Pick a slug from the response.

4. Open a session

bash

curl -X POST https://api.koigames.app/games/request-access \
  -H "Authorization: Bearer $KOI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "player-123",
    "username": "Ana",
    "game": "amazonia-adventure",
    "currency": "BRL",
    "lang": "en-US"
  }'

json

{
  "game_url": "https://play.koigames.app/3f0c9a…",
  "session_token": "3f0c9a…"
}

Open game_url in a browser or an iframe.

5. Play and settle

Place a bet in the game. KOI calls your register endpoint with a signed payload. Verify the signature, debit the player and answer:

json

{ "old_balance": 100.00, "new_balance": 95.00, "operator_tx_id": "op-tx-9001" }

If the round pays, KOI calls rewards with the win. Credit it and answer with the same shape.

Before going live, work through the go-live checklist.