Notell API Docs
Русский

Getting started

Environments

ProductionTest (sandbox)
API base URLhttps://notell-api.comhttps://slots.justsaynot.ru
PurposeLive integrationDevelopment and acceptance tests of your integration
Games, API, callbacksSame API and contractSame API and contract
Callback source IPscallbackSourceIps of GET /capabilities (currently 212.192.5.4)Ask your account manager: callbackSourceIps of the sandbox GET /capabilities is currently empty
Project id (partner), api_key, IP allowlistIssued for productionIssued separately; keys of one environment do not work in the other
UnitsTEST_ONLY, non-withdrawable (Overview)TEST_ONLY, non-withdrawable

Rules of thumb#

  • Same code, different base URL and credentials. Take the base URL, partner, api_key, callback URL and the IP allowlist from configuration per environment.
  • Allow the callback source IPs of the environment you call; production and test callbacks come from different servers.
  • The rate limits of an environment are in rateLimits of its GET /capabilities (Conventions). The cancel policy of an unconfirmed bet (10 minutes or 600 attempts, whichever comes first) is not exposed by the API; see Round cancel and refunds.
  • Test the failure paths before going live: a wallet timeout, a repeated bet, a refund, a wrong signature, 429. The admin panel's API Logs show every callback attempt.
  • The documentation and the OpenAPI document show the production address (https://notell-api.com); on the test environment substitute the base URL.

Going live checklist#

  • [ ] Production credentials received, the production callback URL set in the admin panel.
  • [ ] Production callback IPs allowed; signature verification on.
  • [ ] refund, idempotency, INSUFFICIENT_FUNDS and the HTTP 4xx rule behave as in the wallet contract.
  • [ ] The pages that embed the game are in the allowed iframe origins.
  • [ ] Reports reconcile with your ledger for a test period (Reporting).
Documentation for operators and integrators.TEST_ONLY platform: non-withdrawable units, no real payments.