Skip to documentation
GAME_ALLIGATOR
ProductsGamificationIntegrationDemos
Let’s talk
ProductsGamificationIntegrationDemos
Let’s talk
Integration
OverviewGuidesAPI referenceResources
Integration overview
Integration architectureFundamentalsGetting startedCertification
Products
Aggregation
Part I · Fundamentals
Core flowRequest & signingEnvelope, money and data formatsErrors: one modelIdempotency & retriesRate limits, pagination, networkMoney Path Rules
Part II · Operator API
Getting startedGames APIWallet APIFree rounds APIReports APIFeatures APIEvent stream
Part III · Certification
Run the checks from the Operator PortalThe command-line tool (for your CI)The checklistCertification checklist
Part IV · Changelog and status
ChangelogDocument ControlChangelog & migration guide: Operator API v2
Appendix
Numbers to rememberWhole guide on one page
API reference
Get player balanceAuthenticate player sessionDebit player balance (bet)Credit player balance (win/bonus)Atomic debit and creditRollback transactionClose game roundSettle free-round grantReconcile uncertain transactionNon-financial notificationgetCapabilitieslistGamesupdateGamelaunchGamelaunchDemocloseSessionlistSessionslistRoundsexportRoundsgetAggregatesissueGrantlistGrantscancelGrantsubscribeackgetOperatorCapabilitiesgetGameFeatureslistBonusBuyTypesissueBonusBuycancelBonusBuygetJackpotsgetBetRangesgetRoundReplaygetRoundDetailslistCampaignscancelCampaignqueryProviderTransactionslistTournamentsgetTournamentgetLeaderboard
Gamification
Integration
Quick startWidgets on your siteSigned-in playersLaunching gamesGameplay eventsTransportsOutcomes and your obligationsGame cataloguesRewardsOnboarding and go-liveReasons, numbers, currencies
Poker
Integration
OverviewEmbed the poker clientServer APIEvents and webhooks
llms-full.txt
Start here
Aggregation / Part I · FundamentalsCore flow

Game Alligators (GA) puts game studios' games into your casino. Traffic runs in two directions, each with its own key pair. Don't mix them. Direction Who calls whom What it's for Key you use Chapter You → GA You call https://api.rexplay.sit

Aggregation / Part I · FundamentalsRequest & signing

Every call GA sends to your wallet looks like this: http POST /v2/wallet/debit HTTP/1.1 Host: wallet.operator.example Content Type: application/json X API Key Id: key live 01 X Request Id: 0198a1d0 9a30 7f08 a7dd 713e4fd33db0 Idempotency Ke

Aggregation / Part I · FundamentalsEnvelope, money and data formats

Every wallet request has the same outer shape. payload is the action specific part and the per call ids live in payload.meta . json { "request id": "0198a1d0 9a30 7f08 a7dd 713e4fd33db0", "ts": "2026 09 13T12:00:00Z", "operator id": "0197aa

Aggregation / Part I · FundamentalsErrors: one model

Your wallet's codes are Appendix A.1. What GA returns to you is Appendix A.2. Every error from /v2/aggregator/ and /v2/features/ has a non 200 HTTP status and one JSON body, Content Type: application/json : json { "code": "ERROR CODE MAINTE

Aggregation / Part I · FundamentalsIdempotency & retries

Certification tests these hardest. Build them in from day one. The full normative text is in Money Path Rules. Keep every op id with its stored answer for at least 4 months . GA resends for 72 hours, and the margin covers reconciliation dis

Aggregation / Part I · FundamentalsRate limits, pagination, network

Your wallet must answer within 5 seconds per call (§2.7). Aim for well under 1 second. GA doesn't filter your source IP on the Operator API. If you restrict inbound traffic to your wallet, allow GA's outbound addresses: 49.13.169.177 and 46

Aggregation / Part I · FundamentalsMoney Path Rules

The rules below govern the v2 wallet contract when a call goes wrong. The cases are a timeout, a duplicate, a rollback of an operation you never saw, and a win that arrives after the session closed. They're additive: GA removes or renames n

Aggregation / Part II · Operator APIGetting started

1. Get sandbox credentials. Email [integration@gamealligator.com](mailto:integration@gamealligator.com). You receive an operator profile with operator id , the Operator API key pair, and a login to https://operator.rexplay.site . There you

↑ ↓ navigate↵ openesc close
  1. Home
  2. /Integration
  3. /Gamification
  4. /Reasons, numbers, currencies
Gamification

Reasons, numbers, currencies

MarkdownSource

Reasons

VerdictReasonMeaningYour action
rejectedno_idempotency_keyno usable event_id, or the event is not a JSON object; not storedfix and resend
rejectedmalformedwrong field type, spec, missing kind, occurred_at, or round_id of a round kind, brand or player_ref over 255 bytesfix, send with a new event_id
rejectedop_unknownkind is none of bet, win, settled, refund, deposit, withdrawal, loginfix, send with a new event_id
rejectedno_playerplayer_ref missing or emptyfix, send with a new event_id
rejectedbad_amountamount is not an exact decimal string of the currency (§5.3), or missing where it is requiredfix, send with a new event_id
rejectedno_brandthe connection carries several brands and brand is missingadd brand
rejectedbrand_unexpectedthe connection carries one brand and brand is presentdrop brand
rejectedbrand_unmappedthis brand is not registered for youcontact us; after we register it, resend with new event_ids
rejectedoperator_inactivethe brand is not active in GAcontact us
rejectedpanicprocessing failed on our sidesend us the event_id
skippedcurrency_unknowncurrency is missing or not in Appendix Cuse a listed code, or ask us to add one
skippedzero_amounta bet or settled of zeronone
skippedgame_denied, game_not_allowedthe game is outside the promotion rules of the brandnone
skippedbelow_min_betthe bet is below the brand’s minimum for promotionsnone
skippedgame_unknownyour catalogue holds games, and this bet or settled names none of its active ones (§8.1)add the game to your catalogue; later events of it count
skippedround_refundedthe round was already refundednone
duplicateany or nonealready decided; a reason here, if present, is not a new verdictnone

Numbers to Remember

Token endpoint answerwithin 1.5 s, else the page shows the guest view
Operator token exprequired; a few minutes
Webhook timestamp window±300 s
Webhook batch / body500 events / 1 MiB, unless agreed otherwise
503 retry hintRetry-After: 1
Wait for a free webhook slot0.5 s, then 503
brand, player_refup to 255 bytes of UTF-8
amountexact decimal string; the value in minor units fits a signed 64-bit integer
settledexactly one per round, amount = sum of the bets
RabbitMQ retry of an undecided message1 s, doubling, up to 30 s
GA catalogue request timestampup to 5 min old, up to 30 s ahead
GA catalogue diff limit1–1000, default 200

Currencies

ScaleCodes
0JPY
2USD, EUR, GBP, CHF, CAD, AUD, NZD, PLN, CZK, HUF, RON, BGN, SEK, NOK, DKK, TRY, UAH, RUB, BRL, MXN, INR, ZAR
6USDT, USDC, XRP, ADA, TRX
8BTC, LTC, DOGE
9SOL
18DAI, ETH, BNB, MATIC

A currency not listed here is set aside (skipped/currency_unknown); ask us before you send one.

PreviousOnboarding and go-live
Integration support: integration@gamealligator.comIntegration center
On this page
ReasonsNumbers to RememberCurrencies
↑ Back to top