Guide

Worldline Sips 2.0 et WooCommerce : ce qui change par banque

Mis à jour le

Réponse courte

Mercanet (BNP Paribas), Sherlock’s (LCL), Sogenactif (Société Générale) et l’offre Worldline Sips générique reposent toutes sur Worldline Sips 2.0. Avec WooCommerce, elles peuvent toutes se brancher de la même façon : par la page de paiement hébergée « Paypage POST », où le client saisit sa carte chez la banque.

Le formulaire, le calcul du sceau et les codes réponse sont identiques. Seuls changent les adresses des serveurs, les comptes de test et le nom des extranets. Pour chaque mode, test et production, il vous faut trois valeurs : merchantId, keyVersion et la clé secrète. Seule la réponse automatique, à sceau valide, doit faire passer une commande en payée.

Les quatre offres Sips 2.0 couvertes par ce guide

Chaque offre a son environnement de test et ses comptes publics, décrits à l’étape 3 de sa page Paypage POST.

BanqueOffreEnvironnement de testComptes publics
WorldlineWorldline Sips génériquesimulation4 comptes
BNP ParibasMercanetrecettecompte de recette, euro uniquement
LCLSherlock’ssimulation1 seul compte
Société GénéraleSogenactifsimulation4 comptes

Les pages de référence sont : Sips Paypage POST (Worldline), Mercanet Paypage POST, Sherlock’s Paypage POST et Sogenactif Paypage POST.

Ce qui est identique d’une banque à l’autre

Le protocole est le même pour les quatre offres. Leurs documentations décrivent :

  • le même dictionnaire de données, avec InterfaceVersion HP_3.4 ;
  • les mêmes champs obligatoires dans Data : montant en centimes, devise, merchantId, keyVersion, adresse de retour du client et canal de vente (orderChannel) ;
  • le même calcul du sceau ;
  • les mêmes codes réponse (responseCode), détaillés dans codes réponse Sips ;
  • la même règle pour les cartes de simulation. Mercanet, testé en recette, publie en plus ses propres cartes de test.

Le 24/09/2026, la même requête, envoyée aux serveurs de test des quatre offres, a affiché les quatre pages de paiement ; seuls l’adresse et les identifiants changeaient.

Le détail de la requête, champ par champ, est expliqué dans le guide Mercanet et WooCommerce. Il vaut pour les quatre offres.

Ce qui change : adresses, comptes de test, extranets

Adresses paymentInit, en HTTPS, suivies de /paymentInit :

OffreServeur de test
Worldline Sipspayment-webinit.simu.sips-services.com
Mercanetpayment-webinit-mercanet.test.sips-services.com (recette)
Sherlock’ssherlocks-payment-webinit-simu.secure.lcl.fr
Sogenactifpayment-webinit.simu.sogenactif.com
OffreServeur de production
Worldline Sipspayment-webinit.sips-services.com
Mercanetpayment-webinit.mercanet.com
Sherlock’ssherlocks-payment-webinit.secure.lcl.fr
Sogenactifpayment-webinit.sogenactif.com

Mercanet se teste en recette : l’adresse de simulation citée par son dictionnaire de données, payment-webinit.simu.mercanet.com, ne se résolvait pas le 24/09/2026.

Les trois valeurs à réunir pour chaque mode

Ne mélangez jamais le jeu de test et celui de production.

  1. merchantId : l’identifiant de la boutique, 15 chiffres.
  2. keyVersion : la version de la clé secrète, de 1 à 10 chiffres.
  3. La clé secrète. La documentation ne fixe pas son format. Collez-la telle quelle, sans espace.

Une nouvelle clé impose une nouvelle keyVersion. Sinon, Sips répond par le code 34. Voir Sips : code 34.

Le sceau HMAC-SHA-256

Avec SealAlgorithm=HMAC-SHA-256, la requête et les réponses sont scellées en HMAC-SHA-256 avec la clé secrète. Certaines réponses d’erreur arrivent sans sceau.

  • Le sceau se calcule sur Data telle qu’envoyée, encodage compris, avec la clé secrète utilisée comme texte UTF-8.
  • Sans le champ SealAlgorithm, Sips attend un SHA-256 simple, que la documentation ne recommande plus.
  • Une réponse sans sceau, ou avec un sceau faux, doit être ignorée. La documentation Sips dit alors de laisser la transaction en l’état.

La clé secrète n’est jamais envoyée : seul le sceau voyage avec les données.

La réponse automatique décide du statut

Seule la réponse automatique, dont le sceau est valide, doit changer le statut d’une commande. Sips envoie deux réponses au contenu identique :

  • la réponse manuelle, envoyée par le navigateur quand le client clique sur « Continuer ». Le client peut fermer la page avant ;
  • la réponse automatique, envoyée en POST de serveur à serveur, vers l’adresse automaticResponseUrl transmise dans la requête.

Sips accepte pour cette adresse les ports 80 à 9999. Elle doit être joignable depuis Internet : un site installé en local ne reçoit pas la réponse automatique.

En cas d’abandon, la réponse automatique arrive environ 15 à 16 minutes après la redirection, avec le code 97. Selon la documentation, elle peut aussi arriver en retard, ou jamais. Une commande peut donc rester en « Attente paiement » un moment. Voir commande restée en attente.

La documentation Sips 2.0 ne publie aucune liste d’adresses IP sortantes. Seul le sceau fait foi.

Ni page de disponibilité ni serveur de secours documentés

La documentation Sips 2.0 ne décrit ni page de disponibilité ni serveur de secours : côté boutique, il n’y a ni test de disponibilité ni bascule à prévoir, contrairement à Up2pay e-Transactions.

Tester sur l’environnement de votre banque

Testez d’abord sur l’environnement de test de votre banque, avec un compte public et les cartes de test publiées.

  1. Choisissez un compte public à l’étape 3 de la page Paypage POST de votre banque. Notez son merchantId, sa keyVersion et sa clé secrète.
  2. Utilisez l’adresse de test de votre banque (tableau plus haut). Pour Mercanet, c’est le serveur de recette.
  3. Rendez votre site de test joignable depuis Internet, sinon la réponse automatique n’arrivera pas.
  4. Payez avec une carte de test. En simulation, 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, par exemple 4112948576210600 (acceptée). Voir cartes de test Up2pay et Sips.
  5. Ne cliquez pas sur « Continuer » sur la page de la banque. Vérifiez que la commande change quand même de statut : c’est la preuve que la réponse automatique arrive et qu’elle est acceptée.
  6. Testez aussi un refus et un abandon. Pour l’abandon, comptez environ 15 à 16 minutes avant la réponse 97, qui peut aussi arriver plus tard.

Les comptes publics sont partagés entre tous ceux qui testent. Une référence de transaction déjà utilisée est refusée (code 94) : chaque tentative doit en avoir une nouvelle. Voir transaction dupliquée.

Ce que fait Relqor

Le plugin « Relqor — Gateway for Worldline Sips » (version 0.1.0) servira les quatre offres avec un seul réglage « banque ». Il est terminé et a été soumis à WordPress.org, où il sera bientôt disponible gratuitement.

Il proposera :

  • un réglage « banque » (Worldline Sips, Mercanet, Sherlock’s ou Sogenactif) qui ne changera que l’adresse des serveurs, figée et non saisie : une faute de frappe ne pourra pas la modifier ;
  • des identifiants séparés pour le test et la production ;
  • un sceau HMAC-SHA-256 dans les deux sens, jamais de SHA-256 simple ;
  • un changement de statut uniquement par la réponse automatique vérifiée ; une réponse liée à une tentative de l’autre mode (test ou production) sera ignorée ;
  • l’euro seul (code 978) : dans une autre devise, le moyen de paiement ne sera pas proposé, car la documentation Sips présente le multidevise comme une option du contrat d’acquisition ;
  • le checkout classique et le checkout en blocs (Checkout Blocks et paiements bancaires), en HPOS comme en stockage historique (HPOS et plugins de paiement).

Le 24/09/2026, sur un site de test joignable depuis Internet, un paiement de test par offre a été validé par la seule réponse automatique, sans clic sur « Continuer » : la commande est passée en « En cours ». Rejouer la même réponse n’a rien changé.

Le plugin ne crée aucun contrat. L’usage du service de paiement est régi par le contrat que vous signez avec votre banque, ou avec Worldline pour l’offre générique.

Configuration : installer et régler Relqor Sips. Pages banques : Mercanet, Sherlock’s et Sogenactif.

Questions fréquentes

Faut-il un plugin différent pour chaque banque ?

Pas nécessairement. Le protocole est le même : un plugin qui gère les adresses des quatre offres peut les servir toutes. Relqor Sips le fait avec son réglage « banque ».

Relqor est-il affilié à Worldline ou à ma banque ?

Non. Relqor Sips est un plugin indépendant. Il n’est affilié ni à Worldline, ni à BNP Paribas, ni à LCL, ni à Société Générale.

Voir aussi