API docs v1
Aggregator API · v1

FAQ

Answers about API access, GGR calculation and funding, wallet reconciliation, and the turnkey casino website package.

On this page

Access and credentials#

Which credentials do I use?

Use your Application API Key in X-API-Key for POST https://aggregatornetwork.com/v1/commands. Keep it on your backend. Provider credentials are not issued to your integration. Configure key scopes, expiry, and your server egress IP allowlist in the portal; an empty IP allowlist permits any source IP.

Is Telegram or operator verification required?

No. Use the workspace's support tickets for integration help. API access follows workspace entitlements and key authorization.

Which activation plans are available?

Check the activation page for current plans. Demo and production activation grant different access. Activation purchases do not add GGR credit; fund the GGR wallet separately for real-money launches.

Which game identifier should I send?

Copy the current catalogue's <brand_id>/<game_uid> identifier exactly. In compact responses it is s; in detailed responses it is id_hash. Illustrative IDs in these guides are not a fixed provider list.

Can every catalogue currency or provider be enabled?

The API supports currency codes without a fixed small list. Send a three-letter uppercase code that is enabled for your workspace. The selected provider and game must also support it. Access & Limits is authoritative for your entitlement; visibility alone does not grant access. USDT workspace funding is separate from game currency.

Sessions#

Do I construct the game URL?

Open only the temporary URL in a successful getGame or getGameDemo response. Check HTTP success and numeric error: 0; do not construct or cache a launch URL for reuse.

Is a player creation call required?

No. The gateway maps players on launch. Optional createPlayer establishes the identity first. Keep the username and currency consistent.

Can I retry a timed-out launch with a new key?

No. Preserve the operation's original key, request, and wallet reservation. The launch may have happened. Inspect request logs and reconcile unknown or unreplayable results with support before another operation.

Wallets#

Which balance is authoritative after a round?

Use credit_amount from the signed settlement callback. Preserve decimal precision and handle each serial_number once. Reconcile out-of-order snapshots so an older event does not overwrite a newer balance. See settlement handling.

Why can a launch fail despite valid credentials?

Key scope/IP restrictions, workspace activation, GGR funding, quotas, currency/game entitlement, return origins, callback configuration, and provider availability all apply. Retain the x-request-id header and inspect validation for the next step.

Are failed callbacks retried indefinitely?

No. There are at most three total delivery attempts. The portal permits eligible recovery after receiver deduplication is confirmed; unknown outcomes require reconciliation. Manual retry also requires callback-management permission and recent authentication with MFA.

GGR and billing#

Is activation payment the same as GGR funding?

No. Activation purchases unlock the provider access included in your plan. They do not add spendable GGR credit. The workspace GGR wallet is separate from activation and from the player wallet. See workspace balance.

How is GGR calculated?

GGR is bets minus wins, not total betting turnover. The commercial fee formula is max(GGR, 0) × the agreed GGR rate, calculated for each provider and play currency within the billing cycle. For example, bets of 10,000 and wins of 8,000 in one currency produce GGR of 2,000; a 10% rate gives an illustrative fee of 200 in that currency. This example is not an issued invoice or a currency conversion.

Check pricing and the configured rate in Current Cycle. Your account's agreed commercial terms govern actual charges.

Can one provider or currency offset another?

No. Commercial GGR is calculated independently for each provider and play currency. Do not offset a losing provider against another provider's positive GGR, or combine different currencies into one total. The portal's currency-level activity summaries are not a provider-by-provider invoice calculation. They do not supply an FX conversion or a funding-currency settlement rate.

What happens when GGR is negative?

When wins exceed bets for a provider/currency in a cycle, its GGR is negative and the formula produces a zero fee for that cycle. Negative GGR does not carry forward or offset another provider. It is not a player-wallet refund or an automatic credit to the GGR wallet. Keep negative recorded activity visible for reconciliation rather than replacing it with zero.

How do I fund the GGR wallet?

Complete activation, then use the GGR wallet to select an available funding method and track its recorded status. Creating a payment request or submitting a transfer reference does not prove confirmed funding. Follow the displayed payment and review instructions; do not assume immediate or guaranteed credit.

USDT workspace funding is separate from the three-letter game currency in a command. It does not convert player balances or bypass workspace/provider/game entitlements. Production launches require production activation and a positive GGR funding balance; valid API credentials alone are insufficient.

Which dates define a GGR cycle?

Reporting uses UTC calendar months, starting at 00:00 UTC on the first day and ending just before 00:00 UTC on the first day of the next month. Recorded settlements are grouped by the time the gateway received them, not by a browser's local timezone. A late settlement can therefore appear in the following reporting month; review such differences against provider and wallet records.

Is a monthly summary an automatically issued bill?

No. Current Cycle is an activity snapshot and shows the recorded funding balance and configured rate. It does not establish a billed amount, due date, or settlement schedule. Invoice issuance and settlement follow the agreed account process, rather than an automatic monthly billing guarantee.

Review invoices, payment history, and the GGR wallet for actual recorded amounts and statuses. Confirm any currency conversion, rounding, tax, and settlement terms with the account team; the API does not define them from the example fee formula.

Why can recorded activity differ from my reconciled wallet?

Current settlement activity includes received rounds even when callback delivery is pending, failed, or unknown. Legacy callback activity counts delivered, financially successful wallet callbacks instead. These views describe different evidence; neither is a complete double-entry journal or proof that every wallet update succeeded.

Preserve exact monetary values, deduplicate by serial_number, and compare player-wallet, provider, callback, and billing records. A failed or unknown delivery does not authorize an automatic refund, debit, replay, or write-off. Follow settlement recovery and ask support to help reconcile unknown outcomes.

Is the monthly GGR limit a billing or credit limit?

No. The launch guard checks recorded GGR in the requested currency against a configured numeric threshold. It is not a reservation, a provider-level billing calculation, or an FX-normalized credit ledger. Do not use that guard as proof of an amount owed or of available funds. Funding, request quotas, and normal entitlement checks still apply independently.

Turnkey casino website#

What is the turnkey casino website package?

The $4,000 USD Business Launch limited-time offer (was $10,000 USD) includes the turnkey casino website, the full available provider catalogue at a 10% GGR rate, and launch assistance. It is an activation package, not GGR wallet credit. Review the Turnkey Casino Website page, pricing, and launch guide before choosing a package.

Can I preview the website before choosing Business Launch?

Yes. The public Turnkey Casino Website page includes dated desktop/mobile examples and links to the current Crickace website preview. Earlier screenshots may differ from the current demo. The preview demonstrates the player interface; visible games and categories do not prove that your workspace has production access.

Does the turnkey casino website make every slot, casino, or sportsbook launchable?

No. The website presents slots, casino, and sports experiences, but production availability still depends on enabled providers, games, currencies, territories, and the actual connection. There is no universal sportsbook API implied by the website. In particular, 9Wicket is not currently launchable through /v1/commands. Confirm the supported products with the account team.

What must be completed before production play?

Confirm the website's delivery and branding scope with the account team. Verify production activation, workspace/provider/game/currency entitlements, separate GGR funding, key scopes, HTTPS callbacks and signing, approved return origins, and player-wallet reconciliation. Test the enabled products on desktop and mobile and complete the legal and operating requirements for your market. A website preview or activation purchase is not a production-readiness certification.

Are player payments and wallet settlement automatic?

The preview is not a guarantee of live payment processing, settlement, or withdrawals. Confirm the agreed payment and wallet integration, operational responsibilities, and delivery scope with the account team. Keep the player wallet separate from activation and GGR funding; use signed callbacks and reconciliation rather than assuming a website button proves a completed financial operation.