Erreur courante
Codes retour Up2pay e-Transactions (Paybox) et statut de la commande
Le code retour Up2pay e-Transactions donne le résultat d’un paiement : 00000 pour un paiement accepté, 99999 pour un paiement en attente, 001xx pour un refus de la banque, et d’autres codes pour les erreurs. Avec Relqor, c’est ce code, reçu dans la notification signée de la plateforme (IPN), qui fixe le statut de la commande WooCommerce.
En bref. Avec un numéro d’autorisation, 00000 rend la commande payée ; sans lui, le statut ne change pas. 99999 la fait passer « En attente » : une notification définitive suivra. 001xx (sauf 00117), 00006 et les autres codes d’erreur du tableau ci-dessous la font passer « Échouée ». Les codes 00117 et 00030 sont traités à part. Le plugin ne fait jamais repasser une commande payée à un statut inférieur.
Où lire le code retour
Le code figure dans les notes de la commande et dans le journal du plugin. Le client ne le voit pas : il reçoit un message de refus générique.
- Ouvrez WooCommerce › Commandes, puis la commande concernée.
- Lisez les notes de commande. En cas de refus, la note reprend le code et son libellé, par exemple
00151et « Provision insuffisante ou crédit dépassé ». - Ouvrez WooCommerce › État › Journaux et choisissez la source
relqor. Cherchez l’ID de la commande ou la référence du paiement. Sur un site en français, les messages s’affichent en français.
Pour les développeurs : la plateforme renvoie le code dans la lettre E de PBX_RETOUR. Le plugin la reçoit sous le nom rq_err et l’enregistre dans la métadonnée de commande _relqor_code. Il ne l’enregistre pas si la notification est rejetée : référence ou montant qui ne correspondent pas, ou 00000 sans numéro d’autorisation. Après le paiement, une nouvelle notification dont la référence et le montant correspondent remplace la valeur de _relqor_code, sans changer le statut.
La page de retour du client ne change jamais le statut. Seule la notification serveur à serveur, dont la signature est vérifiée, le fait.
Tableau des codes retour et des statuts WooCommerce
Chaque code du tableau mène à un statut précis. Les libellés viennent du chapitre 12 du manuel d’intégration Up2pay e-Transactions du Crédit Agricole.
| Code | Sens selon la documentation | Statut de la commande |
|---|---|---|
00000 avec numéro d’autorisation | Opération réussie | En cours, ou Terminée si tous les articles sont virtuels et téléchargeables |
00000 sans numéro d’autorisation | Incohérent : le numéro d’autorisation manque | Statut inchangé, note et erreur dans le journal |
99999 | Opération en attente de validation par l’émetteur | En attente |
001xx (sauf 00117) | Paiement refusé par le centre d’autorisation | Échouée |
00001 | La connexion au centre d’autorisation a échoué ou une erreur interne est survenue | Échouée |
00003 | Erreur de la plateforme | Échouée |
00004 | Numéro de porteur ou cryptogramme visuel invalide | Échouée |
00006 | Accès refusé ou site/rang/identifiant incorrect | Échouée |
00008 | Date de fin de validité incorrecte | Échouée |
00009 | Erreur de création d’un abonnement | Échouée |
00010 | Devise inconnue | Échouée |
00011 | Montant incorrect | Échouée |
00015 | Paiement déjà effectué | Échouée |
00016 | Abonné déjà existant | Échouée |
00021 | Carte non autorisée | Échouée |
00029 | Carte non conforme | Échouée |
00031, 00032 | Réservé | Échouée |
00033 | Code pays de l’adresse IP du navigateur non autorisé | Échouée |
00040 | Opération sans authentification 3-D Secure, bloquée par le filtre | Échouée |
001A1, 001A4, 001R1, 001R3 | Codes ajoutés avec la DSP2 | Échouée |
Code inconnu du plugin (hors 001xx) | Absent de la liste des codes du plugin | Échouée, note « Code de retour inconnu » |
Ces statuts s’appliquent à une commande qui n’est pas encore payée. Pour une commande déjà payée, une notification ne change plus le statut (voir plus bas). Les codes 00117 et 00030 sont traités à part (voir plus bas). Le sens de chaque statut est détaillé dans le guide Statut de commande WooCommerce après paiement.
00000 : paiement accepté, seulement avec un numéro d’autorisation
Le code 00000 valide la commande seulement si la notification contient aussi un numéro d’autorisation. Sans ce numéro, le statut ne change pas.
- Avec numéro d’autorisation : le plugin applique le comportement standard de WooCommerce (
payment_complete()). La commande passe « En cours », ou « Terminée » si tous les articles sont virtuels et téléchargeables. - La note de commande commence par « Paiement accepté ». Elle donne le numéro d’autorisation, le numéro de transaction et les informations 3-D Secure.
- Sans numéro d’autorisation : le manuel Paybox System de Verifone indique qu’un paiement réussi porte un numéro d’autorisation. Le statut ne change pas. Le plugin ajoute une note qui demande une vérification manuelle et écrit une erreur dans le journal. Vérifiez la transaction dans le back-office Vision avant toute action à la main.
En recette, le numéro d’autorisation vaut toujours XXXXXX. Un paiement de test accepté valide donc la commande normalement.
99999 : en attente de validation par l’émetteur
Le code 99999 signifie que la banque qui a émis la carte doit encore valider l’opération. La commande passe « En attente » (on-hold) et une notification définitive suivra.
- Au retour sur la boutique, le client voit « Paiement en cours de confirmation ».
- Quand la notification définitive arrive, la commande prend le statut de ce nouveau code : payée pour un
00000avec autorisation, « Échouée » pour un refus (sauf00117, voir plus bas). - Ne confondez pas « En attente » (
on-hold) et « Attente paiement » (pending). Une commande reste en « Attente paiement » quand aucune notification valide n’est arrivée. Elle y reste aussi quand une notification signée a été rejetée : montant ou référence qui ne correspondent pas, ou00000sans numéro d’autorisation. Une note de commande ou le journal l’indique. Voir Commande restée en attente de paiement.
001xx : refus du centre d’autorisation
Un code de la forme 001xx signifie que le centre d’autorisation a refusé le paiement. Les deux derniers chiffres (xx) sont le code de la banque. La commande passe « Échouée », avec le code et son libellé dans la note.
Exception : le code 00117 (« Annulation client ») ne fait pas passer la commande « Échouée ». Le plugin le traite à part, comme le code 00030 (délai de la page de paiement dépassé). Ce traitement doit encore être confirmé par une notification réelle : il n’est pas décrit ici.
Quelques exemples, avec les libellés du tableau 5 du manuel Paybox System (§12.1) :
| Code retour | Libellé de la banque |
|---|---|
00103 | Commerçant invalide |
00105 | Ne pas honorer |
00119 | Répéter la transaction ultérieurement |
00134 | Suspicion de fraude |
00141 | Carte perdue |
00143 | Carte volée |
00151 | Provision insuffisante ou crédit dépassé |
00154 | Date de validité de la carte dépassée |
00157 | Transaction non permise à ce porteur |
00191 | Émetteur de cartes inaccessible |
Après un refus, le client revient sur la page de paiement de sa commande. Il peut réessayer : chaque essai crée une nouvelle référence de paiement.
00001, 00003, 00004 : connexion, plateforme, carte ou cryptogramme
Ces trois codes font passer la commande « Échouée ». Ils signalent un problème de connexion, une erreur de la plateforme, ou un numéro de carte ou un cryptogramme invalide.
00001: la connexion au centre d’autorisation a échoué ou une erreur interne est survenue.00003: erreur de la plateforme.00004: numéro de porteur ou cryptogramme visuel invalide.
Pour ces trois codes, comme pour tout refus, le client voit un message générique qui l’invite à réessayer. Pour 00004, il peut refaire le paiement en vérifiant le numéro de sa carte et son cryptogramme.
00006 : accès refusé ou identifiants incorrects
Le code 00006 vient de la configuration de la boutique, pas de la carte du client. La commande passe « Échouée » et le journal demande de vérifier SITE, RANG, IDENTIFIANT et la clé HMAC.
La documentation le décrit comme « accès refusé ou site/rang/identifiant incorrect ». Le manuel Up2pay du Crédit Agricole l’associe aussi à une erreur de clé HMAC. Contrôlez les identifiants du mode actif (test ou production) et la clé du même mode. La procédure complète est sur la fiche Code 00006 : accès refusé ou identifiants incorrects.
Si la page de paiement affiche « Incohérence des paramètres / Accès refusé » avant même la saisie de la carte, voir la page « Incohérence des paramètres / Accès refusé » (HMAC).
Codes ajoutés avec la DSP2 : 001A1, 001A4, 001R1, 001R3
Ces quatre codes sont décrits dans le manuel d’intégration DSP2 de Verifone (§4.1). S’ils arrivent dans la notification, la commande passe « Échouée », avec le libellé du code dans la note.
001A1: authentification 3-D Secure requise.001A4: utilisation incorrecte de l’exemption TRA (analyse de risque).001R1: révocation d’un paiement récurrent.001R3: révocation de toutes les échéances d’un paiement récurrent.
Code inconnu
Un code que le plugin ne connaît pas fait passer la commande « Échouée ». La note donne le code reçu et la mention « Code de retour inconnu ». Les codes de la forme 001xx ne sont pas concernés : ils restent des refus de la banque.
- Relevez le code, l’ID de commande et la référence du paiement dans le journal
relqor. - Vérifiez la transaction dans le back-office Vision.
- Si besoin, écrivez au support avec le message du journal. Ne transmettez jamais votre clé HMAC.
Une notification ne fait pas revenir une commande payée en arrière
Le plugin ne fait jamais repasser une commande déjà payée à un statut inférieur. Une notification de refus reçue ensuite est notée dans le journal et dans une note ; le statut ne change pas.
Deux autres règles protègent la commande :
- une notification déjà traitée, puis reçue de nouveau, ne produit rien de plus ;
- une notification dont la signature est invalide est ignorée : la commande n’est pas modifiée et aucune note n’est ajoutée.
Questions fréquentes
Le client dit que sa banque a refusé le paiement : où voir la raison ?
Dans les notes de la commande. Le client ne voit qu’un message générique. La note, elle, donne le code 001xx et le libellé de la banque, par exemple « Provision insuffisante ou crédit dépassé » pour 00151.
Pourquoi la commande reste-t-elle en attente de paiement au lieu de passer « Échouée » ?
Parce que le plugin n’a appliqué aucun code retour. Soit aucune notification valide n’est arrivée : sans notification, aucun code n’est lu. Soit une notification signée a été rejetée : montant ou référence qui ne correspondent pas, ou 00000 sans numéro d’autorisation. Une note de commande ou le journal l’indique. Voir le guide Commande en attente de paiement après un paiement Up2pay.
Mercanet, Sherlock’s et Sogenactif utilisent-ils les mêmes codes ?
Non. Ces offres reposent sur Worldline Sips, qui a ses propres codes réponse, par exemple 34 ou 94. Voir Codes réponse Sips et statut de la commande WooCommerce.
Voir aussi
- Code 00006 : accès refusé ou identifiants incorrects
- « Incohérence des paramètres / Accès refusé » (HMAC)
- Commande restée en attente de paiement (Up2pay)
- Mode test et passage en production (Up2pay)
- Guide : commande en attente après un paiement Up2pay
- Guide : statut de commande WooCommerce après paiement
- Up2pay e-Transactions pour WooCommerce
- Toutes les erreurs courantes