threeDSRequest

L'objet threeDSRequest permet de :

  • déterminer si un paiement est réalisé avec ou sans authentification 3D Secure,
  • transmettre des informations liées à 3D Secure.

Si aucune valeur n'est renseignée pour cet objet, un paiement sans authentification 3D Secure sera effectué par défaut.

Les objets et attributs de l'objet threeDSRequest diffèrent selon le type de paiement.

  • Paiement sans 3D Secure

Un paiement sans authentification 3D Secure est une opération de débit dans laquelle l'authentification du porteur de la carte n'est pas effectuée.

Un seul attribut doit obligatoirement être envoyé :

threeDSRequest
Attribut Format
mode

Sélection du mode d'authentification 3D Secure.

DISABLED

Paiement sans authentification 3D Secure. Paramètre utilisé par défaut si aucune valeur est renseignée.

string

Remarque : tous les autres attributs ne sont pas pris en considération pour créer un paiement sans 3D Secure.

  • Paiement avec 3D Secure

    Le paiement avec authentification 3D Secure nécessite deux appels à l'opération createPayment.

    • Un premier appel pour vérifier l'enrôlement de la carte et récupérer les informations nécessaires pour rediriger l'acheteur vers l'ACS.

      Un seul attribut doit obligatoirement être envoyé :

      threeDSRequest
      Attribut Format
      mode

      Sélection du mode d'authentification 3D Secure.

      ENABLED_CREATE

      Permet de vérifier l'enrôlement de la carte à 3D Secure avant d'effectuer le paiement.

      string

      Remarque : tous les autres attributs ne sont pas pris en considération pour créer un paiement avec 3D Secure.

    • Un deuxième appel pour analyser le retour du 3D Secure et finaliser la transaction.

      Trois attributs doivent obligatoirement être envoyés :

      threeDSRequest
      Attribut Format
      mode

      Sélection du mode d'authentification 3D Secure.

      ENABLED_FINALIZE

      Permet de finaliser un paiement 3D Secure.

      string
      requestId

      Avec le mode ENABLED_FINALIZE, ce champ doit contenir la valeur retournée dans l'attribut threeDSRequestId de l'objet threeDsResponse dans l' opération createPayment avec le mode ENABLED_CREATE.

      string
      pares

      Message PaRes (Payer Authentication Response) renvoyé par l'ACS.

      string

      Remarque : tous les autres attributs ne sont pas pris en considération pour créer un paiement avec 3D Secure.

  • Paiement avec authentification 3D Secure réalisé par le MPI du marchand

Plusieurs attributs doivent obligatoirement être envoyés pour ce type de paiement.

Attention : une valeur spécifique pour un attribut peut impliquer la valorisation d'un autre attribut !

Tableau 1. Objet threeDSRequest
threeDSRequest
Attribut Requis Format
mode

Sélection du mode d'authentification 3D Secure.

MERCHANT_3DS

Permet de faire un paiement 3DS avec le MPI du marchand.

string
brand

Réseau de la carte.

string
enrolled

Statut enrôlement du porteur. Les valeurs possibles sont :

  • Y pour un statut enrôlé.
  • N pour un statut non enrôlé.
  • U pour un statut inconnu.
string
status

Statut de l'authentification du porteur. Les valeurs possibles sont :

  • Y pour un statut authentifié 3 DS.
  • N pour une erreur d'authentification.
  • U pour une authentification impossible.
  • A pour un essai d'authentification.

Si enrolled est valorisé à Y

string
eci

Indicateur de commerce Electronique.

La valeur eci est fonction du statut de l’authentification 3DS et du type de carte. Les valeurs possibles sont :
  status = Y status = A status = U status = N
VISA - AMEX 05 06 07 -
MasterCard 02 01 - -

Si status est valorisé à Y ou A

string
xid

Numéro de transaction 3DS.

Si status est valorisé à Y

string
cavv

Certificat de l’ACS.

Si status est valorisé à Y ou A

string
algorithm

Algorithme de vérification de l’authentification du porteur (CAVV). Les valeurs possibles sont :

  • 0 pour HMAC.
  • 1 pour CVV.
  • 2 pour CVV_ATN.
  • 3 pour Mastercard SPA.

Si status est valorisé à Y ou A

string