Intégration d’une API sportsbook : cotes, paris et règlement
Une cote affichée sur un site de paris sportifs ne signifie pas qu’un pari a été accepté. Le fournisseur de données diffuse des marchés et leurs prix ; le service de prise de paris décide de l’acceptation et des limites ; le portefeuille et le système de règlement enregistrent ensuite les conséquences financières. Une intégration API fiable relie ces domaines par des identifiants stables, des transitions d’état, des règles de reprise et une traçabilité comptable. Nous suivons ici le parcours d’un ticket, de la cote affichée à son règlement ou à sa correction. La réception d’un flux ne prouve pas que son fournisseur accepte les mises, gère les fonds ou autorise l’activité dans une juridiction.
Publié le
Le prix affiché, le ticket accepté et la transaction de règlement sont trois décisions distinctes.
Sommaire
Quels composants une API sportsbook doit-elle relier ?
On distingue généralement le calendrier et les marchés avec leurs cotes, le moteur de validation et d’acceptation des tickets, puis les résultats et les mouvements d’argent. Ces fonctions peuvent dépendre d’un même prestataire ou de plusieurs contrats. Il faut donc attribuer clairement la responsabilité de chaque opération. [1]
Un message de marché peut faire autorité sur le statut de ce marché sans autoriser une écriture de portefeuille. De même, un clic sur le bouton de pari ne vaut pas acceptation. Seule la réponse vérifiée du moteur compétent confirme la mise et la cote retenues.
Comment identifier rencontres, marchés et sélections ?
Conservez les identifiants internes des événements, marchés, choix et tickets tout en gardant le nom du fournisseur et ses références d’origine. Une rencontre comporte plusieurs marchés ; un marché peut proposer des lignes et des issues distinctes. « Plus de 2,5 » n’est pas un identifiant suffisant sans événement et paramètres du marché.
Identifiant
Objet concerné
Contrôle
Événement source
Rencontre du fournisseur
Conserver le namespace
Marché
Type de pari et ligne
Garder les paramètres
Sélection
Issue proposée
Éviter le libellé seul
Version de cote
Révision du prix
Écarter les données périmées
Ticket
Pari accepté
Stable lors des reprises
Règlement
Événement de résultat
Associer au ticket
Versionnez les correspondances et archivez le message initial. Un match reporté ou une ligne renommée ne doit pas rattacher silencieusement un ticket existant à une autre sélection. Les protocoles de flux distinguent les changements de rencontres, de cotes et de règlement. [1]
Que faire si la cote change ou si le marché est suspendu ?
Entre l’affichage et la soumission, une cote peut évoluer ou un marché devenir indisponible. Le consommateur du flux doit respecter la signification des statuts, les horodatages et la chronologie définis par le partenaire. Une ancienne cote encore visible ne rend pas un marché ouvert. Le message odds_change illustre ces changements d’état. [2]
Conserver l’horodatage et la dernière version traitée pour chaque marché.
Différencier actif, suspendu, fermé et inconnu selon le contrat.
Fixer une durée maximale de validité et vérifier la cote côté serveur.
Ne jamais promettre l’acceptation à partir d’un prix affiché en cache.
Le cache accélère l’affichage, mais le service d’acceptation contrôle de nouveau la cote réelle, l’éligibilité du joueur, les limites et le solde. En cas de changement de prix, l’interface doit annoncer un refus ou demander un accord explicite sur la nouvelle proposition.
Comment une demande devient-elle un ticket accepté ?
La demande transporte l’identifiant du client, la marque, le marché, la sélection, la mise, la cote souhaitée et une clé de requête unique. Le service compétent vérifie les droits du compte, les fonds, les limites et les conditions de prise de paris. Un fournisseur de cotes peut ne disposer d’aucun endpoint de placement.
Recevoir une sélection, une mise, une cote et un identifiant de demande unique.
Revalider prix, statut du marché, fonds disponibles et contraintes de risque.
Obtenir une réponse explicite du moteur : accepté, refusé ou en attente.
Créer une seule fois le ticket et la réservation de mise, puis renvoyer le même résultat lors d’un doublon.
⊕Agrandir le schémaLe flux informe la décision ; seule une acceptation confirmée crée une obligation financière.
Un délai dépassé après l’envoi ne prouve pas l’échec : le partenaire peut avoir enregistré le ticket sans que sa réponse arrive. Consultez d’abord le statut par clé ou référence. Les règles HTTP n’autorisent pas à répéter aveuglément un POST non idempotent. [6]
Comment ordonner et récupérer les messages après une coupure ?
Un flux temps réel peut être interrompu, livrer des messages en double ou présenter des lacunes. Enregistrez l’émetteur, les numéros d’ordre, un point de reprise durable et une procédure de reconstruction. Les notifications essentielles ne devraient être acquittées qu’après enregistrement fiable. Certaines API récupèrent séparément les résultats et les annulations. [5]
Incident
Réaction
Vérification
Message en double
Ignorer par clé source
Aucun double effet
Séquence manquante
Suspendre le marché
Replay ou instantané
Flux indisponible
Bloquer les prix périmés
Source redevenue valide
Résultat tardif
Traiter séparément
Ticket retrouvé
Redémarrage
Reprendre au curseur
Pas de double paiement
Un instantané des cotes à jour ne garantit pas que tous les événements financiers ont été reçus. Vérifiez les possibilités réelles de recovery, les durées de conservation et le traitement des tickets toujours ouverts.
Comment gérer gains, paris annulés et corrections ?
Le règlement applique aux tickets acceptés les règles de pari convenues. Gain, perte, remboursement, règlement partiel et combinaisons nécessitent un modèle d’état explicite. Le Unified Odds Feed prévoit notamment bet_settlement et un message distinct rollback_bet_settlement pour une correction. [3] [4]
Conserver la mise, la cote acceptée, le marché et la version des règles.
N’accepter un résultat que pour un ticket connu et une source authentifiée.
Enregistrer une seule fois le paiement ou le remboursement avec une clé de règlement.
Corriger par une écriture inverse documentée plutôt qu’effacer l’historique.
Un rollback n’est pas un nouveau gain ; l’annulation d’un marché ne correspond pas toujours à un remboursement ordinaire. Gardez le type exact des messages. En Grande-Bretagne, lorsque la réglementation s’applique, les règles publiées doivent déterminer les résultats et les erreurs affectant les clients doivent être signalées. [7]
Comment rapprocher tickets, mises et portefeuille ?
Il faut des références immuables différentes pour la réservation de la mise, l’acceptation du ticket, le règlement et sa correction. Recevoir un callback n’équivaut pas à payer le client. Chaque écriture possède une clé unique et doit être rapprochée du ticket et de la preuve fournie par le partenaire.
État du ticket
Traitement wallet
Preuve
Cote affichée
Aucun débit
Demande et expiration
Accepté
Réserver une fois
Référence d’acceptation
Refusé
Libérer la réserve
Motif du refus
Réglé
Payer ou solder la perte
Résultat et écriture
Corrigé
Contre-écriture ou retour
Référence et motif
Le rapprochement compare, par ticket et devise, les montants exacts, réserves, paiements et écritures inverses. Tout écart doit être examiné : un simple callback ne doit pas créer automatiquement une compensation financière.
Quelles limites de latence comptent pour les paris en direct ?
Pendant une rencontre, les prix et les droits de prise de paris changent vite. Un flux rapide améliore l’affichage, mais ne remplace ni les signaux de suspension, ni la fenêtre de validité, ni les limites d’exposition ou les éventuels délais imposés. Définissez un comportement prudent lors des pannes.
Mesurer séparément retard du flux, âge de la cote affichée et réponse du moteur.
Bloquer l’acceptation si le marché ou le contrôle du risque est incertain.
Archiver la cote réellement acceptée, distincte de celle vue auparavant.
Tester changements rapides, interruptions de match et clics répétés sous charge.
Le joueur doit savoir clairement si sa demande a abouti. Aucun délai universel de prise de pari, de versement ou de règlement ne peut être déduit d’une simple architecture API. [2] [7]
Quels contrôles de sécurité et de conformité sont essentiels ?
Les API exigent l’authentification des services, la vérification des droits par client et marque, la protection des secrets, le chiffrement et une piste d’audit. Un service autorisé à lire les cotes ne doit pas pouvoir accepter des tickets ou modifier le portefeuille. Chaque référence de pari doit être autorisée au niveau de son propriétaire.
Alerter sur cotes périmées, trous de séquence et paris tentés sur marchés suspendus.
Comparer tickets en attente, acceptés et réglés aux rapports contractuellement accessibles.
Tester doublons, délais dépassés, callbacks falsifiés et corrections désordonnées.
Documenter licences, données personnelles, conservation et contestations selon les marchés.
Suivez séparément la qualité technique du flux et la justesse financière. Un compteur de messages reçus ne révèle pas forcément les tickets sans issue, les versements en double ou les engagements non rapprochés.
Que vérifier avant la mise en service de l’API sportsbook ?
Exécutez en préproduction tout le cycle de vie : variation de cote, suspension, refus, acceptation, résultat tardif, remboursement, rollback, récupération d’un flux et désaccord de solde. Chaque cas doit se relier au message source et à l’écriture finale.
Valider les identifiants, les droits, la précision des cotes et leur expiration.
Prouver les requêtes idempotentes, les refus et la libération des mises bloquées.
Simuler résultats, annulations, corrections et rapprochement du portefeuille.
Obtenir les validations techniques, opérationnelles et légales requises avant le direct.
Une bonne intégration ne se limite pas à afficher des cotes et à renvoyer un numéro de pari. Elle doit expliquer chaque décision d’acceptation, chaque résultat et chaque correction financière de manière vérifiable.