Skip to content

Version History

This document tracks all versions of the Game Provider Integration API.

Version Date Type Description
1.3.0 2026-04-21 Update CLOSE_ROUND action added — a round-level notification delivered on /deposit for server-driven titles (Aviadrone). No money moves; payload carries aggregated aviadroneCashOutCoefficients + aviadroneBets attributes.
1.2.0 2026-04-15 Update Aviadrone (server-driven) support documented; ROLL_BACK action added; full error-code catalog; signature and retry semantics clarified.
1.1.0 2024-12-24 Update Removed old_balance and updated Launch API docs.
1.0.0 2024-12-11 Release Initial launch of Game Provider Platform.

1.3.0 – Close Round Notification

Date: 2026-04-21

Changes

  • Wallet API:
    • Added CLOSE_ROUND action, delivered on the existing /deposit endpoint — no new operator endpoint required.
    • CLOSE_ROUND is a notification, not a transaction: amount is always 0, and session_token / user_id / withdraw_provider_tx_id are intentionally omitted. Authentication is per-request via HMAC (X-Public-Key + X-Signature), as with all other callbacks.
    • Emitted once per (round_id, operator) after every per-bet callback for that round has been delivered and acknowledged.
    • Introduced two new attribute names:
      • aviadroneCashOutCoefficients — JSON-encoded array of per-bet cashout multipliers (0 for lost bets).
      • aviadroneBets — JSON-encoded array of per-bet stakes in millis. Positionally aligned with the coefficients array.
    • Deterministic idempotency: the wire-level provider_tx_id maps 1:1 to {round_id}-{operator_id}-close-round, so retries are safe to return the cached response.
    • Added operator implementation checklist, parsing code samples (Python / Java / Go), and an example payload for an all-lost round.
  • Integration Overview:
    • Updated the /deposit row to list CLOSE_ROUND alongside WIN, FREE_BET_WIN, and ROLL_BACK.
    • Extended the Server-Driven flow diagram with the trailing CLOSE_ROUND callback.
    • Added a checklist item for CLOSE_ROUND handling.

Operator action required

None for existing classic (iframe) integrations. Server-driven integrations (Aviadrone) must accept action: "CLOSE_ROUND" on /deposit and respond 200 — see the Close Round Operator Implementation Checklist.

1.2.0 – Server-Driven Games & Rollback

Date: 2026-04-16

Changes

  • Game List API (new page):
    • Documented GET /api/v1/games?operatorId={id} returning the catalog available to the operator, with full GameDto field reference.
  • Gift API (full rewrite):
    • Explicit millis-only money model reiterated at the top of the page and on every field that carries an amount (betLevel, free-bet win amounts).
    • Full request/response schemas for Grant and Cancel with every field (type, required, description).
    • Documented partial-success response semantics (per-gift granted + code).
    • Added Gift Lifecycle table (ACTIVE / COMPLETED / CANCELED / EXPIRED).
    • Linked FREE_BET / FREE_BET_WIN wallet callbacks to the gift lifecycle with exact payload examples.
    • Added per-endpoint error-code table keyed off the real ErrorCode enum.
    • Added pre-launch operator checklist.
  • Wallet API:
    • Added ROLL_BACK action, delivered on the existing /deposit endpoint — no new operator endpoint required.
    • Auth response fields minbet and maxwin documented (already supported by the platform).
    • Idempotency behavior clarified: same provider_tx_id, same body, same signature on every retry.
    • Added explicit retry schedule (5s base, 2m max, 300ms jitter, 5 attempts).
  • Authentication & Security:
    • Clarified that X-Signature is Base64-encoded and computed over the raw request body bytes (no re-serialization).
    • Recommended constant-time comparison.
  • Error Handling:
    • Replaced generic 5-code table with the full Game Provider error-code catalog, grouped by area.
  • Session Management:
    • Corrected inactivity timeout from 30 min → 15 min (matches platform default).
  • Launch API:
    • Clarified that the single /api/v1/launch/{game} endpoint serves both classic iframe titles and server-driven titles (e.g. aviadrone).
  • Docs structure:
    • Renamed Webhooks → Callbacks to reflect the synchronous HTTP model.
    • Added "What You Will Implement" summary and integration checklist.

1.1.0 – Wallet & Launch Update

Date: 2024-12-24

Changes

  • Wallet API:
    • Removed old_balance field from standard withdraw/deposit responses (simplification).
  • Launch API:
    • Updated required and optional parameters (added portalMode, skinId, etc.).
    • Removed operatorId from request (now inferred from X-Public-Key).
    • Renamed device to platform in the constructed launch_url.
    • Explicitly documented required headers (X-Public-Key, User-Agent).
  • Fixes:
    • Cleaned up redundant diagrams in the overview.

1.0.0 – Initial Release

Date: 2024-12-11

Features

  • Platform: Rebrand to Game Provider Integration.
  • Game Launch: Added support for Chicken Race.
  • Wallet API:
    • Standardized BET, WIN, BALANCE and AUTH endpoints.
    • Currency: All amounts are defined in millis (1/1000th unit).
    • Security: HMAC SHA256 signature validation with X-Public-Key.
  • Gift API:
    • New Inbound API for granting and canceling Free Bets.
  • Documentation:
    • Added multi-language code samples for signature handling.
    • Added best-practice guidelines for Idempotency.