API d'agrégateur de jeux de casino : comment elle est construite

L'architecture de l'API

Vos requêtes partent vers un endpoint unique, sous forme de corps JSON en POST. Chacune contient votre login, votre mot de passe et le nom de la méthode souhaitée. Les réponses reviennent en JSON. Pas d'URL de base distincte par produit, pas de seconde spécification pour le casino live ou le sport : une seule API iGaming couvre l'ensemble du catalogue de plus de 40 000 jeux et le sportsbook.

Le trafic dans l'autre sens, de nous vers vous, c'est le seamless wallet : nous appelons votre serveur chaque fois que le solde d'un joueur doit être lu ou modifié. Ces callbacks arrivent sous forme de requêtes HTTP GET signées, avec paramètres de requête.

Les méthodes que vous appelez

Liste des jeux

La liste des jeux est la colonne vertébrale de votre lobby. Chaque entrée possède un identifiant stable, que vous stockez et renvoyez tel quel au lancement. Le champ type de jeu est déjà normalisé d'un studio à l'autre : vous pouvez donc construire les rubriques « Slots », « Live », « Crash », « Table » et « Sport » directement à partir de la réponse. Les tables live et le sportsbook sont de simples entrées de cette liste.

Lancement

Pour ouvrir un jeu, vous envoyez le joueur, l'identifiant du jeu, l'appareil (ordinateur ou mobile) et le pays du joueur, plus une langue en option. Vous recevez une URL à charger dans une iframe. Le pays compte : certains studios excluent certains marchés, et nous appliquons ces restrictions à partir du pays que vous envoyez, jamais en le devinant d'après une adresse IP. Envoyez-le à chaque lancement en argent réel.

Démo

Environ 16 000 slots peuvent être lancées en mode démo selon le même schéma. Aucune fiche joueur n'est nécessaire et aucun callback n'est déclenché, ce qui rend les lancements démo sûrs sur des pages publiques.

Les callbacks seamless wallet

L'argent des joueurs ne quitte jamais votre plateforme. Nous envoyons trois actions à votre URL de callback :

• balance : lire le solde actuel du joueur, généralement à l'ouverture d'une session.
• debit : une mise. Déduisez-la et renvoyez le nouveau solde, ou renvoyez un code de solde insuffisant avec le solde actuel.
• credit : un gain. Ajoutez-le et renvoyez le nouveau solde.

Chaque appel transporte un identifiant de transaction unique, un identifiant de partie et l'identifiant du jeu. Les montants sont des entiers exprimés dans la plus petite unité de la devise. Votre endpoint répond toujours HTTP 200 ; le résultat figure dans le corps JSON sous forme de code d'erreur : succès, solde insuffisant ou erreur de traitement.

Rollbacks

Un rollback n'est pas une action à part. Il arrive sous la forme d'un debit ou d'un credit portant un indicateur de rollback, et vous le traitez comme n'importe quel autre mouvement. C'est votre dédoublonnage sur l'identifiant de transaction qui le rend sûr.

Sécurité

Chaque callback inclut un horodatage et une clé dérivée de cet horodatage et de votre sel secret. Rejetez tout ce qui sort d'une courte fenêtre de temps ou dont la clé ne correspond pas. Pour une protection renforcée, chaque callback transporte aussi un en-tête HMAC-SHA256 calculé sur l'ensemble de ses paramètres : un montant ou un nom d'utilisateur falsifié échoue donc à la validation.

Free spins et free rounds

Deux choses différentes portent ce nom, et mieux vaut être précis.

Les free spins en jeu fonctionnent sur tout le catalogue, sans rien à développer. Free spins déclenchés par les scatters, tours bonus, feature buys et jackpots se déroulent dans le jeu, et leurs gains vous parviennent sous forme de credits ordinaires, souvent sans debit correspondant. Votre handler doit accepter ces credits.

Les free rounds promotionnels, ceux que vous offrez à un joueur en bonus de bienvenue, ne sont pas des appels API en libre-service chez nous. Si votre plan de bonus repose sur l'attribution de free rounds, parlez-nous-en avant de le construire et nous vous dirons ce qui peut être mis en place pour les jeux que vous visez.

Devises

La devise est définie par joueur. Un même compte peut servir des joueurs dans de nombreuses devises, ou un site peut être verrouillé sur une seule. La principale gamme de slots multi-studios et le sportsbook prennent en charge 38 devises ISO, dont EUR, USD, GBP, CAD, AUD, BRL, MXN, ARS, INR, BDT, PKR, IDR, PHP, THB, VND, TRY, ZAR et ETB. Les autres gammes ajoutent ou retirent des devises selon le studio : considérez la méthode Devises comme la référence, plutôt que n'importe quelle plaquette.

Le sportsbook via la même API

Le sportsbook de notre catalogue, Nocturn Sport, se lance avec le même appel qu'une slot et se règle via les trois mêmes callbacks. Les paris d'avant-match et en direct débitent le joueur au moment de la prise de pari et le créditent au règlement, parfois des heures ou des jours plus tard pour un pari à long terme. L'esport, avec CS2, Dota 2 et Valorant, côtoie le football, le tennis et le basket. Notre part sur le GGR sportsbook est de 12 %. Les spécificités du sport sont détaillées sur la page API paris sportifs.

Configurations multimarques

Les opérateurs qui exploitent plusieurs sites n'intègrent pas deux fois. Chaque marque supplémentaire reçoit ses propres identifiants et sa propre URL de callback sous le même compte, et le catalogue peut varier d'un site à l'autre si vos licences l'exigent.

Prochaines étapes

Suivez l'ordre pas à pas de la page intégration rapide d'API casino, vérifiez les coûts sur la page tarifs ou demandez vos identifiants sur la page clé API. Si vous évaluez plusieurs agrégateurs, le comparatif met en regard la façon dont chacun documente son wallet.