{"id":4541,"date":"2026-10-06T11:31:45","date_gmt":"2026-10-06T11:31:45","guid":{"rendered":"https:\/\/whitelotto.com\/?p=4541"},"modified":"2026-10-06T11:31:45","modified_gmt":"2026-10-06T11:31:45","slug":"lottery-payment-gateway-integration","status":"publish","type":"post","link":"https:\/\/whitelotto.com\/fr\/lottery-payment-gateway-integration\/","title":{"rendered":"Int\u00e9gration des paiements de loterie : webhooks et remboursements"},"content":{"rendered":"\n

L\u2019int\u00e9gration d\u2019une passerelle de paiement de loterie est pr\u00eate lorsque paiements, \u00e9critures du portefeuille et rapports de r\u00e8glement concordent, m\u00eame apr\u00e8s de nouvelles tentatives, des d\u00e9lais d\u00e9pass\u00e9s, des remboursements et des notifications tardives. Un \u00e9cran de paiement r\u00e9ussi ne prouve pas que l\u2019op\u00e9rateur a re\u00e7u les fonds ni que le bon compte a \u00e9t\u00e9 cr\u00e9dit\u00e9 une seule fois.<\/p>\n

Ce guide d\u00e9crit des exigences d\u2019int\u00e9gration, pas les champs r\u00e9els de l\u2019API WhiteLotto ni une promesse de compatibilit\u00e9 avec un prestataire nomm\u00e9. L\u2019admissibilit\u00e9 du prestataire, les produits accept\u00e9s et les conditions commerciales doivent \u00eatre confirm\u00e9s s\u00e9par\u00e9ment. Consultez le guide d\u2019architecture des paiements de loterie<\/a> pour le contexte op\u00e9rationnel et les co\u00fbts.<\/p>\n

S\u00e9parer les enregistrements du prestataire, du portefeuille et de la finance<\/h2>\n

Convenez du syst\u00e8me responsable de la tentative de paiement, du r\u00e9sultat d\u00e9finitif du prestataire, de l\u2019\u00e9criture du portefeuille joueur, de l\u2019instruction de retrait et du rapprochement comptable. Reliez leurs identifiants sans les consid\u00e9rer comme interchangeables. D\u00e9finissez montants, devise, arrondis et frais \u00e0 chaque fronti\u00e8re.<\/p>\n

\n
\u00c9tats de paiement \u00e0 r\u00e9soudre dans le contrat d\u2019int\u00e9gration<\/caption>
Situation<\/th>Comportement requis<\/th>Preuves \u00e0 conserver<\/th><\/tr><\/thead>
Cr\u00e9\u00e9 ou en attente<\/th>Ne pas confondre une op\u00e9ration initi\u00e9e avec une alimentation de compte aboutie.<\/td>Identifiant d\u2019op\u00e9ration, r\u00e9f\u00e9rence du prestataire et statut actuel.<\/td><\/tr>\n
Autoris\u00e9 ou captur\u00e9<\/th>Appliquer la r\u00e8gle convenue de cr\u00e9dit du portefeuille pour le moyen de paiement r\u00e9el.<\/td>\u00c9v\u00e9nement v\u00e9rifi\u00e9 du prestataire et \u00e9criture comptable li\u00e9e.<\/td><\/tr>\n
R\u00e9ponse incertaine<\/th>D\u00e9terminer le r\u00e9sultat initial avant de cr\u00e9er une nouvelle op\u00e9ration.<\/td>Historique des tentatives et consultations, puis r\u00e9solution finale.<\/td><\/tr>\n
Remboursement ou contrepassation<\/th>Relier l\u2019ajustement au paiement initial et \u00e9viter les effets dupliqu\u00e9s.<\/td>R\u00e9f\u00e9rence d\u2019ajustement, montant, motif et approbation.<\/td><\/tr>\n
Litige ou \u00e9cart de r\u00e8glement<\/th>Cr\u00e9er une exception attribu\u00e9e \u00e0 un responsable, avec r\u00e9ponse de la finance.<\/td>Rapport du prestataire, enregistrement interne et trace de r\u00e9solution.<\/td><\/tr>\n<\/tbody><\/table><\/div>\n

Concevoir les webhooks pour les r\u00e9p\u00e9titions et les retards<\/h2>\n

V\u00e9rifiez l\u2019origine de l\u2019\u00e9v\u00e9nement au moyen du m\u00e9canisme document\u00e9 du prestataire avant de faire confiance \u00e0 son contenu. Validez compte, paiement, montant et devise r\u00e9f\u00e9renc\u00e9s. Enregistrez durablement l\u2019\u00e9v\u00e9nement ou l\u2019op\u00e9ration accept\u00e9 avant d\u2019envoyer la r\u00e9ponse indiquant \u00e0 l\u2019\u00e9metteur que la livraison a r\u00e9ussi. Traitez les op\u00e9rations longues par un chemin r\u00e9cup\u00e9rable.<\/p>\n

Ne supposez pas que les \u00e9v\u00e9nements arrivent une seule fois ou dans l\u2019ordre. Stripe documente la v\u00e9rification des signatures, les doublons et l\u2019absence d\u2019ordre garanti<\/a>. Adyen documente ses propres r\u00e8gles d\u2019accus\u00e9 de r\u00e9ception et de traitement des doublons<\/a>. Ces r\u00e9f\u00e9rences sont propres aux prestataires ; elles ne prouvent pas une int\u00e9gration WhiteLotto avec l\u2019un ou l\u2019autre.<\/p>\n

Choisissez les cl\u00e9s de d\u00e9duplication et les r\u00e8gles de transition d\u2019\u00e9tat \u00e0 partir du contrat r\u00e9el du prestataire. Un nouvel identifiant de livraison peut correspondre au m\u00eame \u00e9v\u00e9nement m\u00e9tier. Un \u00e9v\u00e9nement tardif ne doit pas faire revenir en arri\u00e8re une op\u00e9ration d\u00e9j\u00e0 r\u00e9solue. Gardez les erreurs visibles dans une file d\u2019exceptions et pr\u00e9voyez un rejeu contr\u00f4l\u00e9.<\/p>\n

D\u00e9finir les nouvelles tentatives s\u00fbres et les r\u00e9sultats incertains<\/h2>\n

Supposons que le prestataire r\u00e9alise une alimentation de compte, mais que la r\u00e9ponse n\u2019arrive jamais \u00e0 la plateforme. Un nouveau paiement peut d\u00e9biter \u00e0 nouveau le joueur. R\u00e9utilisez la r\u00e9f\u00e9rence d\u2019op\u00e9ration ou le m\u00e9canisme d\u2019idempotence pris en charge et consultez le r\u00e9sultat initial.<\/p>\n

La documentation d\u2019idempotence de Stripe<\/a> illustre le comportement de rejeu d\u2019un prestataire. Ne transposez pas sa dur\u00e9e de conservation ou sa s\u00e9mantique d\u2019erreurs \u00e0 un autre. Votre contrat doit pr\u00e9ciser la dur\u00e9e de protection, le comportement en cas de conflit de contenu et la r\u00e9cup\u00e9ration apr\u00e8s expiration.<\/p>\n

Testez la concurrence autant que la r\u00e9p\u00e9tition : deux traitements peuvent recevoir le m\u00eame \u00e9v\u00e9nement simultan\u00e9ment. Une protection qui ne fonctionne que dans une session de navigateur ne suffit pas \u00e0 prot\u00e9ger le registre partag\u00e9 du portefeuille.<\/p>\n

Rapprocher les mouvements bruts et les \u00e9carts<\/h2>\n

Appariez les op\u00e9rations du prestataire aux \u00e9critures du portefeuille et aux rapports de r\u00e8glement du prestataire. Expliquez s\u00e9par\u00e9ment frais, remboursements partiels, montants contest\u00e9s, \u00e9carts de change et d\u00e9calages temporels. Les d\u00e9p\u00f4ts ne sont pas des ventes de billets ; une alimentation r\u00e9ussie ne prouve pas l\u2019acceptation d\u2019un achat de billet ult\u00e9rieur.<\/p>\n

La finance doit pouvoir examiner un montant non appari\u00e9 avec les r\u00e9f\u00e9rences autoris\u00e9es, les horodatages et l\u2019historique des statuts. Utilisez le cadre d\u2019indicateurs<\/a> pour pr\u00e9senter valeur et anciennet\u00e9 non r\u00e9solues, sans masquer les \u00e9carts de signes oppos\u00e9s par compensation.<\/p>\n

Liste d\u2019acceptation des paiements<\/h2>\n