Guide

3-D Secure v2 et DSP2 avec Up2pay et Sips sur WooCommerce

Mis à jour le

Réponse courte

Avec Up2pay e-Transactions comme avec Sips (Mercanet, Sherlock’s, Sogenactif), l’authentification 3-D Secure v2 se fait sur la page de paiement hébergée, pas dans WooCommerce. Votre boutique doit transmettre les bonnes données, ne forcer aucun réglage 3-D Secure et lire le résultat renvoyé.

Chez Up2pay, le panier (PBX_SHOPPINGCART) et l’adresse de facturation (PBX_BILLING) sont obligatoires en 2026. Chez Sips, avec la Paypage, aucun champ 3-D Secure n’est à renseigner. Dans les deux cas, ne demandez pas vous-même un parcours sans défi (frictionless).

Où se fait l’authentification (sur la page de la banque)

Up2pay et Sips fonctionnent par redirection : WooCommerce crée la commande, puis le client saisit sa carte sur la page de paiement hébergée. L’authentification a lieu sur cette page, après la saisie de la carte. Le numéro de carte complet ne passe jamais par votre site.

L’authentification peut aboutir sans défi ou avec défi (challenge). Chez Sips, le champ holderAuthentType de la réponse indique en général lequel des deux.

Up2pay : le panier et l’adresse de facturation sont transmis

Selon le manuel Paybox System v8.3 et le manuel DSP2 de Verifone, la boutique doit envoyer elle-même ces deux paramètres du 3-D Secure v2.

Le panier (PBX_SHOPPINGCART) est un petit XML. Sa seule donnée obligatoire est totalQuantity, la quantité totale d’articles, de 1 à 99.

L’adresse de facturation (PBX_BILLING) est un XML en UTF-8 : les caractères accentués sont admis s’ils sont encodés en UTF-8. Quand les manuels donnent des longueurs différentes, retenez la plus stricte :

BaliseDonnéeLongueur la plus stricte
FirstNameprénom22 caractères
LastNamenom22 caractères
Address1adresse50 caractères
ZipCodecode postal10 caractères
Cityville50 caractères
CountryCodepays, code ISO 3166-1 numérique3 chiffres (250 pour la France)

L’e-mail du client (PBX_PORTEUR) fait aussi partie des variables obligatoires. La plateforme de recette a refusé des adresses de plus de 80 caractères et les accents avant le @. Voir adresse e-mail refusée au paiement.

Pourquoi une facturation complète est exigée

Sans ces six champs (prénom, nom, adresse, code postal, ville et pays), la demande 3-D Secure v2 est incomplète. Ils manquent par exemple quand le checkout ne demande pas d’adresse, sur une boutique de produits virtuels. Mieux vaut bloquer le paiement avant la redirection que d’inventer une valeur. Le 25/09/2026, la recette a affiché la page de saisie même avec des champs vides : cela ne prouve pas que l’authentification aboutira.

En cas de blocage, voir la fiche « Adresse de facturation incomplète ».

Up2pay : ne pas forcer de paramètre 3-D Secure

N’envoyez ni PBX_SOUHAITAUTHENT ni PBX_3DS. La valeur par défaut de la plateforme s’applique alors.

  • PBX_SOUHAITAUTHENT : sans ce paramètre, la valeur par défaut est 01, selon le manuel DSP2 de Verifone.
  • PBX_3DS : le manuel Paybox System v8.3 le décrit comme obsolète et contraire à la DSP2. Si un ancien code l’envoie encore, retirez-le.

Sips : aucun champ 3-D à renseigner

Avec la Paypage, le guide 3-D Secure de Sips indique qu’il n’y a « aucun champ spécifique 3-D à renseigner ». 3-D Secure est activé par défaut sur toute nouvelle boutique.

Le champ fraudData.challengeMode3DS peut rester absent : sa valeur par défaut est NO_PREFERENCE.

Aucune adresse postale n’est obligatoire dans la requête, et l’e-mail du client (customerContact.email) est facultatif. Le guide 3-D Secure de Sips recommande des champs facultatifs pour favoriser le parcours sans défi (par exemple holderContact.email et l’adresse de facturation). Le plugin Relqor pour Sips ne les enverra pas.

Ne pas demander vous-même un parcours sans défi

Chez Sips, selon son guide 3-D Secure, un « Frictionless commerçant » (challengeMode3DS = NO_CHALLENGE) donne guaranteeIndicator = N, même quand le client est authentifié passivement : pas de transfert de responsabilité. Un paiement authentifié en simulation le 24/09/2026 a reçu guaranteeIndicator = Y. Chez Up2pay, laissez PBX_SOUHAITAUTHENT à sa valeur par défaut (voir plus haut) ; le transfert de responsabilité se lit dans la lettre G du retour.

Lire le résultat 3-D Secure dans la note de commande

Le module de paiement peut recopier ces données dans la note de commande :

PlateformeDonnéeValeurs
Up2paylettre F : statut d’authentificationY, A, U ou N
Up2paylettre G : transfert de responsabilité 3-D SecureO, N, C ou F
Up2paylettre v : version 3-D Securepar exemple 3DSv2.1.0
SipsholderAuthentStatuspar exemple SUCCESS, FAILURE, NOT_ENROLLED
SipsholderAuthentTypepar exemple CHALLENGE, FRICTIONLESS ou NONE
SipsguaranteeIndicatorY, N, U, E ou vide

Chez Up2pay, ces lettres se demandent dans PBX_RETOUR, avant la lettre K de signature. K doit rester en dernier, sinon les valeurs qui la suivent ne sont pas signées.

Échec, refus et statut de la commande

  • Up2pay : la documentation consultée ne précise pas le code renvoyé après un échec d’authentification, et la recette n’a montré que des succès sans défi. Les codes DSP2 (001A1 : authentification 3-D Secure requise, refus « soft decline » ; 001A4 : exemption TRA mal utilisée ; 001R1 et 001R3 : révocations de paiements récurrents) sont traités comme des refus : Relqor passe la commande en « Échouée ». Voir les codes retour Up2pay.
  • Sips : un échec d’authentification arrive en responseCode 05, avec holderAuthentStatus = FAILURE. C’est un refus. Relqor passe la commande en « Échouée » seulement si la réponse automatique porte ce 05 pour la dernière tentative d’une commande en « Attente paiement » (pending). Voir les codes réponse Sips.

Tester en recette ou en simulation

Testez avec les cartes publiées pour 3-D Secure v2 (liste dans le guide cartes de test Up2pay e-Transactions et Sips), puis lisez la note de commande. Un succès en test ne prouve pas que les cas d’échec sont simulés.

Up2pay, en recette

  1. Configurez le serveur de recette et un compte de test. Voir configurer Up2pay e-Transactions en mode test.
  2. Payez avec une carte du manuel DSP2 de Verifone, par exemple 4000000000001000 (Visa, succès sans défi), avec une date d’expiration en janvier de l’année suivante.
  3. Ouvrez la commande et lisez la note « Paiement accepté » : lettres F, G et v.

Le 26/09/2026, trois paiements de recette avec une carte de test publique ont abouti sans défi : rq_3ds=Y, rq_v3ds=3DSv2.1.0, code 00000. Selon le document de test du Crédit Agricole de 2021, la recette « valide systématiquement » le 3-D Secure.

Sips, en simulation ou en recette

  • Sur les simulations Sips, Sherlock’s et Sogenactif, toutes les cartes sont enrôlées : vous choisissez le résultat de l’authentification sur la page de simulation.
  • Le 24/09/2026, sur la simulation Sips, la carte 4100000000000000 avec le résultat « Réussie » a donné 00, holderAuthentStatus=SUCCESS et guaranteeIndicator=Y.
  • Sur la recette Mercanet, la carte 4112948576210600 n’est pas enrôlée : aucune page 3-D Secure ne s’affiche, et la réponse porte holderAuthentStatus=NOT_ENROLLED.

Ce que fait Relqor

Les plugins Relqor pour Up2pay et pour Sips sont terminés et seront bientôt publiés sur WordPress.org. Ils suivront les règles de ce guide.

Relqor pour Up2pay e-Transactions :

  • construira PBX_SHOPPINGCART et PBX_BILLING à partir de la commande, accents compris, sans appel réseau pour le code pays ;
  • n’inventera aucune valeur : si un champ de facturation obligatoire est vide, le paiement sera refusé avant la redirection, avec le nom du champ ;
  • n’enverra ni PBX_SOUHAITAUTHENT ni PBX_3DS ;
  • recopiera les lettres F, G et v dans la note « Paiement accepté », sans aucune donnée de carte ;
  • traitera les codes DSP2 comme des refus, avec leur libellé dans la note.

Relqor pour Sips (Mercanet, Sherlock’s, Sogenactif) :

  • n’enverra ni challengeMode3DS ni mode de capture : la configuration de votre boutique chez Worldline s’appliquera ;
  • n’enverra aucune adresse ; seul l’e-mail de facturation sera transmis, s’il est valide et fait 128 caractères au plus ;
  • notera holderAuthentStatus, holderAuthentType et guaranteeIndicator dans la commande, jamais le numéro de carte masqué.

Pour votre banque, voir les pages Up2pay e-Transactions, Mercanet, Sherlock’s et Sogenactif.

Questions fréquentes

Faut-il activer 3-D Secure dans le plugin ?

Non. Chez Sips, 3-D Secure est activé par défaut sur toute nouvelle boutique, sans champ à renseigner. Chez Up2pay, le module doit transmettre le panier et la facturation, sans forcer de paramètre 3-D Secure.

Voir aussi