Liens de paiement : comment confirmer une commande sans la traiter deux fois

Liens de paiement : comment confirmer une commande sans la traiter deux fois

Imaginez qu’un client règle une commande de 49 € via un lien de paiement, ferme l’onglet et ne revient jamais sur votre site. Votre application doit quand même pouvoir confirmer la commande. Si le client revient alors que le paiement est encore en traitement, la page doit lui indiquer que la vérification est en cours.

Voici un modèle simple pour gérer ces deux cas.

Séparez le retour du client et la confirmation du paiement

À la création de la commande, enregistrez sa référence, le montant attendu et la devise. Associez ensuite la référence de la tentative de paiement à cette commande. Si le même lien sert à plusieurs clients, son adresse seule ne permet pas d’identifier un règlement.

Au retour du client, affichez « Paiement en cours de vérification » tant que votre serveur n’a pas reçu de confirmation. Le retour dans le navigateur indique simplement que le client est revenu. Pour confirmer le paiement, utilisez une notification authentifiée du prestataire, appelée webhook, ou vérifiez le statut auprès de son API côté serveur.

Ne déclenchez la préparation qu’une seule fois

Une même notification peut arriver plusieurs fois. Deux notifications différentes peuvent aussi concerner le même paiement. Mémoriser les identifiants des notifications aide à repérer les répétitions. Pour éviter deux préparations, protégez également l’action au niveau de la commande.

Voici le principe en pseudo-code. Le nom des événements et la vérification de leur signature dépendent du prestataire.

Vérifier la signature de la notification. Retrouver la commande par la référence du paiement. Continuer seulement si le paiement est confirmé et si le montant et la devise correspondent à la commande. Dans une transaction en base : Si la commande passe de « en attente » à « payée » : Enregistrer une tâche de préparation unique pour cette commande.

Si le service qui prépare la commande relance une tâche après une panne, utilisez aussi la référence de commande pour éviter de répéter l’action finale. Une notification tardive ne doit pas faire revenir une commande payée à l’état « en attente ». Les remboursements suivent leur propre parcours.

Quatre essais avant la mise en ligne

Scénario Résultat attendu
Le client ferme son navigateur après avoir payé. Le serveur confirme la commande quand la notification arrive.
Le client revient avant la confirmation. La page affiche « en cours de vérification ».
La confirmation est reçue deux fois. Une seule tâche de préparation est créée.
La référence, le montant ou la devise ne correspondent pas. La commande reste à vérifier et la préparation ne démarre pas.

Pour prolonger le sujet côté marchand, le blog NeoPay propose des guides sur les statuts de transaction et les paiements en traitement.

La première version de cet article a été générée avec Codex, un outil d’IA. Cette contribution est proposée par NeoPay.