Erreur courante
Codes réponse Sips et statut de la commande WooCommerce
Le code réponse Sips, champ responseCode, donne l’issue d’un paiement Mercanet, Sherlock’s, Sogenactif ou Worldline Sips : 00 pour une opération acceptée, 60 et 62 pour une attente, 17 pour une annulation par l’acheteur, 97 pour une session expirée (paiement abandonné), 05 et seize autres codes pour un refus. Avec Relqor Sips, ce code pourra changer le statut de la commande WooCommerce, seulement s’il arrive par la réponse automatique à sceau valide et passe les contrôles du plugin.
En bref. Pour une commande pas encore payée, Relqor Sips appliquera ces statuts. 00 : payée, ou « En attente » selon le mode de remise. 60, 62 et 05 avec scoreColor=ORANGE : « En attente ». 17 et 97 : « Annulée ». 05 et les autres codes de refus : « Échouée ». 01, 24, 25, 94, code inconnu ou absent : une note seulement. Sauf pour 00, ces statuts ne s’appliqueront qu’à la dernière tentative de paiement d’une commande en « Attente paiement » (pending).
Où lire le code
Le code sera écrit dans une note de la commande, à chaque réponse automatique traitée.
- Ouvrez la commande dans l’administration WooCommerce et lisez ses notes. Chaque réponse traitée y ajoutera le code et son libellé, la
transactionReference, l’authorisationId, la marque de la carte (paymentMeanBrand), le résultat 3-D Secure (holderAuthentStatus,holderAuthentType), leguaranteeIndicatoret le code de l’acquéreur (acquirerResponseCode). - Lisez le libellé. Il reprend le dictionnaire de la réponse Paypage de Sips, en français sur un site réglé en français de France (
fr_FR). Un code absent du dictionnaire s’affichera « Code non documenté ». - Si la commande n’a aucune note, ouvrez WooCommerce > État > Journaux, source
relqor-sips. Les réponses dont le sceau est refusé et les contrôles en échec y seront consignés, en anglais. - Recherchez la transaction dans l’extranet de votre banque, avec sa référence.
Les données de carte masquées (maskedPan, tokenPan) ne seront jamais recopiées dans la note ni dans le journal.
Tableau : code réponse et statut de la commande
Voici la règle de Relqor Sips (version 0.1.0), pour une commande pas encore payée dont la réponse a passé tous les contrôles. Sauf pour 00, ces statuts ne s’appliqueront qu’à la dernière tentative de paiement d’une commande en « Attente paiement » (pending).
responseCode | Libellé Sips (abrégé) | Statut de la commande |
|---|---|---|
00 | Opération acceptée | payée si captureMode vaut AUTHOR_CAPTURE ou IMMEDIATE, sinon « En attente » |
60 | Transaction en attente | « En attente » |
62 | En attente de confirmation | « En attente » |
17 | Annulation de l’acheteur | « Annulée » |
97 | Session expirée, transaction refusée | « Annulée » |
05 avec scoreColor=ORANGE | Autorisation refusée, avertissement de fraude | « En attente », à valider dans l’extranet |
05 (autres cas) | Autorisation refusée | « Échouée » |
02, 03, 11, 12, 14, 30, 34, 40, 51, 54, 55, 57, 63, 75, 90, 99 | Refus (détail plus bas) | « Échouée » |
01, 24, 25, 94, code inconnu ou absent | Sans effet sur la commande | aucun changement, note seulement |
« Payée » désigne le traitement standard de WooCommerce : la commande passe « En cours », ou « Terminée » si tous ses produits sont virtuels et téléchargeables.
00 : accepté, et pourquoi le mode de remise (captureMode) compte
Le code 00 signifie que l’autorisation est acceptée. Il ne dit pas si les fonds seront remisés sans action de votre part : c’est le champ captureMode qui l’indique.
Relqor Sips n’enverra pas de captureMode : la configuration de votre boutique chez Worldline s’appliquera, sans être écrasée. Selon la valeur reçue :
AUTHOR_CAPTUREouIMMEDIATE: la commande sera payée ;VALIDATION,AUTHOR_NOCAPTUREou champ absent : la commande sera mise « En attente », avec la note « Autorisation acceptée, remise en attente de validation ».
En mode VALIDATION, les fonds ne sont remisés qu’après une action de votre part. Validez la transaction dans l’extranet, puis traitez la commande.
Selon la documentation Sips, vous pouvez aussi décider de livrer en fonction du champ guaranteeIndicator (Y, N, U ou vide), repris dans la note.
60 et 62 : en attente
Les codes 60 (« Transaction en attente ») et 62 (« En attente de confirmation ») mettront la commande « En attente ». Cela ne vaudra que pour la dernière tentative de paiement d’une commande en « Attente paiement ».
Le client qui revient sur la boutique après un code 00, 60 ou 62 arrivera sur la page « commande reçue ». Tant que la réponse automatique n’aura pas confirmé le paiement, cette page affichera « Paiement en cours de confirmation ».
Avant d’expédier, vérifiez l’état de la transaction dans l’extranet de votre banque.
17 et 97 : annulée
Les codes 17 (« Annulation de l’acheteur ») et 97 (« Session expirée, transaction refusée ») feront passer la commande en « Annulée ». À deux conditions : la réponse porte sur la dernière tentative de paiement, et la commande est encore en « Attente paiement ».
Le code 97 arrive en différé. Selon la documentation Sips, quand le client abandonne le paiement, la session expire après 15 minutes d’inactivité. La réponse automatique arrive alors environ 15 à 16 minutes après la redirection, avec le code 97, sans réponse manuelle. La documentation indique de ne pas livrer la commande.
Si le client a relancé le paiement entre-temps, la nouvelle tentative a sa propre référence : le 97 de l’ancienne n’ajoutera qu’une note. Une commande payée ou « En attente » ne sera pas annulée. Détails : Sips : commande annulée après un abandon.
05 : refus, sauf avertissement de fraude (scoreColor ORANGE)
Le code 05 signifie « Autorisation refusée » : la commande passera en « Échouée ». Exception : avec scoreColor=ORANGE, elle sera mise « En attente », à valider dans l’extranet.
Selon la documentation Sips, c’est un avertissement de fraude : l’acquéreur a autorisé le paiement, mais le moteur de fraude de Worldline Sips émet un avertissement au regard des règles que vous avez configurées. Marquer la commande « Échouée » pousserait le client à payer une deuxième fois.
Pour traiter un avertissement de fraude :
- Repérez la référence (
transactionReference) dans la note de la commande. - Ouvrez la transaction dans l’extranet de votre banque.
- Cherchez la cause de l’avertissement : selon la documentation Sips, elle figure dans le détail des règles de fraude exécutées (champ
preAuthorisationRuleResultList). - Acceptez la transaction (
acceptChallenge) si elle n’est pas risquée. Sinon, refusez-la (refuseChallenge). - Traitez ensuite la commande selon votre décision.
Les autres cas de 05 restent des refus :
- échec 3-D Secure (
holderAuthentStatusFAILURE, dans la note) : selon la documentation Sips, pas forcément une fraude ; le client peut payer autrement ; - refus du moteur de fraude (
scoreColorREDouBLACK) : ne livrez pas ; - refus de l’acquéreur sans lien avec la fraude : son code (
acquirerResponseCode) figure dans la note.
Autres refus
Seize autres codes feront passer la commande en « Échouée ». Le client qui clique sur « Continuer » reviendra sur la page de paiement de sa commande : il pourra payer à nouveau, avec une nouvelle référence.
| Code | Libellé Sips (abrégé) |
|---|---|
02 | Demande d’autorisation par téléphone (dépassement de plafond) |
03 | Contrat commerçant invalide |
11 | PAN en opposition (contrôle différé) |
12 | Transaction invalide |
14 | Coordonnées du moyen de paiement invalides ou vérification AVS échouée |
30 | Erreur de format |
34 | Suspicion de fraude (sceau erroné) |
40 | Fonction non supportée |
51 | Montant trop élevé |
54 | Date de validité du moyen de paiement dépassée |
55 | Cartes prépayées non acceptées |
57 | Remboursement refusé (impayé sur la transaction d’origine) |
63 | Règles de sécurité non respectées |
75 | Nombre de tentatives de saisie dépassé |
90 | Service temporairement indisponible |
99 | Problème temporaire du serveur de paiement |
Trois cas demandent une action :
34: une nouvelle clé secrète impose une nouvellekeyVersion, sinon Sips répond34. Voir Sips : code 34 après un changement de clé. La documentation Sips décrit aussi un34renvoyé avec un code de l’acquéreur : refus pour fraude, ne livrez pas.75: plusieurs saisies de carte ont échoué. Selon la documentation Sips, deux causes sont possibles : le client a eu du mal à saisir sa carte, ou quelqu’un cherche des numéros de carte valides. Contactez le client.90et99: problème technique temporaire. Proposez au client de payer plus tard.
Codes sans effet : 01, 24, 25, 94
Ces codes ne changeront pas le statut : Relqor Sips ajoutera seulement une note. Un code inconnu ou absent sera traité de la même façon.
01: succès partiel, réservé aux méthodespanToTokenettokenToPan;24: pour une création de paiement, requête déjà effectuée avec les mêmes données ;25: transaction inconnue de Worldline Sips ;94: transaction dupliquée, latransactionReferenceest déjà utilisée.
24 et 94 signalent une référence déjà utilisée. Pour les éviter, le plugin créera une nouvelle référence, terminée par un suffixe aléatoire, à chaque affichage du formulaire de paiement. Voir Sips : transaction dupliquée, code 94.
Règles appliquées par le plugin
Relqor Sips vérifiera d’abord la réponse, puis l’état de la commande et de la tentative de paiement.
- Seule la réponse automatique, envoyée de serveur à serveur avec un sceau valide, changera le statut. Le retour du client ne modifiera jamais la commande. Un sceau absent ou faux sera rejeté (HTTP 403), sans écriture sur la commande.
- Après un sceau valide, le plugin contrôlera le
merchantIdet lakeyVersiondu mode actif, la référence, la commande, le mode (test ou production), le montant et la devise. Un contrôle en échec ajoutera une erreur au journal et, si la commande est trouvée et payée avec Relqor Sips, une note, sans changement de statut. - Une commande déjà payée ne recevra qu’une note : jamais de retour en arrière.
- Une annulation (
17,97), un refus, un code60ou62, ou un avertissement de fraude ne s’appliqueront qu’à la dernière tentative d’une commande en « Attente paiement ». Une commande « En attente » ne sera donc jamais annulée automatiquement. - Un succès sur une tentative plus ancienne sera accepté si les montants concordent : l’argent est autorisé.
- Un succès sur une commande « Remboursée », statut que WooCommerce ne peut pas passer en payé, ajoutera une note d’anomalie, sans changement.
- Une réponse déjà traitée (même référence, même code) ne produira plus rien.
Questions fréquentes
Les codes sont-ils les mêmes sur Mercanet, Sherlock’s et Sogenactif ?
Oui. Mercanet, Sherlock’s, Sogenactif et Worldline Sips utilisent le même protocole, Sips 2.0 Paypage POST. Seuls changent les adresses des serveurs, les comptes de test et le nom des extranets. Voir Worldline Sips 2.0 et WooCommerce.
Comment obtenir un code précis en test ?
En simulation Worldline Sips, Sherlock’s et Sogenactif, les deux derniers chiffres de la carte donnent le code réponse : 4100 0000 0000 0005 donne un refus 05. Mercanet publie ses propres cartes. Voir les cartes de test Up2pay et Sips et le mode test de Relqor Sips.
Que faire si aucune réponse n’arrive ?
Elle peut arriver en retard, ou jamais : la commande reste alors en « Attente paiement ». Après environ 16 minutes, la documentation Sips propose de rechercher la transaction dans l’extranet. Voir Sips : commande restée en attente après un paiement.
Voir aussi
- Sips : code réponse 34 après un changement de clé secrète
- Sips : transaction dupliquée, code 94
- Sips : commande restée en attente après un paiement
- Sips : commande annulée après un abandon (codes 17 et 97)
- Relqor Sips : mode test et passage en production
- Installer et régler Relqor Sips
- Cartes de test Up2pay e-Transactions, Mercanet, Sherlock’s et Sogenactif
- Worldline Sips 2.0 et WooCommerce : Mercanet, Sherlock’s, Sogenactif
- Mercanet et WooCommerce : fonctionnement et configuration
- Quel statut de commande WooCommerce après un paiement par carte ?
- Pages banques : Mercanet, Sherlock’s et Sogenactif
- Toutes les erreurs de paiement courantes