Mercanet, Sherlock’s, Sogenactif (Sips)
Relqor Sips : mode test et passage en production
En bref. Chaque banque publie des comptes de test publics : serveur de simulation pour Worldline Sips, Sherlock’s et Sogenactif, serveur de recette pour Mercanet. En simulation, les deux derniers chiffres de la carte de test donnent le code réponse. Seule la réponse automatique à sceau valide change le statut de la commande.
Les environnements de test
Chaque banque met à disposition un environnement de test (simulation, ou recette pour Mercanet) avec des comptes publics. Les identifiants de ces comptes sont publiés dans la documentation de chaque banque, à l’« Étape 3 » de la page Paypage POST :
| Banque | Où trouver les comptes publics | Particularité |
|---|---|---|
| Worldline Sips | Sips Paypage POST, Étape 3, « Table 1 : transactionReference généré par le commerçant » | 4 comptes (Tables 1 à 4) |
| Mercanet | Mercanet Paypage POST, Étape 3, « Tester sur l’environnement de recette » | serveur de recette, euro uniquement |
| Sherlock’s | Sherlock’s Paypage POST, Étape 3, « Table 1 : transactionReference généré par Sherlock’s » | un seul compte public |
| Sogenactif | Sogenactif Paypage POST, Étape 3, « Table 1 : transactionReference généré par le commerçant » | 4 comptes |
Saisissez les identifiants du compte choisi dans les champs test des réglages, puis sélectionnez le mode test. Présentation par banque : Mercanet, Sherlock’s, Sogenactif.
Ces comptes sont partagés entre tous les commerçants. Le plugin crée une nouvelle référence, avec un suffixe aléatoire, à chaque affichage du formulaire de paiement, pour éviter les refus pour référence déjà utilisée.
Les cartes de simulation
Sur les environnements de simulation Worldline Sips, Sherlock’s et Sogenactif, les deux derniers chiffres du numéro de carte donnent le code réponse : par exemple, 4100 0000 0000 0005 donne un refus (code 05). Toutes les cartes y sont enrôlées 3-D Secure : vous choisissez le résultat de l’authentification sur la page de simulation. Mercanet publie ses propres cartes de test, pour son serveur de recette.
Les numéros, les types de carte et les règles de date et de cryptogramme sont réunis dans le guide cartes de test Sips et Mercanet. Le guide Mercanet et WooCommerce décrit un parcours de test sur la recette Mercanet.
La réponse automatique, seule source de statut
Seule la réponse automatique de Sips, envoyée de serveur à serveur et dont le sceau est valide, change le statut d’une commande. Le retour du client sur votre site (bouton « Continuer ») ne modifie jamais la commande, car il passe par le navigateur. Tant que la réponse automatique n’est pas arrivée, la page « commande reçue » affiche « Paiement en cours de confirmation ».
Le plugin envoie l’adresse de réponse automatique avec chaque demande de paiement :
https://<site>/?wc-api=relqor_sips_notify
Pour recevoir cette réponse, votre site doit être joignable depuis Internet. Un site installé en local ne la reçoit pas. La réception réelle de la réponse automatique a été vérifiée le 24/09/2026 sur un site de test public, avec un paiement de test par banque (Sips, Mercanet, Sherlock’s, Sogenactif) : elle a suffi, sans clic sur « Continuer », à faire passer la commande en « En cours ». Testez-la aussi sur votre propre site avant la mise en production.
Avant tout changement, le plugin contrôle le sceau, puis le merchantId et la keyVersion du mode actif, la référence, la commande, le mode, le montant et la devise. Un sceau faux reçoit une réponse HTTP 403 et la commande n’est pas touchée. Un contrôle en échec ajoute une note sur la commande, si elle est retrouvée, et une erreur dans le journal, sans changer son statut.
Codes réponse et statuts WooCommerce
Code(s) responseCode | Statut de la commande |
|---|---|
00 avec captureMode AUTHOR_CAPTURE ou IMMEDIATE | payée (via le traitement standard de WooCommerce) |
00 avec un autre captureMode (VALIDATION, AUTHOR_NOCAPTURE) ou sans captureMode | en attente, note « autorisation acceptée, remise en attente de validation » |
60, 62 | en attente |
05 avec scoreColor=ORANGE | en attente, à valider dans l’extranet |
17 (annulation par l’acheteur), 97 (session expirée ou abandon) | annulée |
02 03 05 11 12 14 30 34 40 51 54 55 57 63 75 90 99 | échouée |
01 24 25 94, code inconnu ou absent | aucun changement, note seulement |
Règles complémentaires :
- une commande déjà payée ne revient jamais en arrière ;
- une annulation, un refus ou une mise en attente ne s’appliquent qu’à la dernière tentative de paiement d’une commande encore en « Attente paiement » ;
- chaque réponse traitée ajoute une note avec le code, son libellé, la référence et les informations d’authentification, sans aucune donnée de carte.
Le sens de chaque code et les règles appliquées sont détaillés dans la page codes réponse Sips. Trois cas ont leur page : le code 34 après un changement de clé secrète, la transaction dupliquée (code 94) et la commande annulée après un abandon (codes 17 et 97).
captureMode : pourquoi une commande acceptée peut rester en attente
Le plugin n’envoie pas de captureMode : la configuration de votre boutique chez Worldline s’applique. En mode VALIDATION, les fonds ne sont remisés qu’après une action de votre part (validation de la transaction) : une réponse 00 met donc la commande en attente. Traitez-la ensuite.
Une réponse d’un autre mode est ignorée
Chaque tentative de paiement mémorise le mode (test ou production) dans lequel elle a été créée. Une réponse qui concerne une tentative créée dans un autre mode que le mode actif est ignorée. Une réponse de simulation ne peut donc jamais payer une commande en production.
Passer en production
- Vérifiez qu’un paiement de test complet a bien changé le statut de la commande sur votre site.
- Saisissez le
merchantId, lakeyVersionet la clé secrète de production. - Vérifiez le réglage « banque ».
- Passez le mode sur « production » et enregistrez.
Voir aussi : Commande restée en attente après un paiement.