01 / Parcours
Conservez la référence métier dans chaque événement
L’intégration est plus simple à exploiter lorsque paiement, joueur ou commande et règlement partagent des références dès le départ.
- 01
Créer la session
Envoyez le montant, la devise, la référence métier et le contexte de retour requis selon la requête actuellement documentée.
- 02
Présenter l’expérience de paiement
Dirigez le client vers la page ou la route de paiement configurée renvoyée pour cette session.
- 03
Traiter les événements documentés
Validez et traitez les types d’événement et les champs décrits dans la documentation actuelle de l’API.
- 04
Créditer et rapprocher
Utilisez la référence pour relier l’événement, le joueur ou la commande, le montant crédité et le règlement.
02 / Opérations
Les choix d’intégration qui affectent les opérations
Une intégration utile fait plus qu’ouvrir une page de paiement. Elle préserve références, états et parcours d’échec nécessaires après le lancement.
Conception des références
Choisissez des références stables de joueur, commande ou facture retrouvables dans le système de l’opérateur et le registre Payfux.
Traitement des événements
Traitez uniquement les champs et états documentés et conservez la référence reçue pour l’audit et le rapprochement.
Comportement du retour
Traitez le retour client comme une navigation, non comme la preuve finale qu’un paiement ou un règlement est terminé.
Parcours de rapprochement
Reliez paiements et règlements dans les systèmes de l’opérateur afin d’examiner les écarts par référence.
03 / Conditions
La documentation actuelle prévaut
Les exemples commerciaux décrivent la séquence, mais ne définissent pas les points de terminaison, contenus, signatures, tentatives, états ou niveaux de service de production.
- Utilisez uniquement l’authentification et les champs de requête de la documentation actuelle fournie pour l’environnement du client.
- Ne considérez pas le retour du navigateur comme preuve faisant autorité ; utilisez l’état serveur et le modèle d’événement documentés.
- Testez les échecs, doublons, retards et changements d’état selon le comportement documenté pour l’intégration.
04 / Questions
Questions des opérateurs
Où se trouvent les schémas actuels de l’API Payfux ?
Les schémas, exigences d’authentification et champs actuels figurent dans la documentation de l’API Payfux. Les exemples des pages produit sont explicatifs et ne la remplacent pas.
Le retour du navigateur doit-il marquer le paiement comme terminé ?
Non. Le retour client est une navigation. L’opérateur doit utiliser l’état serveur et les preuves d’événement documentées pour créditer et rapprocher.
Payfux promet-il un calendrier précis de nouvelles tentatives ?
Aucun calendrier n’est annoncé ici. Implémentez le comportement d’événement et de récupération indiqué dans la documentation actuelle du client.
Quelle référence métier l’opérateur doit-il envoyer ?
Utilisez la référence stable de joueur, client, facture ou commande exigée par l’intégration documentée et conservez-la dans le système opérateur.
Les données de test et de production sont-elles interchangeables ?
Non. Séparez les identifiants, points de terminaison, registres et rapprochements de chaque environnement et suivez les contrôles documentés.
Documentation développeur
Commencez par les schémas actuels de requête et d’événement
Utilisez la documentation Payfux pour le comportement exact, puis alignez les références de paiement sur les systèmes de l’opérateur.
Lire la documentation