logo Sogenactif

Release 24.2

aller directement au contenu

Rechercher par mots clés

cardValidateAuthentication

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Requêtes de validation d’authentification 3-D Secure :

Sauf mention contraire, toute référence à 3-D Secure dans le présent document inclut Visa (Verified by Visa), MasterCard (SecureCode) et American Express (SafeKey).

Cette requête est obligatoire pour vérifier l’ensemble de l’authentification 3-D Secure (avec un message PARes). Elle doit être effectuée une fois que vous avez reçu le formulaire POST de l’ACS (Access Control Server) (voir “Envoi du formulaire POST à l’ACS”).

interfaceVersion recommandée : IR_WS_2.53

  • PROD
    https://office-server.sogenactif.com/rs-services/v2/checkout/cardValidateAuthentication
    méthode
    POST
  • TEST
    https://office-server-sogenactif.test.sips-services.com/rs-services/v2/checkout/cardValidateAuthentication
    méthode
    POST
  • PROD
    https://office-server.sogenactif.com/services/v2/checkout?wsdl
    méthode
    POST
  • TEST
    https://office-server-sogenactif.test.sips-services.com/services/v2/checkout?wsdl
    méthode
    POST

Obligatoire

Optionnel

Exemple de requête

            {
  "interfaceVersion": "IR_WS_2.9",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "messageVersion": "0.1",
  "paResMessage": "eJydVVuTqjgQ....7h%2FwH0CKem",
  "redirectionData": "uqjeV+KegCSM0POI...CjVUfxqyFq7zSYus7E\u003d",
  "transactionReference": "TREFEXA2015",
  "seal": "9565b71cb583f025278de91940c69900dee72d91e8184ddb6547f00927597fd1"
}

        
                  <urn:cardValidateAuthentication>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:transactionReference>TREFEXA2015</urn:transactionReference>
            <urn:interfaceVersion>IR_WS_2.9</urn:interfaceVersion>
            <urn:redirectionData>RSs7cZyL1DqsV... 9P15xVe</urn:redirectionData>
            <urn:messageVersion>0.1</urn:messageVersion>
            <urn:paResMessage>eJydVVuTqjgQ....7h%2FwH0CKem</urn:paResMessage>
         </urn:input>
      </urn:cardValidateAuthentication>

Obligatoire

  • seal
    présence
    Obligatoire
    Interface version
    2.0

    Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).

Optionnel

  • errorFieldName
    présence
    Optionnel
    Interface version
    2.21

    Nom du champ en erreur dans la requête. Présent lorsque responseCode = 12 ou 30.

  • holderAuthentMethod
    présence
    Optionnel
    Interface version
    2.27

    Nom de la méthode appliquée pour identifier le porteur du moyen de paiement.

    Liste des valeurs
    DYNAMIC
    Méthode d’authentification dynamique
    NOT_SPECIFIED
    Non spécifié holderAuthentProgram compatible : 3DS
    NO_AUTHENT
    Valeur alternative de NO_AUTHENT_METHOD qui est utilisée dans les journaux de transactions. holderAuthentProgram compatible : NO_AUTHENT
    NO_AUTHENT_METHOD
    Aucune méthode d’authentification holderAuthentProgram compatibles : PAYLIB
    OOB
    Méthode qui n’est pas définie par 3D Secure application (Out Of Band)
    OTP_HARDWARE
    OTP sur élément sécurisé Hardware (CAP, SIM,…) holderAuthentProgram compatible : PAYLIB
    OTP_SOFTWARE
    OTP sur élément sécurisé Software (SEA,…) holderAuthentProgram compatible : PAYLIB
    OTP_TELE
    OTP Téléphone (SMS, SVI, Token…) holderAuthentProgram compatible : PAYLIB
    PASSWORD
    Mot de passe rejouable (Date de naissance, mot de passe, code postal,…) holderAuthentProgram compatibles : BCMCMOBILE
    STATIC
    Méthode d’authentification statique
  • holderAuthentProgram
    présence
    Optionnel
    Interface version
    2.27

    Programme d’authentification.

    Liste des valeurs
    1EUROCOM
    Authentification Cofidis Pay 5x10x20x
    3DS
    Authentification 3-D Secure
    3DS_V2
    Authentification 3-D Secure v2. Cette valeur est acceptée aux versions suivantes : dans les connecteurs Sogenactif Paypage à partir de la version 2.24 dans les connecteurs Sogenactif Office Serveur à partir de la version 2.24 dans le connecteur Sogenactif In-App à partir de la version 2.5
    APPLEPAY
    Authentification APPLE PAY
    BCMCMOBILE
    Authentification BCMC
    GOOGLEPAY
    Authentification Google Pay
    MASTERPASS
    Authentification MasterPass
    NOT_SPECIFIED
    Programme d’authentification non spécifié.
    NO_AUTHENT
    Valeur alternative à NO_AUTHENT_METHOD qui est utilisée dans les journaux de transactions
    NO_AUTHENT_METHOD
    Aucun programme d’authentification
    PAYLIB
    Authentification Paylib
    SAMSUNGPAY
    Authentification Samsung Pay
    THREE_DS
    Valeur alternative à 3DS qui est utilisée dans les journaux de transactions.
  • holderAuthentResponseCode
    présence
    Optionnel
    Interface version
    2.0

    Code réponse du processus d’authentification porteur.

    Liste des valeurs
    00
    Porteur authentifié
    01
    Porteur non authentifié
    02
    Le processus d’authentification porteur ne peut d’être réalisé pour cause de problème technique sur l’ACS (TX.status = U dans le message PARes)
    03
    La preuve de l’authentification du porteur est disponible
    88
    L’ACS a renvoyé un message d’erreur à la place du message CRes
    89
    La session a expiré
    95
    La signature du message PARes est invalide
    96
    Le message PARes est invalide
  • holderAuthentStatus
    présence
    Optionnel
    Interface version
    2.27

    Résultat du processus d’authentification porteur.

    Liste des valeurs
    3D_ABORT
    L’acheteur a abandonné la transaction durant le processus d’authentification. Ce statut n’est actuellement possible que dans le cas d’un paiement PAYLIB.
    3D_ATTEMPT
    Le commerçant et le porteur de la carte sont inscrits au programme d’authentification mais l’acheteur n’a pas eu à s’authentifier (le serveur de contrôle d’accès de la banque qui a émis la carte n’implémente que la génération d’une preuve de tentative d’authentification). Ce cas peut également se produire lorsque le DS répond à la place de l’ACS en cas d’indisponibilité de l’ACS.
    3D_BYPASS
    A partir de certains critères définis par le marchand, le contrôle du programme d’authentification n’a pas été réalisé.
    3D_ERROR
    Le commerçant participe au programme d’authentification mais le serveur Sogenactif a rencontré un problème technique durant le processus d’authentification (lors de la vérification de l’inscription de la carte au programme 3-D Secure ou de l’authentification du porteur).
    3D_FAILURE
    Le commerçant et le porteur de la carte sont inscrits au programme d’authentification mais l’acheteur n’a pas réussi à s’authentifier (mauvais mot de passe).
    3D_NOTENROLLED
    Le commerçant participe au programme d’authentification mais la carte du porteur n’est pas enrôlée.
    3D_SUCCESS
    Le commerçant et le porteur de la carte sont inscrits au programme d’authentification et le porteur s’est authentifié correctement.
    ATTEMPT
    Le commerçant et le porteur de la carte sont inscrits au programme d’authentification mais l’acheteur n’a pas eu à s’authentifier (le serveur de contrôle d’accès de la banque qui a émis la carte n’implémente que la génération d’une preuve de tentative d’authentification). Ce cas peut également se produire lorsque le DS répond à la place de l’ACS en cas d’indisponibilité de l’ACS.
    BYPASS
    A partir de certains critères définis par le marchand, le contrôle du programme d’authentification n’a pas été réalisé.
    CANCEL
    L’acheteur a abandonné la transaction durant le processus d’authentification. Ce statut n’est actuellement possible que dans le cas d’un paiement PAYLIB.
    ERROR
    Le commerçant participe au programme d’authentification mais le serveur Sogenactif a rencontré un problème technique durant le processus d’authentification (lors de la vérification de l’inscription de la carte au programme 3-D Secure ou de l’authentification du porteur).
    FAILURE
    Le commerçant et le porteur de la carte sont inscrits au programme d’authentification mais l’acheteur n’a pas réussi à s’authentifier (mauvais mot de passe).
    NOT_ENROLLED
    Le commerçant participe au programme d’authentification mais la carte du porteur n’est pas enrôlée.
    NOT_PARTICIPATING
    L’acheteur ne s’est pas authentifié pour une des raisons suivantes : - le type de carte n’est pas supporté par le programme d’authentification - le commerçant n’est pas inscrit au programme d’authentification.
    NOT_SPECIFIED
    Le statut de l’authentification n’est pas disponible.
    NO_AUTHENT
    Le porteur ne s’est pas authentifié.
    NO_AUTHENT_DTA
    Le porteur ne s’est pas authentifié pour motif Direct to Authorize
    SSL
    Le porteur ne s’est pas authentifié.
    SUCCESS
    Le commerçant et le porteur de la carte sont inscrits au programme d’authentification et le porteur s’est authentifié correctement.
  • responseCode
    présence
    Optionnel
    Interface version
    2.0

    Code réponse du serveur Sogenactif.

    Liste des valeurs
    00
    Opération acceptée
    03
    Contrat commerçant invalide
    12
    Transaction invalide, vérifier les paramètres transférés dans la requête
    40
    Fonction non supportée : l’opération que vous souhaitez réaliser ne fait pas partie de la liste des opérations auxquelles vous êtes autorisés
    99
    Problème temporaire du serveur de paiement.
  • threeD
    présence
    Optionnel
    Interface version
    2.27

    Contient les informations d’authentification 3-D Secure du porteur.

    Contient
    • securityIndicator
      présence
      Optionnel
      Interface version
      2.27

      Niveau de sécurité de la transaction. Cet indicateur se calcule en fonction du résultat préalable de l’authentification 3-D Secure.

      Liste des valeurs
      10
      3DS débrayé holderAuthentProgram: N/A holderAuthentStatus : BYPASS
      20
      Valeur obsolète holderAuthentProgram: N/A holderAuthentStatus : N/A
      21
      Porteur non enrôlé au programme 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : NOT_ENROLLED
      22
      Valeur obsolète holderAuthentProgram: 3DS holderAuthentStatus : NOT_ENROLLED
      23
      Authentification réussie en 3DS 2.0 en mode frictionless holderAuthentProgram: 3DS_V2 holderAuthentStatus : SUCCESS
      24
      Authentification réussie en 3DS 2.0 en mode challenge (authentification forte) holderAuthentProgram: 3DS_V2 holderAuthentStatus : SUCCESS
      25
      Authentification réussie en 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : SUCCESS
      26
      Porteur partiellement authentifié sur l’ACS 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : ATTEMPT
      27
      Porteur partiellement authentifié sur l’ACS 3DS 2.0 en mode frictionless holderAuthentProgram: 3DS_V2 holderAuthentStatus : ATTEMPT
      28
      Porteur partiellement authentifié sur l’ACS 3DS 2.0 en mode challenge (authentification forte) holderAuthentProgram: 3DS_V2 holderAuthentStatus : ATTEMPT
      29
      Plage de carte non enrôlée au programme 3DS 2.0 holderAuthentProgram: 3DS_V2 holderAuthentStatus : NOT_ENROLLED
      30
      Porteur non enrôlé au programme 3DS 2.0 holderAuthentProgram: 3DS_V2 holderAuthentStatus : NOT_ENROLLED
      31
      Echec de l’authentification du porteur en 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : FAILURE
      32
      Signature invalide dans la réponse de l’ACS en 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : FAILURE
      33
      Réponse de l’ACS invalide en 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : FAILURE
      34
      Echec de l’authentification du porteur en 3DS 2.0 en mode frictionless holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      35
      Echec de l’authentification du porteur en 3DS 2.0 en mode challenge holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      36
      Echec de l’authentification en 3DS 2.0 car aucun message Rreq reçu de l’ACS holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      37
      Echec de l’authentification en 3DS 2.0 car le message Cres est invalide holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      38
      Echec de l’authentification en 3DS 2.0 car le message Cres contient un message d’erreur holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      39
      Pas d’authentification comme demandé par le marchand holderAuthentProgram: 3DS_V2 holderAuthentStatus : NO_AUTHENT
      41
      Erreur en 3DS 1.0 : Session expirée holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      42
      Erreur en 3DS 2.0 : Session expirée holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      71
      Erreur en 3DS 2.0 : message ARes non reçu holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      72
      Erreur en 3DS 2.0 : message ARes reçu du DS est invalide holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      73
      Erreur en 3DS 2.0 : message RReq reçu de l’ACS est invalide holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      74
      Erreur en 3DS 2.0 : impossible de joindre le DS holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      75
      Erreur en 3DS 2.0 : problème technique sur la plateforme Sogenactif holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      76
      Erreur en 3DS 2.0 : problème technique sur le 3DS Server holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      81
      Erreur en 3DS 1.0 : Erreur interne MPI lors du premier appel holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      82
      Erreur en 3DS 1.0 : Erreur interne MPI lors du second appel holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      84
      Erreur en 3DS 1.0 : Réponse du DS invalide holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      85
      Erreur en 3DS 1.0 : problème technique lors du premier appel au MPI holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      86
      Erreur en 3DS 1.0 : problème technique lors du second appel au MPI holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      87
      Erreur en 3DS 1.0 : les paramètres transmis au MPI sont invalides holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      88
      Erreur en 3DS 1.0 : Problème réseau holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      90
      Valeur obsolète holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      92
      Problème lors de la vérification de l’enrôlement du porteur holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      93
      Problème lors de l’authentification du porteur sur l’ACS holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      94
      Erreur en 3DS 2.0 : problème technique lors de l’appel au DS holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      95
      Erreur en 3DS 2.0 : problème technique lors la cinématique avec l’ACS holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
    • cavv
      présence
      Optionnel
      Interface version
      2.27

      Valeur de vérification de l’authentification du porteur lors d’un paiement 3-D Secure.

    • eci
      présence
      Optionnel
      Interface version
      2.27

      Indicateur de commerce électronique lors d’un paiement 3-D Secure.

    • cavvAlgorithm
      présence
      Optionnel
      Interface version
      2.27

      Indicateur de l’algorithme utilisé pour la génération du CAVV lors d’un paiement 3-D Secure.

      Liste des valeurs
      0
      HMAC
      1
      CVV
      2
      CVV ATN
      3
      Mastercard SPA
    • txStatus
      présence
      Optionnel
      Interface version
      2.27

      Résultat de l’authentification lors d’un paiement 3-D Secure.

      Liste des valeurs
      9
      CARD_NOT_ENROLLED
      A
      ATTEMPT
      C
      CHALLENGE
      D
      DECOUPLED_AUTHENTICATION
      E
      AUTHENTICATED_WITHOUT_CRYPTO
      I
      INFO_ONLY
      N
      NOT_AUTHENTICATED
      R
      AUTHENTICATION_REJECTED
      U
      ERROR
      Y
      AUTHENTICATED_WITH_CRYPTO
    • xid
      présence
      Optionnel
      Interface version
      2.27

      Identifiant de transaction unique (généré par le serveur 3-D Secure) présenté dans tous les messages 3-D Secure lors d’un paiement 3-D Secure.

  • threeDV2
    présence
    Optionnel
    Interface version
    2.27

    Contient les informations d’authentification 3-D Secure v2 du porteur.

    Contient
    • securityIndicator
      présence
      Optionnel
      Interface version
      2.27

      Niveau de sécurité de la transaction. Cet indicateur se calcule en fonction du résultat préalable de l’authentification 3-D Secure.

      Liste des valeurs
      10
      3DS débrayé holderAuthentProgram: N/A holderAuthentStatus : BYPASS
      20
      Valeur obsolète holderAuthentProgram: N/A holderAuthentStatus : N/A
      21
      Porteur non enrôlé au programme 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : NOT_ENROLLED
      22
      Valeur obsolète holderAuthentProgram: 3DS holderAuthentStatus : NOT_ENROLLED
      23
      Authentification réussie en 3DS 2.0 en mode frictionless holderAuthentProgram: 3DS_V2 holderAuthentStatus : SUCCESS
      24
      Authentification réussie en 3DS 2.0 en mode challenge (authentification forte) holderAuthentProgram: 3DS_V2 holderAuthentStatus : SUCCESS
      25
      Authentification réussie en 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : SUCCESS
      26
      Porteur partiellement authentifié sur l’ACS 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : ATTEMPT
      27
      Porteur partiellement authentifié sur l’ACS 3DS 2.0 en mode frictionless holderAuthentProgram: 3DS_V2 holderAuthentStatus : ATTEMPT
      28
      Porteur partiellement authentifié sur l’ACS 3DS 2.0 en mode challenge (authentification forte) holderAuthentProgram: 3DS_V2 holderAuthentStatus : ATTEMPT
      29
      Plage de carte non enrôlée au programme 3DS 2.0 holderAuthentProgram: 3DS_V2 holderAuthentStatus : NOT_ENROLLED
      30
      Porteur non enrôlé au programme 3DS 2.0 holderAuthentProgram: 3DS_V2 holderAuthentStatus : NOT_ENROLLED
      31
      Echec de l’authentification du porteur en 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : FAILURE
      32
      Signature invalide dans la réponse de l’ACS en 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : FAILURE
      33
      Réponse de l’ACS invalide en 3DS 1.0 holderAuthentProgram: 3DS holderAuthentStatus : FAILURE
      34
      Echec de l’authentification du porteur en 3DS 2.0 en mode frictionless holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      35
      Echec de l’authentification du porteur en 3DS 2.0 en mode challenge holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      36
      Echec de l’authentification en 3DS 2.0 car aucun message Rreq reçu de l’ACS holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      37
      Echec de l’authentification en 3DS 2.0 car le message Cres est invalide holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      38
      Echec de l’authentification en 3DS 2.0 car le message Cres contient un message d’erreur holderAuthentProgram: 3DS_V2 holderAuthentStatus : FAILURE
      39
      Pas d’authentification comme demandé par le marchand holderAuthentProgram: 3DS_V2 holderAuthentStatus : NO_AUTHENT
      41
      Erreur en 3DS 1.0 : Session expirée holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      42
      Erreur en 3DS 2.0 : Session expirée holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      71
      Erreur en 3DS 2.0 : message ARes non reçu holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      72
      Erreur en 3DS 2.0 : message ARes reçu du DS est invalide holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      73
      Erreur en 3DS 2.0 : message RReq reçu de l’ACS est invalide holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      74
      Erreur en 3DS 2.0 : impossible de joindre le DS holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      75
      Erreur en 3DS 2.0 : problème technique sur la plateforme Sogenactif holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      76
      Erreur en 3DS 2.0 : problème technique sur le 3DS Server holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
      81
      Erreur en 3DS 1.0 : Erreur interne MPI lors du premier appel holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      82
      Erreur en 3DS 1.0 : Erreur interne MPI lors du second appel holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      84
      Erreur en 3DS 1.0 : Réponse du DS invalide holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      85
      Erreur en 3DS 1.0 : problème technique lors du premier appel au MPI holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      86
      Erreur en 3DS 1.0 : problème technique lors du second appel au MPI holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      87
      Erreur en 3DS 1.0 : les paramètres transmis au MPI sont invalides holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      88
      Erreur en 3DS 1.0 : Problème réseau holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      90
      Valeur obsolète holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      92
      Problème lors de la vérification de l’enrôlement du porteur holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      93
      Problème lors de l’authentification du porteur sur l’ACS holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      94
      Erreur en 3DS 2.0 : problème technique lors de l’appel au DS holderAuthentProgram: 3DS holderAuthentStatus : ERROR
      95
      Erreur en 3DS 2.0 : problème technique lors la cinématique avec l’ACS holderAuthentProgram: 3DS_V2 holderAuthentStatus : ERROR
    • authentDateTime
      présence
      Optionnel
      Interface version
      2.27

      Date et heure UTC de l’authentification.

    • authentCancelReason
      présence
      Optionnel
      Interface version
      2.27

      Motif d’annulation de l’authentification.

      Liste des valeurs
      01
      L’annulation a été demandée par le titulaire de carte
      02
      Le requêteur 3DS a annulé l’authentification
      03
      Transaction abandonnée
      04
      Temps de traitement dépassé chez ACS : autres délais
      05
      Temps de traitement dépassé chez ACS : Premier CReq non reçu par ACS
      06
      Transaction en erreur
      07
      Raison de l’annulation inconnue
    • holderAuthentType
      présence
      Optionnel
      Interface version
      2.27

      Type d’authentification du porteur appliqué par l’émetteur de la carte. Champ valorisé en 3-D Secure v2.

      Liste des valeurs
      CHALLENGE
      Authentification en mode challenge (redirection des pages d’authentification vers le porteur)
      FRICTIONLESS
      Authentification en mode frictionless
      FRICTIONLESS_DELEGATE
      Obsolète - Authentification en mode délégation de frictionless (DS gère l’authentification en délégation des émetteurs en cas de problème technique)
      NONE
      L’authentification n’a pas pu être mise en oeuvre
    • cavvAlgorithm
      présence
      Optionnel
      Interface version
      2.27

      Indicateur de l’algorithme utilisé pour la génération du CAVV lors d’un paiement 3-D Secure.

      Liste des valeurs
      0
      HMAC
      1
      CVV
      2
      CVV ATN
      3
      Mastercard SPA
    • authentTransStatusReason
      présence
      Optionnel
      Interface version
      2.27

      Motif accompagnant le résultat de l’authentification communiqué par le serveur 3-D Secure d’un paiement 3-D Secure.

    • authentMessageVersion
      présence
      Optionnel
      Interface version
      2.31

      Version du protocole 3-D Secure utilisé (e.g. 2.1.0).

    • cavv
      présence
      Optionnel
      Interface version
      2.27

      Valeur de vérification de l’authentification du porteur lors d’un paiement 3-D Secure.

    • authentDsTransId
      présence
      Optionnel
      Interface version
      2.27

      Identifiant universel de transaction attribué par le DS pour identifier de manière unique une transaction.

    • challengeMode3DS
      présence
      Optionnel
      Interface version
      2.27

      Niveau d’authentification du porteur demandé.

      Liste des valeurs
      CHALLENGE
      Le marchand souhaite qu’il y ait authentification du client. Autrement dit c’est une demande de “Challenge”
      CHALLENGE_MANDATE
      Le marchand a besoin règlementairement qu’il y ait une authentification forte du client (par exemple pour le premier paiement d’un échéancier de paiement)
      NO_CHALLENGE
      Le marchand souhaite qu’il n’y ait pas d’authentification du client. Autrement dit c’est une demande de “Frictionless”
      NO_CHALLENGE_DTA
      Le marchand souhaite qu’il n’y ait pas d’authentification du client dans une cinématique Direct to Authorize
      NO_CHALLENGE_TRA_ACQ
      Le marchand souhaite qu’il n’y ait pas d’authentification du porteur en invoquant l’exemption TRA Acquéreur. C’est une demande de “Frictionless”.
      NO_CHALLENGE_TRA_ACQ_DTA
      Le marchand souhaite qu’il n’y ait pas d’authentification du porteur en invoquant l’exemption TRA Acquéreur. C’est une demande Direct to Authorize.
      NO_PREFERENCE
      Le marchand n’exprime aucun souhait. C’est la valeur par défaut
    • authentExemptionReasonList
      présence
      Optionnel
      Interface version
      2.31

      Liste des exemptions retenues par l’émetteur.

      Liste des valeurs
      AUTOMATE_PAYMENT
      Automates de paiement des frais de transport et de parking
      CORPORATE
      Exemption procédure et protocole de paiement sécurisés pour les entreprises
      DELEGATED_SCA
      Authentification forte mise en œuvre par l’accepteur (wallet)
      LOW_RISK_MERCHANT_CB
      Analyse de risque – commerçant dans le programme Low Risk Merchant CB
      LOW_VALUE
      Exemption petits montants
      OTHER_EXEMPTION
      Autre cas d’usage exempté d’authentification
      OUT_OF_SCOPE_RTS
      Authentification non requise car hors du scope RTS SCA
      RECURRING_FIX
      Exemption opérations récurrentes de montants identiques et durée déterminée
      TECHNICAL_ERROR
      Impossibilité technique de mettre en œuvre l’authentification
      TRA_ACQUIRER
      Exemption analyse de risque par l’accepteur/l’acquéreur
      TRA_ISSUER
      Exemption analyse de risque par l’émetteur
      WHITE_LIST
      Exemption bénéficiaire de confiance
    • authentAcsTransId
      présence
      Optionnel
      Interface version
      2.27

      Identifiant universel de transaction attribué par l’ACS pour identifier de manière unique une transaction.

    • authentDsMerchantName
      présence
      Optionnel
      Interface version
      2.31

      Identifiant attribué par le Directory Server pour identifier de manière unique le commerçant.

    • eci
      présence
      Optionnel
      Interface version
      2.27

      Indicateur de commerce électronique lors d’un paiement 3-D Secure.

    • authentScoreValue
      présence
      Optionnel
      Interface version
      2.27

      Valeur du score fourni par le DS (Directory Server) à l’ACS (Access Control Server).

    • authentAmount
      présence
      Optionnel
      Interface version
      2.27

      Montant de l’authentification.

    • authentThreedsServerTransId
      présence
      Optionnel
      Interface version
      2.35

      Identifiant universel de transaction attribué par le 3DS Server pour identifier de manière unique une transaction.

    • authentAcsMethod
      présence
      Optionnel
      Interface version
      2.31

      Méthode d’authentification que l’ACS a appliqué pour authentifier le porteur de la carte.

      Liste des valeurs
      01
      STATIC_PASSCODE
      02
      SMS_OTP
      03
      KEY_FOB_OR_EMV_CARD_READER_OTP
      04
      APP_OTP
      05
      OTP_OTHER
      06
      KBA
      07
      OOB_BIOMETRICS
      08
      OOB_LOGIN
      09
      OOB_OTHER
      10
      OTHER
    • txStatus
      présence
      Optionnel
      Interface version
      2.27

      Résultat de l’authentification lors d’un paiement 3-D Secure.

      Liste des valeurs
      9
      CARD_NOT_ENROLLED
      A
      ATTEMPT
      C
      CHALLENGE
      D
      DECOUPLED_AUTHENTICATION
      E
      AUTHENTICATED_WITHOUT_CRYPTO
      I
      INFO_ONLY
      N
      NOT_AUTHENTICATED
      R
      AUTHENTICATION_REJECTED
      U
      ERROR
      Y
      AUTHENTICATED_WITH_CRYPTO

Exemple de réponse

            {
  "responseCode": "00",
  "holderAuthentResponseCode": "00",
  "seal": "ef3f3cc68a39a5d1144663162a35fa6070bfe39d5abbe672b15417ff87afc431"
}

        
                  <cardValidateAuthenticationResponse xmlns="urn:sips:cn:contract:office:checkout:v2">
         <output> 
            <responseCode>00</responseCode>
            <holderAuthentResponseCode>00</holderAuthentResponseCode>
         </output>
      </cardValidateAuthenticationResponse>

Changelog


Interface version Donnée Présence Conteneur
2.12 intermediateServiceProviderId Requête
2.0 s10TransactionReference Requête
2.0 s10TransactionId Conteneur
  • s10TransactionReference
    • 2.0 s10TransactionIdDate Conteneur
  • s10TransactionReference
    • 2.12 sealAlgorithm Requête
    2.0 transactionReference Requête
    2.0 interfaceVersion Requête
    2.0 keyVersion Requête
    2.0 merchantId Requête
    2.0 messageVersion Requête
    2.0 paResMessage Requête
    2.0 redirectionData Requête
    2.0 seal Requête/Réponse
    2.21 errorFieldName Réponse
    2.27 holderAuthentMethod Réponse
    2.27 holderAuthentProgram Réponse
    2.0 holderAuthentResponseCode Réponse
    2.27 holderAuthentStatus Réponse
    2.0 responseCode Réponse
    2.27 threeD Réponse
    2.27 securityIndicator Conteneur
  • threeD
  • threeDV2
    • 2.27 cavv Conteneur
  • threeD
  • threeDV2
    • 2.27 eci Conteneur
  • threeD
  • threeDV2
    • 2.27 cavvAlgorithm Conteneur
  • threeD
  • threeDV2
    • 2.27 txStatus Conteneur
  • threeD
  • threeDV2
    • 2.27 xid Conteneur
  • threeD
    • 2.27 threeDV2 Réponse
    2.27 authentDateTime Conteneur
  • threeDV2
    • 2.27 authentCancelReason Conteneur
  • threeDV2
    • 2.27 holderAuthentType Conteneur
  • threeDV2
    • 2.27 authentTransStatusReason Conteneur
  • threeDV2
    • 2.31 authentMessageVersion Conteneur
  • threeDV2
    • 2.27 authentDsTransId Conteneur
  • threeDV2
    • 2.27 challengeMode3DS Conteneur
  • threeDV2
    • 2.31 authentExemptionReasonList Conteneur
  • threeDV2
    • 2.27 authentAcsTransId Conteneur
  • threeDV2
    • 2.31 authentDsMerchantName Conteneur
  • threeDV2
    • 2.27 authentScoreValue Conteneur
  • threeDV2
    • 2.27 authentAmount Conteneur
  • threeDV2
    • 2.35 authentThreedsServerTransId Conteneur
  • threeDV2
    • 2.31 authentAcsMethod Conteneur
  • threeDV2
    • Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Contacter le support
    Fermer

    Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation Sogenactif.
    En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

    Paramètres