Guide

Up2pay e-Transactions, Paybox et Verifone : qui fait quoi ?

Mis à jour le

Up2pay e-Transactions, Paybox et Verifone ne sont pas trois solutions de paiement différentes. Ce sont trois noms pour une même chaîne : une marque du Crédit Agricole, une plateforme de paiement, et l’entreprise qui exploite cette plateforme.

Réponse courte

Up2pay e-Transactions est la marque du Crédit Agricole pour la plateforme de paiement Paybox, exploitée par Verifone. Avec un contrat Up2pay, votre boutique utilise le protocole Paybox : mêmes variables PBX_, même signature HMAC, même notification serveur à serveur (IPN).

Deux manuels décrivent ce protocole, l’un de Verifone, l’autre du Crédit Agricole. Ils divergent sur quelques points (voir plus bas).

NomCe qu’il désigne
Up2pay e-TransactionsLa marque du Crédit Agricole pour la plateforme Paybox
PayboxLa plateforme de paiement exploitée par Verifone
Paybox SystemLe produit de Verifone qui fournit la page de paiement hébergée, décrit dans le manuel « Paybox System » (v8.3 du 16/09/2025)
VerifoneL’exploitant de la plateforme, qui signe les notifications
VisionLe back-office commerçant de Verifone (clé HMAC, adresse de notification)
e-transactions.frLe domaine des serveurs Up2pay, en recette et en production

Up2pay e-Transactions : la marque du Crédit Agricole

Le nom change, pas le protocole. Le Crédit Agricole publie sous cette marque :

  • le manuel d’intégration Up2pay e-Transactions, en ligne par chapitres sur ca-moncommerce.com (version du 01/06/2024) ;
  • un kit PHP (kit_php_2.0.1.zip), qui contient les clés publiques de la plateforme ;
  • un document de tests d’intégration (01/03/2021), avec des comptes de test mutualisés (SITE 1999887) et une clé HMAC de démonstration.

Votre contrat vous donne un SITE (7 chiffres), un RANG (2 ou 3 chiffres) et un IDENTIFIANT (1 à 9 chiffres). La clé HMAC, vous la générez vous-même dans Vision.

Paybox System : le produit et le protocole de Verifone

Paybox System redirige le client vers une page de paiement hébergée. Son manuel d’intégration, version 8.3, date du 16/09/2025.

Le protocole tient en quatre étapes :

  1. L’appel. Le navigateur du client envoie à la page de paiement un formulaire préparé par la boutique, avec des variables PBX_ : PBX_SITE, PBX_TOTAL (montant en centimes), PBX_CMD (référence unique à chaque appel)…
  2. La signature. Le formulaire porte une empreinte HMAC (PBX_HMAC), calculée avec votre clé et l’algorithme annoncé dans PBX_HASH.
  3. La notification (IPN). Après chaque tentative, acceptée ou refusée, la plateforme appelle votre site de serveur à serveur. Verifone signe cet appel avec sa clé RSA privée ; votre site le vérifie avec la clé publique.
  4. Le retour du client. Le client revient par PBX_EFFECTUE, PBX_REFUSE, PBX_ANNULE ou PBX_ATTENTE. Selon le manuel Paybox System, ce retour n’est ni sécurisé ni garanti : le client peut ne jamais revenir sur la boutique.

Deux manuels pour un protocole : lequel prévaut sur quel point

Règle suivie par Relqor : le manuel Up2pay pour ce qui est propre à Up2pay, le manuel Verifone, plus récent, pour le protocole.

PointManuel qui prévautRaison
Noms des serveursUp2pay (Crédit Agricole)Adresses propres à Up2pay, sur e-transactions.fr
DeviseUp2paySeul l’euro est autorisé
Clé publique de la notificationUp2payClés fournies avec le kit PHP Up2pay (identiques à celles de Verifone)
Variables, signature HMAC, notification, retour clientPaybox System v8.3 (Verifone)Version la plus récente : 16/09/2025, contre 01/06/2024

Pour la devise, le manuel Verifone décrit PBX_DEVISE comme un code ISO 4217 à 3 chiffres ; le manuel Up2pay tranche : « La seule valeur autorisée est l’euro (€) : 978 ». Les clés publiques du kit PHP Up2pay sont celles de Verifone (même module RSA, vérifié le 24/09/2026). Les deux manuels préviennent que Verifone peut changer de paire de clés : une intégration doit savoir en gérer plusieurs.

Trois divergences, avec le choix retenu :

  • E-mail du client (PBX_PORTEUR). Verifone annonce 6 à 120 caractères, un chapitre du manuel Up2pay 6 à 150. En recette, le 24/09/2026, des adresses de 120 et de 150 caractères ont été refusées (« is more than 80 characters long ») : la limite retenue est 80.
  • Adresse IP de la notification. Pour Verifone, il n’est plus nécessaire de la vérifier, car la méthode n’est plus assez sûre. Le manuel Up2pay, lui, demande de la vérifier. Relqor suit ici Verifone : il exige la signature et note l’adresse IP dans le journal, sans bloquer.
  • Signature en SHA-256. Verifone décrit PBX_SIGN_KEYSIZE=2048 et recommande PBX_IPNALGOSIGN=SHA_256 ; le manuel Up2pay ne documente que SHA-1 avec une clé RSA de 1024 bits. En recette, le 26/09/2026, ces paramètres ont donné une notification signée en SHA-256. Relqor ne les envoie pas et garde le réglage par défaut des deux manuels : SHA-1, clé de 1024 bits.

Les serveurs e-transactions.fr

Avec un contrat Up2pay, la page de paiement est servie par le domaine e-transactions.fr.

PlateformeAdresse de la page de paiement
Recette (test)https://recette-tpeweb.e-transactions.fr/php/
Production, serveur principalhttps://tpeweb.e-transactions.fr/php/
Production, serveur secondairehttps://tpeweb1.e-transactions.fr/php/
  • Le chemin /php/ ouvre la page de choix du moyen de paiement.
  • Avant de rediriger le client, le manuel Verifone demande de vérifier la disponibilité du serveur : l’élément server_status de la page load.html doit valoir OK. Le manuel Up2pay recommande de prévoir la bascule vers le secondaire.
  • Adresses IP sortantes de la plateforme, en recette et en production, selon le manuel Up2pay : 195.25.67.22, 62.161.13.193 et 62.161.15.193.

Vision, le back-office

Vision, le back-office commerçant de Verifone, sert pour la clé HMAC et pour l’adresse de notification.

  • La clé HMAC se génère dans Vision. Il en faut une pour la recette et une autre pour la production : l’une ne fonctionne pas à la place de l’autre. 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é. Les étapes sont dans le guide Changer de clé HMAC ou de clé secrète Sips.
  • L’adresse de notification peut être enregistrée dans Vision. Mais selon le manuel Up2pay, l’adresse envoyée dans l’appel (PBX_REPONDRE_A) est prioritaire.

Pourquoi l’e-mail s’appelle « PAYBOX: WARNING!! »

Il vient de Verifone et porte le nom de la plateforme, même si votre contrat s’appelle Up2pay e-Transactions.

Après chaque tentative de paiement, la plateforme appelle l’adresse de notification de votre site et attend une page vide, sans redirection, avec un code HTTP 2xx. Selon le manuel Paybox System, toute autre réponse déclenche cet e-mail : il concerne la réponse de votre site, pas le paiement.

Causes et vérifications : voir la fiche E-mail « PAYBOX: WARNING!! » reçu. Si une commande reste en même temps en « Attente paiement », voir aussi commande en attente après un paiement Up2pay.

Ce que fait Relqor

Relqor — Gateway for Up2pay e-Transactions suit cette répartition entre les deux manuels. Terminé mais pas encore publié, il sera bientôt disponible gratuitement sur WordPress.org. Il appliquera ces règles :

  • adresses e-transactions.fr préremplies et modifiables ; test de load.html avant la redirection, avec passage au serveur secondaire si besoin ;
  • moyen de paiement proposé seulement pour une commande en euros ;
  • adresse de notification (?wc-api=relqor_ipn) envoyée à chaque paiement dans PBX_REPONDRE_A ;
  • signature de chaque notification vérifiée avec les clés publiques de Verifone embarquées ; sans signature valide : refus (code 403), commande inchangée ;
  • statut de la commande changé par la seule notification vérifiée, jamais par le retour du client.

Relqor est un plugin indépendant, non affilié à Verifone, Up2pay ou Crédit Agricole. Up2pay e-Transactions est une marque de ses propriétaires respectifs.

Questions fréquentes

Up2pay e-Transactions, c’est quoi ?

C’est la plateforme de paiement Paybox, proposée par le Crédit Agricole sous sa propre marque. Le client paie sur une page hébergée par la plateforme, puis la boutique reçoit une notification signée par Verifone.

Un module écrit pour Paybox convient-il à Up2pay ?

Le protocole est le même. Vérifiez trois points : le module appelle les serveurs e-transactions.fr, envoie l’euro (978) et vérifie la notification avec les clés publiques de Verifone.

Voir aussi