Erreur courante

Codes réponse Sips et statut de la commande WooCommerce

Mis à jour le

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.

  1. 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), le guaranteeIndicator et le code de l’acquéreur (acquirerResponseCode).
  2. 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é ».
  3. 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.
  4. 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).

responseCodeLibellé Sips (abrégé)Statut de la commande
00Opération acceptéepayée si captureMode vaut AUTHOR_CAPTURE ou IMMEDIATE, sinon « En attente »
60Transaction en attente« En attente »
62En attente de confirmation« En attente »
17Annulation de l’acheteur« Annulée »
97Session expirée, transaction refusée« Annulée »
05 avec scoreColor=ORANGEAutorisation 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, 99Refus (détail plus bas)« Échouée »
01, 24, 25, 94, code inconnu ou absentSans effet sur la commandeaucun 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_CAPTURE ou IMMEDIATE : la commande sera payée ;
  • VALIDATION, AUTHOR_NOCAPTURE ou 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 :

  1. Repérez la référence (transactionReference) dans la note de la commande.
  2. Ouvrez la transaction dans l’extranet de votre banque.
  3. 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).
  4. Acceptez la transaction (acceptChallenge) si elle n’est pas risquée. Sinon, refusez-la (refuseChallenge).
  5. Traitez ensuite la commande selon votre décision.

Les autres cas de 05 restent des refus :

  • échec 3-D Secure (holderAuthentStatus FAILURE, dans la note) : selon la documentation Sips, pas forcément une fraude ; le client peut payer autrement ;
  • refus du moteur de fraude (scoreColor RED ou BLACK) : 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.

CodeLibellé Sips (abrégé)
02Demande d’autorisation par téléphone (dépassement de plafond)
03Contrat commerçant invalide
11PAN en opposition (contrôle différé)
12Transaction invalide
14Coordonnées du moyen de paiement invalides ou vérification AVS échouée
30Erreur de format
34Suspicion de fraude (sceau erroné)
40Fonction non supportée
51Montant trop élevé
54Date de validité du moyen de paiement dépassée
55Cartes prépayées non acceptées
57Remboursement refusé (impayé sur la transaction d’origine)
63Règles de sécurité non respectées
75Nombre de tentatives de saisie dépassé
90Service temporairement indisponible
99Problème temporaire du serveur de paiement

Trois cas demandent une action :

  • 34 : une nouvelle clé secrète impose une nouvelle keyVersion, sinon Sips répond 34. Voir Sips : code 34 après un changement de clé. La documentation Sips décrit aussi un 34 renvoyé 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.
  • 90 et 99 : 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éthodes panToToken et tokenToPan ;
  • 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, la transactionReference est 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 merchantId et la keyVersion du 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 code 60 ou 62, 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