1. Introduction

Cette liste contient tous les paramètres concernant le 3-D Secure V2. Elle se compose de trois parties :

2. Paramètres obligatoires

Si vous utilisé notre Hosted Payment Page de Nexi Payengine, nous nous chargerons de la capture de ces paramètres pour vous. Si vous traitez vos transactions via DirectLink, il faudra les ajouter manuellement à votre demande.

Paramètres 
browserAcceptHeader

En-tête d’acceptation du navigateur.

Contenu exact de l’en-tête d’acceptation HTTP tel qu’il a été envoyé au marchand par le navigateur du titulaire de carte.

browserColorDepth

Profondeur de couleur de l’écran du navigateur.

Valeur représentant la profondeur de bits de la palette de couleurs pour l’affichage des images, en bits par pixel. Obtenue auprès du navigateur du titulaire de carte à l’aide des propriétés de profondeur des couleurs.

browserJavaEnabled

Navigateur compatible avec Java.

Opérateur booléen qui représente la capacité du navigateur du titulaire de carte à exécuter Java. La valeur est fournie par les propriétés du navigateur compatible avec Java.

browserLanguage

Langue du navigateur.

Valeur représentant la langue du navigateur telle que définie dans le standard IETF BCP47. Fourni par les propriétés de langue du navigateur.

(Par example: en, fr, en-US, fr-ca) Ne fait pas la différence entre majuscules et minuscules.

browserScreenHeight

Hauteur de l’écran du navigateur.

Hauteur totale de l’écran du titulaire de carte en pixels. La valeur est fournie par les propriétés de hauteur d’écran du navigateur.

browserScreenWidth

Largeur de l’écran du navigateur.

Largeur totale de l’écran du titulaire de carte en pixels. La valeur est fournie par les propriétés de largeur d’écran du navigateur.

browserTimeZone

Fuseau horaire du navigateur.

Décalage horaire entre l’heure UTC (temps universel coordonné) et l’heure locale du navigateur du titulaire de carte, en minutes.

browserUserAgent

Agent utilisateur du navigateur.

Contenu exact de l’en-tête d’agent utilisateur HTTP.

ACCEPTURL

URL de la page web à montrer au client lorsque le paiement est autorisé (ou en attente d’autorisation).

DECLINEURL

URL vers lequel le client est redirigé si le nombre maximal de tentatives d’autorisation échouées a été atteint (10 par défaut, mais peut être modifié dans la page d’information technique, onglet "Paramètres de transaction Globaux ", section "Tentatives de paiement multiples").

EXCEPTIONURL

URL de la page web à montrer au client lorsque le résultat du paiement est incertain.

LANGUAGE

Langues actuellement proposées à l'acheteur (titulaire de la carte/titulaire du compte) pour la page de paiement.

Langue par défaut utilisée si aucune valeur de langue n'est envoyée ou si la langue envoyée n'est pas valide : en_US (anglais)

FLAG3D

Valeur Fixe: ‘Y’;

Indique à notre système d’exécuter une identification 3-D Secure si nécessaire.

CN

cardholderName

Nom du titulaire de carte (client).

Mpi.carteBancaire.Usecase

Obligatoire pour la carte bancaire

Pour tous les modes d'intégration

Type de paiement pour lequel une authentification est requise

REMOTE_ADDR

Obligatoire pour la carte bancaire

Pour les demandes DirectLink

browserIP.

Adresse IP du client (uniquement pour le module de détection de la fraude). Pour des interfaces où notre système gère le dialogue avec le client (par ex. commerce électronique) la REMOTE_ADDR est directement saisie par nous. Pour les autres interfaces, le marchand doit envoyer l’adresse IP du client avec les informations

 

If you process transactions for Visa, make sure to add the following mandatory parameters as well:

For all integration modes:

Mpi.WorkPhone.countryCode + Mpi.WorkPhone.subscriber
or
Mpi.MobilePhone.countryCode + Mpi.MobilePhone.subscriber
or
Mpi.HomePhone.countryCode + Mpi.HomePhone.subscriber
or
EMAIL

For DirectLink requests: 

REMOTE_ADDR

3. Paramètres recommandés

Paramètres
ECOM_BILLTO_POSTAL_CITY

billAddrCity.

Ville de facturation

ECOM_BILLTO_POSTAL_COUNTRYCODE

billAddrCountry.

Code du pays de facturation

ECOM_BILLTO_POSTAL_STREET_LINE1

billAddrLine1.

Adresse de facturation, première ligne

ECOM_BILLTO_POSTAL_STREET_LINE2

billAddrLine2.

Adresse de facturation, deuxième ligne

ECOM_BILLTO_POSTAL_POSTALCODE

billAddrPostCode.

Code postal de facturation

EMAIL

email.

Adresse e-mail du client.

4. Paramètres optionels

De plus, vous pouvez envoyer autant de paramètres que vous le souhaitez dans cette liste. Plus vous en envoyez plus les chances d’avoir des flux de paiement fluides sont élevés.

Paramètres
Mpi.threeDSRequestorChallengeIndicator

Utilisez ce paramètre pour demander des exemptions au 3-D Secure.

Indicateur du processus d’identification auprès du marchand.

Indique si un processus d’identification est requis pour cette transaction. Par exemple :

Pour 01-PA, un marchand peut avoir des doutes sur la transaction et exiger un processus d’identification. Pour 02-NPA, un processus d’identification peut s’avérer nécessaire lors de l’ajout d’une nouvelle carte à un portefeuille. Pour les mandats locaux/régionaux ou d’autres variables.

 

Mpi.merchantFraudRate

Taux de fraude chez les marchands

Le taux de fraude chez les marchands dans l’EEE (l’ensemble des fraudes dans l’EEE divisé par l’ensemble des volumes de cartes dans l’EEE) calculé conformément aux normes techniques réglementaires (Regulatory Technical Standards, ou RTS) PSD2.

Assurez-vous de calculer le taux conformément à l’article 19 des RTS PSD2 étant donné que ni MasterCard ni nous ne validerons le résultat.

Mpi.secureCorporatePayment

Paiement professionnel sécurisé

Indique que des processus et procédures de paiement dédiés ont été utilisés et que l’exemption potentielle pour paiement professionnel sécurisé s’applique.
Envoyez ce champ uniquement avec Y si le champ d’exemption de l’acquéreur est vierge, puisque
l’exemption de l’acquéreur et le paiement sécurisé sont mutuellement exclusifs.
Cependant, le serveur de répertoire (SR) ne validera pas les conditions dans l’extension. Le SR transmettra les données telles qu’elles ont été envoyées.
Facultativement, vous pouvez indiquer si elles s’appliquent aux processus et protocoles dédiés conformément à l’article 17 des RTS PSD2, ce qui serait susceptible de permettre à l’émetteur à réclamer l’exemption pour paiement professionnel sécurisé.

Mpi.cardholderAccountChangeIndicator

Indicateur d’âge du compte du titulaire de carte*.

Durée pendant laquelle le titulaire de carte a disposé du compte auprès du marchand.

Mpi.cardholderAccountDate

Date de création du compte du titulaire de carte*.

Date à laquelle le titulaire de carte a ouvert le compte auprès du marchand.

Mpi.cardholderAccountPasswordChange

Changement de mot de passe du compte du titulaire de carte*.

Date à laquelle le mot de passe du compte du titulaire de carte auprès du marchand a été modifié ou à laquelle le compte a été réinitialisé.

Mpi.cardholderAccountPasswordChangeIndicator

Indicateur de changement de mot de passe du compte du titulaire de carte*.

Indique la durée depuis le dernier changement de mot de passe du compte du titulaire de carte auprès du marchand ou la durée depuis la dernière réinitialisation du compte.

Mpi.numberOfPurchaseWithAccountInTheLastSixMonths

Nombre d’achat du compte du titulaire de carte*.

Nombre d’achats effectués avec ce compte du titulaire de carte pendant les six derniers mois.

Mpi.paymentAccountAge

Âge du compte de paiement*.

Date à laquelle le compte de paiement a été enregistré dans le compte du titulaire de carte auprès du marchand.

Mpi.paymentAccountAgeIndicator

Indicateur d’âge du compte de paiement*.

Indique la durée depuis l’enregistrement du compte de paiement dans le compte du titulaire de carte auprès du marchand.

Mpi.provisionAttemptsInTheLast24Hours

Nombre de tentatives d’approvisionnement par jour.

Nombre de tentatives d’ajout de carte pendant les 24 dernières heures.

Mpi.shippingAddressUsage

Utilisation de l’adresse de livraison.

Date à laquelle l’adresse de livraison utilisée pour cette transaction a été utilisée pour la première fois auprès du marchand.

Mpi.shippingAddressWasFirstUsed

Indicateur d’utilisation de l’adresse de livraison.

Indique la date à laquelle l’adresse de livraison utilisée pour cette transaction a été utilisée pour la première fois auprès du marchand.

Mpi.shippingNameAndCardholderNameAreIdentical

Indicateur de nom de livraison.

Indique si le nom du titulaire de carte détenant le compte est identique au nom de livraison utilisé pour cette transaction.

Mpi.suspiciousAccountActivityDetected

Activité suspecte liée au compte.

Indique si le marchant a constaté des activités suspectes (y compris des fraudes antérieures) liées au compte du titulaire de carte.

Mpi.transactionActivityInTheLast24Hours

Nombre de transactions par jour.

Nombre de transactions (réussies et abandonnées) pour ce compte du titulaire de carte auprès du marchand sur l’ensemble des comptes de paiement lors des 24 dernières heures.

Mpi.transactionActivityLastYear

Nombre de transactions par an.

Nombre de transactions (réussies et abandonnées) pour ce compte du titulaire de carte auprès du marchand sur l’ensemble des comptes paiement lors de l’année précédente.

Mpi.challengeWindowSize

Taille de la fenêtre de vérification.

Dimensions de la fenêtre de vérification qui a été affichée sur l’appareil du titulaire de carte. L’ACS (service de contrôle d’accès) répondra avec un contenu formaté pour apparaître correctement dans cette fenêtre afin de fournir la meilleure expérience possible à l’utilisateur. Les tailles préconfigurées font largeur x hauteur pixels de la fenêtre affichée dans la fenêtre du navigateur du titulaire de carte.

Mpi.HomePhone.countryCode

Indicatif de pays du numéro de téléphone du domicile.

Indicatif de pays du numéro d’un téléphone de domicile

Mpi.HomePhone.subscriber

Numéro de téléphone du domicile.

Numéro de téléphone du domicile (sans l’indicatif de pays)

Mpi.deliveryEmailAddress

Adresse e-mail de livraison.

Pour les livraisons électroniques, l’adresse e-mail à laquelle la marchandise a été livrée.

Mpi.deliveryTimeframe

Délai de livraison.

Indique le délai de livraison des marchandises.

Mpi.giftCardAmount

Montant de la carte cadeau.

Pour les achats prépayés ou réglés avec des cartes cadeau, le montant total de l’achat prépayé ou réglé avec des cartes cadeau sous forme de chiffre rond (par exemple, 123,45 USD est arrondi à 123).

Mpi.giftCardCount

Nombre de cartes cadeau.

Pour les achats prépayés ou réglés avec des cartes cadeau, le nombre total de codes individuels de prépaiement/cartes cadeau achetés.

Mpi.giftCardCurrency

Devise de la carte cadeau.

Pour les achats prépayés ou réglés avec des cartes cadeau, le code de la devise de la carte tel que défini par la norme ISO 4217.

Mpi.preOrderDate

Date de précommande.

Pour un achat précommandé, la date estimée à laquelle la marchandise sera disponible.

Mpi.cardholderAccountAgeIndicator

Indicateur d’âge du compte du titulaire de carte*.

Durée pendant laquelle le titulaire de carte a disposé du compte auprès du marchand.

Mpi.cardholderAccountChange

Changement dans le compte du titulaire de carte*.

Date du dernier changement effectué dans le compte du titulaire de carte auprès du marchand, y compris les adresses de facturation et de livraison, un nouveau compte de paiement ou l’ajout d’un ou plusieurs nouveaux utilisateurs.

Mpi.preOrderPurchaseIndicator

Indicateur de précommande.

Indique si le titulaire de carte passe une commande pour de la marchandise dont la date de disponibilité ou de sortie n’est pas encore passée.

Mpi.reorderItemsIndicator

Indicateur de recommande d’éléments.

Indique si le titulaire de carte commande à nouveau des marchandises achetées précédemment.

Mpi.shippingIndicator

Indicateur d’expédition.

Indique la méthode d’expédition choisie pour la transaction. Les marchands doivent choisir le code d’indicateur d’expédition qui correspond au mieux à la transaction en question du titulaire de carte et non à leur activité en général. Si un ou plusieurs éléments sont inclus dans la vente, utilisez le code d’indicateur d’expédition pour les biens physiques, ou, s’il s’agit uniquement de biens numériques, utilisez le code d’indicateur d’expédition qui correspond à l’élément le plus cher.

Mpi.MobilePhone.countryCode

Indicatif de pays du numéro de téléphone portable.

Indicatif de pays d’un numéro de téléphone portable

Mpi.MobilePhone.subscriber

Numéro de téléphone portable.

Numéro de téléphone portable (sans l’indicatif de pays)

Mpi.threeDSRequestorAuthenticationData

Données d’authentification du marchand.

Données qui fournissent des preuves et participent à une procédure d’authentification spécifique. Dans la version actuelle du logiciel, ces données ne sont pas définies en détail. Cependant, nous avons l’intention que ce champ comporte, pour chaque méthode d’authentification auprès des marchands, des données que l’ACS pourra utiliser pour vérifier la procédure d’authentification. Par exemple, pour la méthode:

02—le champ peut comporter des informations génériques d’authentification du marchand

03—l’élément de données peuvent apporter des informations concernant le fournisseur de l’identifiant fédéré et des informations y étant liées

04—l’élément de données peut indiquer les données d’attestation FIDO (y compris la signature) Ces informations devraient être incluses dans les versions futures du logiciel

Mpi.threeDSRequestorAuthenticationMethod

Méthode d’authentification auprès du marchand.

Mécanisme utilisé par le titulaire de carte pour s’authentifier auprès du marchand.

Mpi.threeDSRequestorAuthenticationTimestamp

Horodatage d’authentification du marchand.

Date et heure en UTC de l’authentification du titulaire de carte

Mpi.threeDSRequestorPriorAuthenticationData

Données d’authentification de la transaction précédente auprès du marchand.

Données qui fournissent des preuves et participent à une procédure d’authentification spécifique. Dans la version actuelle du logiciel, ces données ne sont pas définies en détail. Cependant, nous avons l’intention que ces champs comportent, pour chaque méthode d’authentification auprès des marchands, des données que l’ACS pourra utiliser pour vérifier la procédure d’authentification.

Mpi.threeDSRequestorPriorAuthenticationMethod

Méthode d’authentification de la transaction précédente auprès du marchand.

Mécanisme antérieurement utilisé par le titulaire de carte pour s’authentifier auprès du marchand.

Mpi.threeDSRequestorPriorAuthenticationTimestamp

Horodatage d’authentification de transaction précédente auprès du marchand.

Date et heure en UTC de l’authentification précédente du titulaire de carte.

Mpi.threeDSRequestorPriorReference

Référence de transaction précédente auprès du marchand.

Cet élément de données fournit des informations supplémentaires à l’ACS pour définir la meilleure approche pour traiter une demande.

Mpi.transactionType

Type de transaction.

Identifie le type de transaction étant authentifiée.

Mpi.WorkPhone.countryCode

Indicatif de pays du numéro de téléphone professionnel.

Indicatif de pays d’un numéro de téléphone professionnel

Mpi.WorkPhone.subscriber

Numéro de téléphone professionnel.

Numéro utilisé à des fins professionnelles (sans indicatif de pays)

TP

Pour modifier la mise en page de la page "order_A3DS", vous pouvez envoyer un nom / une URL de modèle avec ce paramètre. (aller à e-Commerce: Dynamic template).

WIN3DS Manière de montrer la page d’identification au client. Valeurs possibles :
  • MAINW : montre la page d’identification dans la fenêtre principale (valeur par défaut).
  • POPUP: montre la page d’identification dans une nouvelle fenêtre venant d’apparaître (pop up) et retourne vers la fenêtre principale à la fin.
  • POPIX: montre la page d’identification dans une nouvelle fenêtre venant d’apparaître (pop up) et reste dans cette même fenêtre.
ADDRMATCH

addrMatch.

Indique si nous considérons que les adresses de facturation et de livraison sont identiques. 1=oui 0=non

TRXDATE

purchaseDate.

Date de la transaction.

ECOM_SHIPTO_POSTAL_CITY

shipAddrCity.

Ville d’expédition

ECOM_SHIPTO_POSTAL_STREET_LINE1

shipAddrLine1.

Adresse de livraison, première ligne.

ECOM_SHIPTO_POSTAL_STREET_LINE2

shipAddrLine2.

Adresse de livraison, deuxième ligne.

ECOM_SHIPTO_POSTAL_POSTALCODE

shipAddrPostCode.

Code postal de livraison

ECOM_SHIPTO_POSTAL_COUNTRYCODE

shipAddrCountry.

Code du pays de livraison

Mpi.carteBancaire.AcquirerExemption

Demande d’application de l’exemption RTS Acquirer Transaction Risk Analysis

Mpi.carteBancaire.MerchantScore

La note que vous avez calculée pour cette transaction

Mpi.carteBancaire.NumberOfItems

Nombre d’articles de la commande en cours

Mpi.carteBancaire.Usecase

Type de paiement pour lequel une authentification est requise