Numéro d’opération unique
Il relie le joueur, le montant, la devise, le moyen de paiement, le fournisseur de paiement et l’intégralité de l’historique de traitement.
Documentation / Scénario de paiement
Fonctionnement de l’API de paiement
Parcourez l’ensemble du processus de paiement : de la création d’un dépôt et de la confirmation du paiement jusqu’au crédit des fonds, aux retraits, remboursements et au rapprochement financier.
Dépôt
création et crédit
Versement
vérification et envoi
Statuts
confirmation des opérations
Rapprochement
contrôle financier
Scénario de paiement
De la demande au résultat final
01
Créer l’opération
Enregistrer le joueur, le montant, la devise, le moyen de paiement et le numéro unique de l’opération.
02
Confirmer le paiement
Rediriger le joueur vers la page de paiement, demander une confirmation bancaire ou traiter le paiement directement.
03
Recevoir le statut final
Vérifier la réponse du fournisseur de paiement et confirmer le résultat final de l’opération.
04
Mettre à jour le solde et la comptabilité
Créditer ou débiter les fonds une seule fois, comptabiliser les frais et enregistrer l’opération pour le rapprochement.
Vue d’ensemble
Chaque paiement suit des étapes contrôlées
La plateforme attribue son propre numéro d’opération, le relie à la réponse du fournisseur de paiement et ne modifie l’état financier qu’après un résultat confirmé. Une requête répétée ne doit pas créer un deuxième débit ou crédit.
Statuts clairs
L’opération passe uniquement par les étapes autorisées et ne modifie pas un résultat finalisé sans ajustement distinct.
Comptabilité financière distincte
Le statut du paiement, la modification du solde, les frais et l’écriture comptable sont liés mais contrôlés séparément.
Scénario de dépôt
Scénario type de dépôt
Un dépôt commence par une opération interne et se termine par un crédit unique après confirmation du fournisseur de paiement.
01
Valider la demande et créer l’opération
La plateforme vérifie le joueur, le KYC, les limites, la devise, le montant et le moyen de paiement, puis attribue un numéro d’opération interne.
02
Envoyer le paiement au fournisseur
Le fournisseur reçoit le montant, la devise, les données du joueur, l’URL de retour, l’URL de notification et les informations de paiement requises.
03
Confirmer le paiement
Le joueur confirme le paiement sur une page externe, via 3-D Secure ou dans une application bancaire.
04
Recevoir la confirmation et créditer les fonds
Après validation de la signature et du statut final, la plateforme augmente le solde du joueur une seule fois et termine l’opération.
Retrait et remboursement
Retraits, annulations et remboursements
Les opérations sortantes nécessitent une vérification du joueur, du solde disponible, du risque, des coordonnées de paiement et de la réponse finale du fournisseur de paiement.
Vérification du joueur
KYC, âge, statut du compte, limites, auto-exclusion et méthodes de retrait autorisées.
Contrôles de risque
AML, indicateurs de fraude, conditions de mise, origine des fonds et approbation de l’opérateur.
Réserver le montant
Le montant est bloqué sur le solde jusqu’à réception du résultat final du versement.
Envoyer au fournisseur de paiement
Une demande de versement distincte est créée avec un numéro unique et des coordonnées bénéficiaire vérifiées.
Attendre le résultat
La plateforme accepte les statuts intermédiaires et ne débite pas le montant une nouvelle fois.
Remboursement
Un remboursement est créé comme une opération distincte liée au paiement d’origine et disposant de son propre montant.
Annulation
Une annulation n’est possible qu’avant l’étape irréversible et ne remplace pas un remboursement pour une opération déjà terminée.
Rapprochement final
Le rapport du fournisseur, les données de versement, les frais et les variations de solde doivent produire le même résultat.
Statuts des opérations
Modèle de statuts recommandé
Les statuts internes normalisent les différentes réponses des fournisseurs de paiement dans un modèle unique et clair pour la plateforme.
Créée
L’opération a été créée dans la plateforme mais n’a pas encore été envoyée au fournisseur ni acceptée par celui-ci.
Action requise
Le joueur doit confirmer le paiement, saisir des informations ou effectuer une action auprès de sa banque.
En cours de traitement
Le fournisseur a accepté l’opération, mais le résultat final n’est pas encore confirmé.
Terminée
L’opération s’est terminée avec succès, après quoi le solde est modifié une seule fois.
Rejetée
L’opération s’est terminée par un refus, avec conservation du motif et sans nouveau débit ou crédit.
Non confirmée
Le résultat de l’opération est inconnu en raison d’une rupture de connexion, d’un délai de réponse ou de données contradictoires.
Un résultat inconnu ne peut pas être traité comme un refus
Le paiement peut avoir été accepté par le fournisseur même sans réponse dans les délais. Demandez d’abord le statut actuel ou attendez la confirmation, puis seulement ensuite décidez si une nouvelle opération est nécessaire.
Fiabilité et rapprochement
Protection contre les doublons et rapprochement financier
La fiabilité de l’API de paiement dépend d’un comportement sûr face aux requêtes répétées, confirmations retardées et défaillances partielles.
Protection contre les opérations répétées
Chaque dépôt, retrait et remboursement reçoit un numéro unique.
Une requête répétée renvoie le résultat existant et ne crée pas de nouvelle opération financière.
Une notification répétée est vérifiée par rapport au numéro d’événement et à l’état actuel du paiement.
La modification du solde est liée au numéro de paiement et n’est appliquée qu’une seule fois.
Comptabilité financière et rapprochement
Conservez séparément le montant, les frais, le montant net, la devise et la référence fournisseur.
Ne réécrivez pas rétroactivement une écriture terminée ; créez un ajustement distinct.
Rapprochez les opérations API, les rapports fournisseurs, les variations de solde et les versements.
Enregistrez chaque écart, sa cause, son responsable et le résultat de sa résolution.
Tests
Éléments à tester avant le lancement
Testez le paiement réussi, le refus, la perte de connexion, la confirmation répétée, le résultat inconnu, le remboursement et le rapprochement financier.
Dépôt et retrait réussis
Tous les statuts intermédiaires, la confirmation, la modification du solde et le reporting final.
Refus de l’opération
Fonds insuffisants, coordonnées invalides, limite dépassée, refus bancaire, examen du risque et moyen de paiement indisponible.
Perte de connexion
La connexion est interrompue après l’envoi de la requête, puis la confirmation arrive plus tard ou est demandée séparément.
Requêtes répétées
La même opération ou confirmation arrive de nouveau après la fin du traitement.
Remboursement et annulation
Remboursement total ou partiel, annulation avant traitement et interdiction d’annuler une opération terminée.
Rapprochement
Le montant, les frais, le statut final, le solde et le rapport du fournisseur concordent après tous les scénarios.
Liste de contrôle avant lancement
Les paiements de production sont activés après vérification des statuts, confirmations, protections contre les doublons, soldes et du reporting financier.
Les environnements de test et de production utilisent des identifiants, des points de terminaison de notification et des comptes différents.
Le retour de l’utilisateur sur le site n’est pas utilisé comme preuve d’un paiement réussi.
La signature et le numéro d’événement sont vérifiés avant toute modification du solde.
Les dépôts, retraits et remboursements sont protégés contre l’exécution répétée.
Un statut inconnu est clarifié auprès du fournisseur et contrôlé lors du rapprochement.
Des alertes d’erreur, des rapports PSP et un processus d’analyse des écarts sont configurés.
Besoin de concevoir un scénario de paiement ?
Envoyez-nous la liste des PSP, moyens de paiement, devises, marchés, règles de solde et statuts. APIACE vous aidera à structurer les dépôts, retraits, remboursements, confirmations et le rapprochement financier.