Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Tip

An introduction to 3DSV2 is available in the section 3D Secure - Strong Authentication for Secure Payments



The 3DS V2 protocol supports 150 data points transmitted to the issuer. However, processing these data points by the issuers can be time-consuming. Therefore, it is recommended to share the most essential and effective data points with the issuer to benefit from 'frictionless' payments.


In a payment request, the merchant must mandatorily transmit the following data:

  • Card data in compliance with PCI DSS requirements
  • Transaction data: identification numbers, currency, and amount
  • Browser data: User location and connection system (language, screen size, IP address, etc.)
  • Cardholder data: User's first and last name
  • Recurring payment data (if using recurring payments)

To promote frictionless payments, the merchant can:

  • Provide additional data
  • Indicate their preference for frictionless payment
  • Request an exemption



Provide additional data in the payment request


Certaines données complémentaires sont fortement recommandées pour améliorer l’analyse de risque de la transaction par l’émetteur :

  • les données sur l’adresse de livraison : ville, code postal, pays…
  • Les données sur les détails de la livraison (date de livraison)
  • Les données sur le compte de l’utilisateur (date de création du compte chez le commerçant, date de réinitialisation du mot de passe, etc)
  • Les données panier (Nombre d’articles dans le panier)
  • Le scoring commerçant
Some additional data is strongly

Some additional data are highly recommended to improve the transaction risk analysis by the issuer:

  • Shipping address details: city, postal code, country, etc.
  • Delivery details (delivery date)
  • User account information (account creation date with the merchant, password reset date, etc.)
  • Basket data (number of items in the order)
  • Merchant scoring

The following JSON objects can be added to payment requests:

  • customerInfo
  • billingAddress
  • shipping
  • browserInfo


The recommended data are as follows:

  • Information du porteur de la carte
    • Nom et prénom
    • Adresse email
    • Numéro de téléphone fixe
    • Numéro de téléphone portable
    • Adresse de facturation
    • Adresse de livraison
  • Information sur le navigateur/ Browser (dépend de l’intégration)

    • Adresse IP
    • Cardholder information:
      • First name and last name
      • Email address
      • Landline phone number
      • Mobile phone number
      • Billing address
      • Delivery address
    • Browser information (depends on integration):
      • IP address


    Note: All this data will be used to secure the online process with the aim of fighting fraud. Issuing banks are regulated in the management of these confidential data.

    Code Block
    languagejson
    titleExample of customerInfo object
    linenumberstrue
    ...
        "customerInfo": {
          "merchantCustomerId": "cus_1234567890abcdef",
          "customerType": "individual",
          "firstName": "Max",
          "lastName": "Mustermann",
          "email": "customer@example.com",
          "phone": {
            "countryCode": "+49",
            "number": "1236547890"
          },
          "salutation": "Ms",
          "title": "Dr",
          "gender": "female",
          "maidenName": "Mustermann",
          "middleName": "sam",
          "birthDate": "2001-01-01",
          "birthPlace": "Bamberg",
          "socialSecurityNumber": "123443534"
        },
    ...
    Code Block
    languagejson
    titleExample of billingAddress & shipping objectobjects
    linenumberstrue
    ...
        "billingAddress": {
          "streetName": "Schwarzenbergstr",
          "streetNumber": "4",
          "city": "Bamberg",
          "country": "DEU",
          "postalCode": "96050"
        },
        "shipping": {
          "address": {
            "streetName": "Schwarzenbergstr",
            "streetNumber": "4",
            "city": "Bamberg",
            "country": "DEU",
            "postalCode": "96050"
          }
        },
    ...


    Info

    The addition of these additional data without an explicit request for 'frictionless' payment corresponds to the 'no Preference' case.

    In this case, if the payment is 'frictionlessfrictionless', the transfer of responsibility liability shift to the issuing bank applies.

    For more details: Liability Shift and 3D-Secure Matrices


    Indicate a 'frictionless' payment preference


    L’objet The JSON threeDsPolicy permet au commerçant d'indiquer son souhait d’offrir un parcours frictionless à son acheteur.object threeDsPolicy allows the merchant to indicate their preference for offering a frictionless journey to their buyer.

    The challengePreference parameter indicates the merchant's preference regarding authenticationLe paramètre challengePreference indique la préférence du commerçant vis-à-vis de l’authentification :

    • NO_PREFERENCE:
    • Le commerçant laisse le choix à l’émetteur d’authentifier l’acheteur
    • The merchant leaves the choice to the issuer to authenticate the buyer
    • NO_CHALLENGE:
    • Le commerçant souhaite que l’acheteur ne soit pas authentifié (demande d’exemption
    • The merchant wants the buyer not to be authenticated (exemption request, frictionless)
    • REQUEST_CHALLENGE:
    • Le commerçant souhaite authentifier l’acheteur.
    • The merchant wants to authenticate the buyer
    • MANDATE_CHALLENGE:
    • Le commerçant demande à l’émetteur d’authentifier l’acheteur (par exemple pour la première transaction d’un abonnement
    • The merchant requests the issuer to authenticate the buyer (for example, for the first transaction of a subscription)

    In all cases, the final decision is made by the issuing bank (the cardholder's bank).


    Code Block
    themeEclipse
    titleExample of frictionless payment request
    linenumberstrue
    ...
    
    "paymentMethods": {
        "integrationType": "HOSTED",
        "type": "CARD",
        "card": {
            "threeDsPolicy": {
                "challengePreference" : "NO_CHALLENGE"
                }
            }
    	}
    ...




    Info

    The  liability shift

    Le transfert de responsabilité vers la banque émettrice dépend du choix du marchand et de la marque de la carte.

    The transfer of liability to the issuing bank depends on the merchant's choice and the card brand.

    For more details: Liability Shift and 3D-Secure Matrices - Documentation Axepta BNP Paribas




    Request an

    Demander une

    exemption


    The JSON object threeDsPolicy  allows the merchant to indicate an exemption request.

    L’objet JSON threeDsPolicy permet au commerçant d'indiquer une demande d'exemption.

    Le paramètre The threeDsPolicy – exemption.reason indique l'exemption souhaitée par le commerçant parameter indicates the exemption requested by the merchant:

    • LOW_VALUE: Les transactions à faible montant (inférieur à 30 €)Low-value transactions (less than 30 €)
      • Banks must still request authentication if the exemption has been used five times since the last successful authentication by the cardholder or if the sum of previously exempted payments exceeds

      • Les banques doivent toutefois demander une authentification si l’exemption a été utilisée cinq fois depuis la dernière authentification réussie du titulaire de la carte ou si la somme des paiements exemptés précédemment dépasse
      • 100 €.

    • TRANSACTION_RISK_ANALYSIS:

    • Les transactions à faible risque
    • Low-risk transactions (TRA: Transaction Risk Analysis)

    • une dérogation à l’obligation d’authentification forte peut être accordée. Pour cela, il faut l'accord préalable de l'acquéreur (sur la base d’une analyse de risque en temps réel de chaque opération).
    • Pour bénéficier de cette exemption, le commerçant doit contacter son chargé d’affaires.
      • An exemption from strong authentication may be granted. This requires prior agreement from the acquirer (based on a real-time risk analysis of each transaction).

      • To benefit from this exemption, the merchant must contact their account manager.


    In all cases, the final decision is made by the issuing bank (the cardholder's bankDans tous les cas, le choix final est défini par la banque émettrice (banque du porteur).


    Code Block
    themeEclipse
    titleExemple d'une demande d'exemption 'petit montant'Example of LOW_VALUE exemption request
    linenumberstrue
    ...
    
    "paymentMethods": {
        "integrationType": "HOSTED",
        "type": "CARD",
        "card": {
            "threeDsPolicy": {
                "exemption" : {
                     "reason" : "LOW_VALUE"
                }
            }
        }
    }
    ...


    Info

    The transfer of responsibility to the issuing bank depends on the merchant's choice and the card brand.

    For more details: 

    Le transfert de responsabilité vers la banque émettrice dépend du choix du marchand et de la marque de la carte.

    Pour plus de détails : Transfert de reponsabilité et Matrices 3D-Secure