Intégrations API iGaming

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.

Trois couches techniques connectées pour les marchés de cotes, la validation des paris et les règlements
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é.

IdentifiantObjet concernéContrôle
Événement sourceRencontre du fournisseurConserver le namespace
MarchéType de pari et ligneGarder les paramètres
SélectionIssue proposéeÉviter le libellé seul
Version de coteRévision du prixÉcarter les données périmées
TicketPari acceptéStable lors des reprises
RèglementÉvénement de résultatAssocier 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.

  1. Recevoir une sélection, une mise, une cote et un identifiant de demande unique.
  2. Revalider prix, statut du marché, fonds disponibles et contraintes de risque.
  3. Obtenir une réponse explicite du moteur : accepté, refusé ou en attente.
  4. Créer une seule fois le ticket et la réservation de mise, puis renvoyer le même résultat lors d’un doublon.
Flux en trois étapes de la cote sportive vers l’acceptation d’un ticket puis son règlement
Le 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]

IncidentRéactionVérification
Message en doubleIgnorer par clé sourceAucun double effet
Séquence manquanteSuspendre le marchéReplay ou instantané
Flux indisponibleBloquer les prix périmésSource redevenue valide
Résultat tardifTraiter séparémentTicket retrouvé
RedémarrageReprendre au curseurPas 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]

  1. Conserver la mise, la cote acceptée, le marché et la version des règles.
  2. N’accepter un résultat que pour un ticket connu et une source authentifiée.
  3. Enregistrer une seule fois le paiement ou le remboursement avec une clé de règlement.
  4. 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 ticketTraitement walletPreuve
Cote affichéeAucun débitDemande et expiration
AcceptéRéserver une foisRéférence d’acceptation
RefuséLibérer la réserveMotif du refus
RégléPayer ou solder la perteRésultat et écriture
CorrigéContre-écriture ou retourRé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.

  1. Valider les identifiants, les droits, la précision des cotes et leur expiration.
  2. Prouver les requêtes idempotentes, les refus et la libération des mises bloquées.
  3. Simuler résultats, annulations, corrections et rapprochement du portefeuille.
  4. 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.

Sources et ressources complémentaires

Visionneuse de schéma