Guide
Up2pay e-Transactions, Paybox et Verifone : qui fait quoi ?
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).
| Nom | Ce qu’il désigne |
|---|---|
| Up2pay e-Transactions | La marque du Crédit Agricole pour la plateforme Paybox |
| Paybox | La plateforme de paiement exploitée par Verifone |
| Paybox System | Le 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) |
| Verifone | L’exploitant de la plateforme, qui signe les notifications |
| Vision | Le back-office commerçant de Verifone (clé HMAC, adresse de notification) |
e-transactions.fr | Le 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 :
- 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)… - La signature. Le formulaire porte une empreinte HMAC (
PBX_HMAC), calculée avec votre clé et l’algorithme annoncé dansPBX_HASH. - 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.
- Le retour du client. Le client revient par
PBX_EFFECTUE,PBX_REFUSE,PBX_ANNULEouPBX_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.
| Point | Manuel qui prévaut | Raison |
|---|---|---|
| Noms des serveurs | Up2pay (Crédit Agricole) | Adresses propres à Up2pay, sur e-transactions.fr |
| Devise | Up2pay | Seul l’euro est autorisé |
| Clé publique de la notification | Up2pay | Clés fournies avec le kit PHP Up2pay (identiques à celles de Verifone) |
| Variables, signature HMAC, notification, retour client | Paybox 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=2048et recommandePBX_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.
| Plateforme | Adresse de la page de paiement |
|---|---|
| Recette (test) | https:// |
| Production, serveur principal | https:// |
| Production, serveur secondaire | https:// |
- 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_statusde la pageload.htmldoit valoirOK. 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.193et62.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.frpréremplies et modifiables ; test deload.htmlavant 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 dansPBX_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.