---
title: "Liens de paiement : comment confirmer une commande sans la traiter deux fois"
url: https://memory.wiki/ggxD_bIM
updated: 2026-11-21T08:30:21.906Z
source: "api"
---
# 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.

```text
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](https://neopay.io/blog) 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.*

---

## Summary
Pour confirmer une commande sans risque de doublon, il faut dissocier le retour du client de la confirmation serveur via des notifications authentifiées. La préparation de la commande doit être protégée par une transaction en base de données qui vérifie le statut du paiement et l'unicité de l'action.

## Themes
- Paiement en ligne
- Gestion des webhooks
- Idempotence des commandes
- Confirmation de transaction

## Key takeaways
- Le statut de la commande doit passer de en attente a payee uniquement au sein d'une transaction en base de donnees.
- Les notifications de paiement doivent etre authentifiees et verifiees par le serveur avant tout traitement.
- La preparation d'une commande doit etre declenchee par une tache unique pour eviter les doublons lors de receptions multiples de notifications.
- Le montant et la devise doivent etre valides lors de la reception de la notification pour confirmer la commande.
- Le retour du client sur le site ne constitue pas une preuve de paiement et doit afficher un message d'attente.

## Insights
- La confirmation d'une commande doit être découplée de l'action de retour du client sur le site marchand.
- La protection contre les doublons nécessite une vérification d'état au niveau de la base de données et un suivi des identifiants de notifications.
- Une notification de paiement ne doit jamais faire régresser une commande déjà marquée comme payée.

## Open questions / gaps
- Comment gerer techniquement la re-tentative de notification en cas d'echec de communication avec le serveur marchand?

