Guide

Commande payée deux fois : d’où viennent les doublons et ce qui les limite

Mis à jour le

Réponse courte

Cette page traite deux origines d’une commande payée deux fois : le client lance un second paiement, ou la boutique traite deux fois la même notification de la banque. Dans le premier cas, le client peut être débité deux fois. Dans le second, il ne l’est qu’une fois, mais le stock peut être réduit deux fois et les e-mails partir en double.

Des parades limitent ces risques, sans les supprimer : une référence nouvelle à chaque affichage du formulaire, une notification rejouée sans effet, un verrou par commande, et un statut « En attente » plutôt qu’« Échouée » pour un avertissement de fraude Sips.

D’où viennent les doublons

Avec un paiement par redirection (Up2pay e-Transactions, Mercanet, Sherlock’s, Sogenactif), la commande est créée avant le paiement, puis la banque informe la boutique de serveur à serveur. Les doublons naissent entre ces deux moments, quand deux demandes ou deux traitements visent la même commande.

SituationRisqueCe qui le limite
Double clic sur « Commander »deux commandes, ou deux paiements pour un seul achattesté avec Up2pay : une seule commande, une seule redirection
Page de paiement actualisée, retour arrièrela même référence envoyée deux foisune nouvelle référence à chaque affichage
Même notification reçue deux foisstock réduit deux fois, e-mails en doublela seconde ne produit rien
Deux notifications au même instantle même double traitementun verrou par commande
Avertissement de fraude Sips marqué « Échouée » alors que l’autorisation peut être acceptéele client paie une seconde foisstatut « En attente »
Commande en « Attente paiement » alors que le client a payéun second paiement demandévérifier chez la banque avant de relancer

Une notification en double ne crée pas de second paiement : elle informe la boutique du résultat d’une tentative déjà faite.

Une référence nouvelle à chaque affichage du formulaire

Les deux plateformes exigent une référence unique à chaque paiement, qui rattache aussi chaque réponse à une tentative précise.

  • Up2pay e-Transactions : le manuel Paybox System demande une référence (PBX_CMD) « unique à chaque appel ».
  • Sips : la transactionReference identifie une transaction « de manière unique » tout au long de la vie de la boutique.

Le plugin de paiement doit donc créer une nouvelle référence à chaque affichage du formulaire (actualisation, retour arrière après un refus, montant modifié) et l’enregistrer dans la commande avec son montant attendu.

Une notification rejouée ne produit rien de plus

Si la même notification arrive deux fois, la seconde ne doit rien changer. Sinon, la commande est traitée deux fois : stock, e-mails, notes.

Le plugin doit donc mémoriser chaque notification traitée, rejetées comprises. Une notification déjà connue ne produit alors qu’une ligne d’information dans le journal et une réponse 200 à la banque.

Un verrou par commande

Deux notifications traitées au même instant peuvent chacune se croire la première. Un verrou par commande n’autorise qu’un traitement à la fois.

  • S’il est déjà pris, le second appel reçoit une réponse 503 et ne touche pas à la commande.
  • Un verrou abandonné doit expirer, par exemple après 60 secondes.
  • Une fois le verrou pris, la commande est rechargée : jamais de travail sur une copie lue avant.

Le rechargement protège aussi les données des autres extensions : voir point relais écrasé après paiement et HPOS et plugins de paiement.

Un paiement accepté sur une tentative plus ancienne

Une réponse positive peut porter sur une tentative plus ancienne que la dernière. Elle doit être acceptée si les montants concordent, car l’argent est autorisé.

Deux garde-fous complètent la règle :

  • Montant différent : le montant reçu est comparé à celui de la tentative et au total actuel de la commande. En cas d’écart : aucun changement de statut, une note dans la commande et une erreur dans le journal.
  • Commande déjà payée : elle ne repasse jamais à un statut inférieur, et une nouvelle réponse est seulement notée. Deux paiements acceptés laissent donc une trace à vérifier chez la banque.

Avec Sips, un refus, une annulation, une attente ou un avertissement sur une tentative plus ancienne ne doit donner qu’une note : un code 97 (abandon) arrivé tard ne doit pas annuler une tentative plus récente.

Pourquoi un avertissement de fraude reste « en attente »

Avec Sips, un code 05 accompagné de scoreColor=ORANGE est un avertissement de fraude : selon la documentation Sips, l’acquéreur a autorisé le paiement, et c’est au commerçant de l’accepter ou de le refuser dans l’extranet. Marquer la commande « Échouée » pousserait le client à payer une seconde fois : elle doit passer « En attente ». Un code 05 avec scoreColor=RED ou BLACK, ou sans score, reste un refus.

Sips : « Transaction already processed » (code 94)

Ce message signifie que Sips a reçu une référence déjà utilisée. Il refuse la demande avant la saisie de la carte, sur une page titrée « ERROR » :

Transaction already processed : code=94 message=DUPLICATED TRANSACTION

Le même motif existe en code réponse : 94 « Transaction dupliquée », ou 24 « requête déjà effectuée avec les mêmes données ». Ce message a été observé en simulation le 24/09/2026. Une réponse portant l’un de ces codes ne doit pas changer le statut de la commande (voir codes réponse Sips).

Solution pas à pas : Sips, code 94.

Vérifier dans la commande et chez la banque

Pour savoir si un client a vraiment payé deux fois, comparez les paiements notés dans la commande avec les transactions de votre banque.

  1. Ouvrez la commande (WooCommerce → Commandes) et lisez ses notes. Relevez la référence ou le numéro de transaction de chaque paiement accepté.
  2. Lisez le journal (WooCommerce → État → Journaux), à la source de votre plugin de paiement. Une notification rejouée doit y figurer comme déjà traitée, sans autre effet.
  3. Cherchez ces transactions chez la banque, dans le back-office Vision (Up2pay e-Transactions) ou dans l’extranet (Sips).
  4. Deux paiements acceptés pour un seul achat : remboursez celui en trop avec votre banque.
  5. Note d’écart de montant : vérifiez chez la banque le montant autorisé avant de passer la commande en payée.

Ce que fait Relqor

Relqor développe deux plugins de paiement indépendants, non affiliés aux banques, ni à Verifone, ni à Worldline : Up2pay e-Transactions, et Worldline Sips (Mercanet, Sherlock’s, Sogenactif). Leur version 0.1.0 est terminée ; la version gratuite sera bientôt publiée sur WordPress.org. Ils appliqueront les parades de cette page, qui limitent le risque de doublon sans le supprimer.

  • Référence : nouvelle à chaque affichage, enregistrée avec son montant attendu. Elle contiendra l’identifiant interne de la commande : 1234-2 pour la tentative 2 de la commande 1234 avec Up2pay, RQ1234A2N suivi de 10 caractères hexadécimaux aléatoires avec Sips. Ce suffixe aléatoire réduit le risque de doublon sur un compte de test Sips partagé.
  • Rejeu : une notification déjà traitée ne changera rien. Le journal indiquera « IPN déjà traitée » (Up2pay, source relqor) ou « already processed » (Sips, source relqor-sips). Vérifié par un test automatisé Up2pay (statut, notes, stock et e-mails identiques après un rejeu), puis sur de vraies notifications : en recette Up2pay le 26/09/2026, avec Sips le 24/09/2026.
  • Verrou : un par commande, réponse 503 s’il est déjà pris, expiration après 60 secondes, commande rechargée ensuite.
  • Tentatives : avec Sips, un succès sur une tentative plus ancienne sera accepté si les montants concordent ; un refus, une annulation, une attente ou un avertissement y seront seulement notés. Avec Up2pay, toute référence émise pour la commande sera reconnue si le montant concorde.
  • Montant et commande payée : en cas d’écart, aucun changement de statut, une note (« vérification manuelle requise » pour Up2pay) et une erreur au journal. Une commande payée ne sera jamais rétrogradée.
  • Sips : avertissement de fraude laissé « En attente » ; codes 94 et 24 seulement notés.
  • Double clic sur « Commander », Up2pay : testé dans un navigateur réel, au checkout classique et Blocks : une seule commande, une seule redirection, y compris avec deux clics simultanés (12 essais sur 12).
  • Hors périmètre : la version 0.1.0 ne permettra pas de rembourser depuis WooCommerce.

Pour votre banque : Up2pay e-Transactions, Mercanet, Sherlock’s et Sogenactif.

Questions fréquentes

Un plugin peut-il empêcher tout double paiement ?

Non. Il limite les causes techniques. Deux tentatives distinctes, acceptées chacune par la banque, restent possibles : la seconde est seulement notée, à vérifier chez la banque.

Voir aussi