Guide

Changer de clé HMAC ou de clé secrète Sips : étapes et contrôles

Mis à jour le

Réponse courte

Générez la nouvelle clé chez votre banque, saisissez-la aussitôt dans votre plugin pour le bon mode (test ou production), puis faites un paiement de contrôle. Avec Sips (Mercanet, Sherlock’s, Sogenactif), saisissez en même temps la nouvelle keyVersion : une nouvelle clé envoyée avec l’ancienne version donne le code 34.

Up2pay e-Transactions (Crédit Agricole) utilise une clé HMAC ; Mercanet (BNP Paribas), Sherlock’s (LCL) et Sogenactif (Société Générale), bâtis sur Worldline Sips, une clé secrète liée à un numéro de version.

PointUp2pay e-TransactionsSips
Cléclé HMAC, en hexadécimal (0-9, A-F)clé secrète, format non publié
Versionaucune : la clé seulekeyVersion, à changer avec la clé
Où la générerback-office Visioninterface de votre banque
Erreur après un changement raté« Incohérence des paramètres / Accès refusé », code 00006code 34

Quand changer de clé

Changez de clé tout de suite si vous doutez de sa confidentialité. Pour Up2pay, Verifone préconise en plus un renouvellement chaque année.

Sur la durée de vie de la clé, les deux sources de Verifone divergent :

  • Le manuel Paybox System v8.3 indique qu’une clé expire un an après son activation, sans désactivation automatique.
  • La FAQ de Verifone précise que la clé HMAC n’expire pas et conseille de la renouveler chaque année, ou en cas de doute sur sa confidentialité. Nous l’avons relue le 27/09/2026.

Les deux mènent au même rythme : une fois par an. Notez la date d’activation de chaque clé, et changez-la aussi si un tiers a pu la lire (e-mail, ticket, ancien prestataire).

Pour Sips, nos sources ne donnent pas de durée de validité ; la notice Sogenactif évoque des e-mails d’alerte avant l’expiration d’une clé. Suivez les consignes de votre banque.

Up2pay : générer la nouvelle clé dans le back-office Vision

La clé HMAC se génère dans votre back-office, Vision pour Up2pay e-Transactions. Le plugin ne la crée pas à votre place.

Nos sources ne décrivent ni les menus de Vision pour votre compte, ni un délai pendant lequel l’ancienne clé resterait acceptée. Partez du principe qu’elle cesse de fonctionner aussitôt :

  1. Choisissez un moment calme, avec peu de commandes.
  2. Ouvrez les réglages du plugin dans un onglet, Vision dans un autre.
  3. Générez la nouvelle clé pour la plateforme voulue : recette (test) ou production.
  4. Rangez-la dans un gestionnaire de mots de passe, avec sa date d’activation.
  5. Collez-la aussitôt dans le champ « Clé HMAC » du même mode, puis enregistrez.
  6. Faites un paiement de contrôle.

Changer la clé HMAC ne touche pas à la vérification des notifications (IPN) : le plugin Relqor pour Up2pay les vérifie avec les clés publiques de Verifone.

Saisir la clé dans le plugin

Une clé vaut pour la plateforme où elle a été générée, recette (test) ou production : renouveler l’une ne change pas l’autre. Chez Up2pay, une clé de recette envoyée en production est refusée, et inversement. Les plugins Relqor gardent donc un jeu d’identifiants par mode. Un champ de clé laissé vide conserve l’ancienne clé : il ne l’efface pas.

  1. Ouvrez WooCommerce › Réglages › Paiements, puis les réglages du plugin.
  2. Repérez les identifiants du mode concerné : test ou production.
  3. Collez la clé complète dans « Clé HMAC » (Up2pay) ou « Clé secrète » (Sips). Pour Sips, remplacez aussi la keyVersion du même mode.
  4. Enregistrez. Le champ affiche •••• suivi des 4 derniers caractères : ce doivent être ceux de la nouvelle clé.

À l’enregistrement :

  • le champ est masqué, comme un mot de passe. La clé n’est jamais réaffichée en clair ni écrite dans les journaux ;
  • Up2pay : espaces et retours à la ligne retirés, caractères hexadécimaux seulement, en longueur paire ; avertissement sans blocage si la clé ne fait pas 128 caractères ;
  • Sips : clé refusée si elle contient un espace ou un caractère de contrôle, ou dépasse 256 caractères ;
  • clé mal formée : refusée avec un message d’erreur, non enregistrée ; les 4 derniers caractères affichés ne changent pas.

Si la clé enregistrée du mode actif manque ou n’est pas valable, le moyen de paiement n’est pas proposé au client : voir moyen de paiement absent.

Une mise à jour du plugin n’efface pas la clé : voir clé HMAC perdue après une mise à jour.

Vérifier après le changement

Faites un paiement dans le mode modifié, puis lisez la note de commande et le journal. Tant que ce paiement n’a pas abouti, le changement n’est pas vérifié.

  1. Payez : en test avec une carte de test, en production avec un paiement réel d’un faible montant, sans changer de mode.
  2. Up2pay : la page de saisie de la carte s’affiche, sans message d’incohérence. Après le paiement, la commande passe payée, avec une note « Paiement accepté » et le numéro d’autorisation.
  3. Sips : la réponse automatique met à jour la commande, et la note indique le code réponse (00 : autorisation acceptée). Selon le captureMode de votre boutique, la commande passe payée ou « En attente ».
  4. Journal : WooCommerce › État › Journaux, source relqor ou relqor-sips. Aucune erreur ne doit apparaître.
  5. Commandes du moment : contrôlez celles restées en « Attente paiement » pendant le changement.

Sips : nouvelle clé, nouvelle keyVersion

Chaque clé secrète Sips a une version, la keyVersion (1 à 10 chiffres), envoyée avec chaque demande de paiement. La documentation Sips Paypage POST l’impose : une nouvelle clé exige la nouvelle version, sinon Sips répond par le code 34. Saisissez la clé et sa version ensemble, puis enregistrez une seule fois.

Le plugin n’accepte une réponse automatique que si son sceau est valide avec la clé enregistrée et si sa keyVersion est celle du mode actif. Sinon, le statut de la commande ne change pas et le journal enregistre une erreur. Or la réponse d’un paiement commencé juste avant le changement peut arriver après, parfois en retard. Si une commande de ce moment reste en « Attente paiement », contrôlez le paiement chez votre banque, puis traitez-la à la main.

Pour Mercanet et Sherlock’s, ce guide ne décrit pas la procédure de la banque : suivez sa documentation.

Sogenactif (contrat 1.0) : deux clés actives pendant la transition

D’après la notice de renouvellement des clés secrètes destinée aux contrats Sogenactif 1.0 (relue le 27/09/2026), notamment en « migration simplifiée » vers Sogenactif 2.0, deux clés peuvent rester actives en même temps : vous installez la nouvelle, puis l’ancienne est désactivée à la date que vous choisissez. Pour un autre contrat, vérifiez la procédure auprès de Société Générale.

  1. Dans l’onglet « Téléchargement » du portail Sogenactif, ouvrez l’onglet « Gestion des Clés ».
  2. Générez une nouvelle clé depuis la catégorie « Clés secrètes ». Deux clés actives au maximum.
  3. Acceptez, changez ou refusez la désactivation programmée de l’ancienne clé. Elle a lieu à 00h01 le jour choisi ; vous pouvez la modifier ou l’annuler jusque-là.
  4. Récupérez la nouvelle clé et notez sa version.
  5. Saisissez la clé et sa version dans le plugin, puis faites un paiement de contrôle.

Choisissez une date qui vous laisse le temps de vérifier : la notice demande d’utiliser la nouvelle clé avant de désactiver l’ancienne.

Symptômes d’un changement mal fait

SymptômeCause probablePage utile
Up2pay : « Incohérence des paramètres / Accès refusé » avant la saisie de la carteclé fausse, ou clé de l’autre modeIncohérence des paramètres
Up2pay : code 00006accès refusé ou site, rang, identifiant incorrect ; la clé HMAC peut aussi être en causeCode 00006
Sips : code 34nouvelle clé envoyée avec l’ancienne keyVersionSips : code 34
Sips : commande restée en attenteréponse automatique ignorée après le changementCommande Sips en attente

Sur Up2pay, le message porte aussi la mention « Error while proceeding authentication with HMAC key ». Sur Paybox System, la FAQ Verifone cite le message « Problème d’identification commerce », affiché entre autres pour une empreinte HMAC invalide.

Dans tous les cas : vérifiez le mode actif, ressaisissez la clé complète de ce mode, contrôlez la keyVersion pour Sips, puis refaites un paiement. Pour le calcul de la signature, voir Erreur de signature HMAC Paybox.

Questions fréquentes

Puis-je envoyer ma clé au support ?

Non. Ne la collez jamais dans un e-mail, un ticket ou un forum. Indiquez seulement si le champ est rempli, et sa longueur.

Voir aussi