Возможности

API отчётов

Три метода POST /gameActions.do только для чтения дают отчёты по вашему проекту. Они аутентифицируются как остальные методы оператора: partner, api_key и разрешённый IP (Аутентификация). Ничего не меняют и имеют собственную квоту лимитов.

Основа отчётов — список операций кошелька, которые платформа отправляла вам (bet, win, refund). Деньги двигают только операции, которые ваш кошелёк подтвердил; остальные показаны как ожидающие. Суммы — десятичные строки в валюте кошелька; время — UTC ISO 8601.

report_rounds#

История раундов, новые первыми.

{"method": "report_rounds", "partner": "YOUR_PARTNER_ID", "api_key": "YOUR_API_KEY",
 "player_id": "player-123", "from": "2026-10-01", "to": "2026-10-16", "limit": 100}

{
  "status": "ok",
  "rounds": [{
    "round_id": "b2a7…", "player_id": "player-123", "symbol": "gates-of-olympus", "currency": "UAH", "mode": "spin",
    "state": "settled", "free_spin": false,
    "bet": {"amount": "1.50", "status": "confirmed"},
    "win": {"amount": "12.75", "status": "confirmed"},
    "refund": {"amount": null, "status": null},
    "cancel_reason": null, "created_at": "2026-10-15T12:00:00.000Z", "settled_at": "2026-10-15T12:00:03.000Z"
  }],
  "next_cursor": "eyJ0Ijoi…"
}

state — одно из settled, debit_pending, in_progress, credit_pending, rejected (ваш кошелёк отказал в ставке), cancelled (отмена и возврат) и reconciliation_required. bet.status, win.status и refund.status — planned, sent, unknown, confirmed или rejected (null, если такой операции нет). У фриспин-раунда bet.amount равен 0.00, а free_spin — true.

report_ggr#

Валовый игровой доход по подтверждённым операциям кошелька: ggr = ставки − возвраты − выигрыши.

{"method": "report_ggr", "partner": "YOUR_PARTNER_ID", "api_key": "YOUR_API_KEY",
 "from": "2026-10-01", "to": "2026-11-01", "group_by": ["day", "symbol", "currency"]}

{
  "status": "ok", "period": {"from": "2026-10-01T00:00:00.000Z", "to": "2026-11-01T00:00:00.000Z"}, "group_by": ["day", "symbol", "currency"],
  "rows": [{"day": "2026-10-15", "symbol": "gates-of-olympus", "currency": "UAH",
    "rounds": 120, "cancelled_rounds": 1, "free_spin_rounds": 4,
    "bets": "180.00", "wins": "171.30", "refunds": "1.50", "ggr": "7.20", "pending_operations": 0}]
}

Суммы даны в валюте строки; суммы разных валют не складывайте. pending_operations — число раундов, у которых ещё есть неподтверждённая операция: их деньги в итогах пока не учтены.

report_reconciliation#

Итоги по игроку и валюте для сверки с вашим учётом.

{"method": "report_reconciliation", "partner": "YOUR_PARTNER_ID", "api_key": "YOUR_API_KEY",
 "from": "2026-10-15", "to": "2026-10-16", "limit": 200}

Фильтры player_id, currency, from, to (по времени операции кошелька); пагинация limit 1–1000 (по умолчанию 200) и cursor.

{
  "status": "ok",
  "players": [{"player_id": "player-123", "currency": "UAH",
    "bets": "7.00", "wins": "3.50", "refunds": "5.00", "net_wallet_change": "1.50",
    "bet_count": 2, "win_count": 1, "refund_count": 1,
    "pending": {"operations": 0, "refunds": "0.00", "wins": "0.00"}}],
  "next_cursor": null
}

net_wallet_change = выигрыши + возвраты − ставки по подтверждённым операциям: изменение вашего кошелька от операций платформы за период. Если оно расходится с вашим учётом для того же игрока, валюты и периода, посмотрите блок pending и report_rounds для деталей по раундам.

Ошибки#

INVALID_PERIOD, INVALID_CURSOR, INVALID_GROUP_BY, INVALID_CURRENCY, INVALID_STATE, INVALID_LIMIT, INVALID_FROM, INVALID_TO, INVALID_PLAYER_ID, INVALID_SYMBOL, INVALID_ROUND_ID, INVALID_REQUEST (неизвестное поле) и общие; см. справочник ошибок.