Données de la session de jeu
Joueur, marque, jeu, devise, pays, langue, mode, juridiction et expiration de l’accès.
Documentation / Scénario de jeu
Scénario de l’API de jeu
Le parcours complet, de la validation du joueur et du lancement du jeu jusqu’aux paris, gains, manches, annulations d’opérations et au rapprochement financier.
Session
joueur et lancement du jeu
Solde
paris et gains
Manches
déroulement de la session de jeu
Annulation
récupération de l’opération
Cycle de vie du jeu
Du lancement à la clôture de la manche
01
Créer une session de jeu
Joueur, jeu, devise, langue, pays, mode et URL de retour.
02
Lancer le jeu
Clé d’accès temporaire, URL de lancement et vérification de la disponibilité du jeu.
03
Traiter les opérations financières
Vérification du solde, pari, gain, opération combinée et réponses de la plateforme.
04
Clôturer et rapprocher la manche
Résultat final, annulations, grand livre financier et rapport du fournisseur.
Vue d’ensemble
L’API de jeu relie le joueur, la manche et les mouvements de fonds
Le lancement du jeu et les mouvements de fonds sont deux parties d’un même processus. La session identifie le joueur et les conditions de lancement, la manche relie les actions du fournisseur, et l’API de la plateforme confirme chaque débit, crédit et annulation.
Contrôle du solde
La plateforme vérifie les fonds disponibles et applique chaque pari, versement ou annulation une seule fois.
Grand livre financier du jeu
Les identifiants d’opération et de manche, le type d’opération, le montant ainsi que les soldes avant et après sont conservés pour le contrôle et le rapprochement.
Lancement du jeu
Scénario type de lancement d’un jeu
La plateforme valide d’abord le joueur et la disponibilité du jeu, crée ensuite une session à durée limitée et reçoit du fournisseur une URL de lancement.
01
Valider le joueur et la disponibilité du jeu
La plateforme vérifie le statut du compte, la devise, le pays, les restrictions, les limites, le mode argent réel ou démo et la disponibilité du jeu.
02
Créer une session interne
Un identifiant de session est créé avec les informations sur le joueur, le jeu, la marque, la devise, la langue, l’IP et l’expiration.
03
Obtenir l’URL de lancement du jeu
Le fournisseur reçoit la clé de session, les URL de notification et de retour, le type d’appareil, la juridiction et les paramètres d’interface.
04
Ouvrir le jeu dans le navigateur
Le joueur ouvre l’URL renvoyée, tandis que les opérations financières suivantes sont traitées directement de serveur à serveur.
Opérations de solde
Principales opérations de solde
Les noms de méthodes diffèrent selon les fournisseurs, mais la logique reste la même : vérification du solde, débit du pari, crédit du gain et annulation d’une opération précédemment confirmée.
Vérification du solde
Renvoie le solde disponible du joueur dans la devise de la session active sans modifier le grand livre financier.
Débit du pari
Valide le joueur, la session, la devise et les fonds disponibles, puis débite une seule fois le pari confirmé.
Crédit du gain
Crédite les gains à l’aide d’identifiants uniques d’opération et de manche, y compris lorsque le résultat est nul.
Pari et résultat dans une seule requête
Applique ensemble le pari et le résultat du jeu lorsque le fournisseur prend en charge ce modèle.
Annulation de l’opération
Crée une opération corrective distincte pour un pari ou un versement précédemment confirmé, sans supprimer l’écriture d’origine.
Bonus et free spins
Transmet les données de la campagne de bonus et de la manche tout en séparant les fonds réels et les fonds bonus.
Devise et précision des montants
Chaque opération valide la devise, les unités de montant, le nombre de décimales et les règles d’arrondi.
Réponse de la plateforme
Renvoie le statut de l’opération, l’identifiant interne, le solde actuel et un code d’erreur unifié.
Cycle de vie de la manche
Cycle de vie de la manche de jeu
Une manche peut contenir plusieurs paris et résultats. Son état est déterminé par les règles du jeu, et pas uniquement par l’ordre des requêtes réseau.
Manche créée
La plateforme reçoit l’identifiant de manche pour la première fois et crée un enregistrement interne.
Manche active
La manche peut contenir d’autres paris, actions de jeu et gains intermédiaires.
Pari accepté
Le débit est confirmé par la plateforme et lié à l’identifiant d’opération unique du fournisseur.
Résultat reçu
Un gain ou un résultat nul a été reçu, mais la manche peut rester ouverte selon les règles du jeu.
Manche clôturée
Le fournisseur a confirmé la fin de la manche et toutes les opérations financières attendues ont été traitées.
Opérations annulées
Une ou plusieurs opérations ont été corrigées tout en conservant l’intégralité de l’historique d’origine.
Une manche peut contenir plusieurs opérations
L’identifiant de manche ne doit pas être la seule clé d’idempotence. Chaque pari, versement et annulation doit avoir son propre identifiant unique.
Fiabilité et rapprochement
Protection contre les doublons et rapprochement financier
L’API de jeu doit gérer en toute sécurité les requêtes répétées, les délais de réponse, les opérations reçues dans le désordre et la récupération du fournisseur après une défaillance.
Traitement sûr des répétitions
L’identifiant d’opération du fournisseur est unique pour chaque type d’action financière.
Une requête répétée renvoie le résultat d’origine et le solde actuel sans déplacer à nouveau les fonds.
Une nouvelle tentative avec un montant, une devise ou un joueur différents est rejetée comme conflit de données.
Une annulation fait référence à une opération d’origine précise et reçoit également son propre identifiant unique.
Grand livre des manches et rapprochement
Conservez les identifiants de session, de manche, d’opération fournisseur et d’opération plateforme.
Enregistrez le type d’opération, le montant, la devise, les soldes avant et après ainsi que le temps de traitement.
Ne modifiez pas les écritures comptabilisées ; créez une opération corrective distincte.
Rapprochez les rapports fournisseurs, les manches de jeu, les mouvements de solde, le GGR et les écarts identifiés.
Tests
Éléments à tester dans l’environnement de test
Les contrôles doivent couvrir le lancement du jeu, les restrictions joueur, le solde insuffisant, les opérations répétées, les délais de réponse, les annulations et le rapprochement d’une manche clôturée.
Lancement et session de jeu
Modes argent réel et démo, devise invalide, pays interdit, accès expiré et jeu indisponible.
Solde et refus de pari
Fonds insuffisants, joueur bloqué, devise incohérente et limite dépassée.
Délai et résultat inconnu
Le fournisseur ne reçoit pas de réponse alors que le débit a bien eu lieu et renvoie l’opération avec le même identifiant.
Paris et gains répétés
Le même identifiant arrive avant ou après la fin du traitement, y compris avec des paramètres contradictoires.
Annulations d’opérations
Annulation d’un pari, annulation d’un gain, annulation répétée et référence à une opération d’origine inconnue.
Rapprochement de la manche
Les montants des paris, gains et annulations, le statut final, le mouvement de solde et le rapport du fournisseur doivent concordent.
Liste de contrôle avant lancement
Le lancement a lieu après vérification des sessions de jeu, des opérations de solde, de la protection contre les doublons, des annulations et du reporting.
Les environnements de test et de production utilisent des identifiants d’accès, des points de terminaison API et des paramètres de lancement différents.
La clé de session de jeu a une durée limitée et est liée au joueur, au jeu, à la devise et à la marque.
Chaque opération de solde est protégée par un identifiant fournisseur unique.
Les paris, gains et annulations répétés ne modifient pas le solde une seconde fois.
Les écritures comptabilisées ne sont pas supprimées et sont corrigées au moyen d’opérations d’ajustement distinctes.
Les journaux d’événements, alertes, rapports fournisseurs et le processus de rapprochement des manches sont configurés.
Besoin de configurer le scénario de l’API de jeu ?
Envoyez-nous la documentation du fournisseur, la liste des opérations de solde, le modèle des manches, les devises et les exigences de reporting. APIACE vous aidera à structurer le lancement du jeu, les paris, les gains, les annulations et le rapprochement financier.