Guide

Accepter la carte bancaire sur WooCommerce avec votre banque

Mis à jour le

Réponse courte

Pour accepter la carte bancaire sur WooCommerce avec votre banque, il vous faut un contrat de paiement en ligne avec elle, les identifiants qu’elle vous remet et un module de paiement qui redirige vos clients vers sa page de paiement. Chez quatre banques, la solution traitée ici s’appelle : Up2pay e-Transactions (Crédit Agricole), Mercanet (BNP Paribas), Sherlock’s (LCL) et Sogenactif (Société Générale). Une banque peut proposer d’autres offres (voir plus bas).

Le client saisit sa carte sur la page de paiement hébergée par la banque, jamais sur votre site. La commande ne doit passer au statut payé qu’à la réception de la notification que le serveur de la banque envoie à votre boutique. Le retour du client sur la boutique ne suffit pas.

Quelle solution selon votre banque

Chaque banque a sa solution, sous son propre nom, et ces quatre solutions reposent sur deux plateformes techniques.

Votre banqueSolution de paiement en lignePlateforme technique
Crédit AgricoleUp2pay e-TransactionsPaybox (Verifone)
BNP ParibasMercanetWorldline Sips 2.0
LCLSherlock’sWorldline Sips 2.0
Société GénéraleSogenactifWorldline Sips 2.0

Mercanet, Sherlock’s et Sogenactif utilisent la même page de paiement Sips, « Paypage POST », et le même protocole : seuls changent les adresses des serveurs, les comptes de test et le nom des extranets.

Détails par banque : Up2pay e-Transactions, Mercanet, Sherlock’s et Sogenactif. Voir aussi Up2pay, Paybox et Verifone et Worldline Sips 2.0 et WooCommerce.

Ce qu’il vous faut

Un contrat avec votre banque. Un module de paiement n’en crée aucun. Up2pay demande un contrat commerçant Up2pay e-Transactions, Mercanet un contrat d’acceptation, Sherlock’s un contrat d’adhésion et un contrat « Vente à Distance Sécurisée ». Sogenactif relève de votre contrat avec la Société Générale.

Vos identifiants. Chaque solution a les siens, avec un jeu pour le test et un autre pour la production.

SolutionIdentifiantsOù les trouver
Up2pay e-TransactionsSITE (7 chiffres), RANG (2 ou 3 chiffres), IDENTIFIANT (1 à 9 chiffres) et clé HMACavec votre contrat ; la clé HMAC se génère dans le back-office Vision
Mercanet, Sherlock’s, Sogenactifidentifiant commerçant (merchantId), version de clé (keyVersion) et clé secrètel’identifiant commerçant vous est communiqué à l’inscription de la boutique ; la clé secrète et sa version se trouvent dans l’extranet de téléchargement des clés de votre banque

Une boutique en euro (Up2pay, plugins Relqor). Up2pay n’accepte que l’euro (code 978). Les plugins Relqor aussi. Chez les banques Sips, d’autres devises relèvent d’une option du contrat d’acquisition.

Une adresse de notification joignable depuis Internet. La banque informe votre boutique de serveur à serveur. Un site en local ne reçoit pas cette notification. Ports acceptés : 80, 443 et 8080 à 8085 pour Up2pay, 80 à 9999 pour Sips.

Des versions récentes. Les plugins Relqor demandent au minimum WordPress 7.0, WooCommerce 11.0 et PHP 8.1.

Comment se passe un paiement

Le paiement se fait en cinq temps, et seule la notification de la banque change le statut de la commande.

  1. Le client valide sa commande. WooCommerce la crée au statut « Attente paiement » (pending). Le module prépare une tentative de paiement, avec une référence unique.
  2. Son navigateur part vers la page de la banque. Un formulaire signé part automatiquement vers la page de paiement hébergée : en HMAC-SHA512 avec Relqor Up2pay, en HMAC-SHA-256 avec Relqor Sips. La banque refuse une demande mal signée.
  3. Le client saisit sa carte sur cette page. L’authentification 3-D Secure s’y déroule aussi. Le numéro complet de la carte ne passe jamais par votre site.
  4. La banque notifie votre boutique. Son serveur envoie le résultat au vôtre : c’est l’IPN chez Up2pay, la « réponse automatique » chez Sips. Le module doit vérifier la signature, la référence et le montant, puis mettre à jour la commande.
  5. Le client revient sur la boutique. Ce retour n’est pas assuré : le client peut fermer la page. Il ne doit donc jamais changer la commande.

Un paiement accepté fait passer la commande « En cours », ou « Terminée » si tous les articles sont virtuels et téléchargeables : c’est le comportement standard de WooCommerce. Un paiement à confirmer la fait passer « En attente » (voir statut de commande après paiement).

Si une commande reste en « Attente paiement » après un paiement, c’est que la notification n’est pas arrivée ou qu’elle a été rejetée. Voir commande en attente avec Up2pay et commande en attente avec Sips.

Checkout classique, Blocks et HPOS

Un paiement bancaire à redirection fonctionne avec le checkout classique comme avec le checkout en blocs, si le module le prévoit. Trois points à vérifier dans votre module :

  • il déclare sa compatibilité avec les Blocks (cart_checkout_blocks) ; sinon, le moyen de paiement peut manquer au checkout en blocs ;
  • il déclare sa compatibilité avec HPOS (custom_order_tables) ;
  • il lit et écrit les commandes par l’API de WooCommerce, jamais directement en base.

Détails dans Checkout Blocks et paiements bancaires et HPOS et plugins de paiement.

Tester avant d’encaisser

Chaque banque publie des comptes de test publics : vous pouvez tester avant même d’avoir vos propres identifiants.

  1. Passez le module en mode test. Les paiements partent alors vers le serveur de test : recette-tpeweb.e-transactions.fr pour Up2pay, un serveur de simulation ou de recette propre à chaque banque pour Sips.
  2. Saisissez des identifiants de test. Pour Up2pay, le Crédit Agricole publie un compte de test mutualisé (SITE 1999887) et sa clé de démonstration. Pour Sips, chaque banque publie ses comptes de test.
  3. Payez avec une carte de test. Sur les serveurs de simulation Sips, les deux derniers chiffres du numéro de carte donnent le code réponse : une carte finissant par 05 simule un refus. Mercanet a ses propres cartes. Voir cartes de test Up2pay et Sips.
  4. Vérifiez le statut sans revenir sur la boutique. Si la commande change de statut alors que le client n’a pas cliqué pour revenir, la notification fonctionne.
  5. Passez en production. Saisissez vos identifiants de production, puis changez de mode. Pour Up2pay, la clé HMAC de production diffère de celle de test.

Pas à pas détaillés : configurer Up2pay en mode test, Mercanet et WooCommerce, puis la documentation mode test Up2pay et mode test Sips.

Si votre contrat porte sur une autre offre de votre banque

Dans ce cas, les plugins Relqor ne s’appliquent pas : l’un vise la page de paiement hébergée d’Up2pay e-Transactions (protocole Paybox System), l’autre la page « Paypage POST » de Worldline Sips 2.0. Si vos identifiants diffèrent de ceux du tableau plus haut, demandez à votre banque le nom exact de la solution prévue par votre contrat.

La version 1 des deux plugins ne gère pas non plus le paiement en plusieurs fois, les abonnements ni le remboursement depuis WooCommerce.

Si votre banque n’est pas l’une des quatre du tableau, Relqor ne propose pas de plugin pour son offre. Seule exception : un contrat Worldline Sips signé directement avec Worldline. Relqor Sips le couvrira par son réglage « Worldline Sips générique ».

Ce que fait Relqor

Relqor édite deux plugins WooCommerce gratuits : Relqor Up2pay pour le Crédit Agricole, et Relqor Sips pour BNP Paribas, LCL et Société Générale. Terminés en version 0.1.0, ils ne sont pas encore publiés sur WordPress.org ; ils y seront proposés gratuitement, sous licence GPL.

Les deux plugins :

  • ne changeront le statut d’une commande qu’après la notification de la banque, signature vérifiée ;
  • fonctionneront avec le checkout classique et le checkout Blocks, en HPOS comme en stockage historique ;
  • ne modifieront jamais l’adresse de livraison ni les données de point relais ;
  • garderont des réglages de test et de production séparés, conservés lors des mises à jour ;
  • n’accepteront que l’euro : dans une autre devise, le moyen de paiement ne sera pas proposé.

En test, la notification réelle a validé les paiements : le 24/09/2026 pour Sips (un paiement par serveur), le 26/09/2026 pour Up2pay (checkout classique et Blocks). La rejouer n’a rien changé.

Relqor est un éditeur indépendant : ses plugins ne sont affiliés ni aux banques ni à leurs prestataires. Voir la page Compatibilité testée et la documentation.

Questions fréquentes

Faut-il un contrat avec ma banque ?

Oui, pour encaisser de vrais paiements. Les tests peuvent se faire avant, avec les comptes publics de chaque banque.

Voir aussi