Versions Compared

Key

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


Tip

An introduction to 3DSV2 is available in the section (NL) Een inleiding tot 3D Secure 2.0 (3DSV2) is beschikbaar in de betreffende sectie 3D Secure - Strong Authentication for Secure Payments (EN)



The Het 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

 ondersteunt 150 gegevenspunten die naar de kaartuitgevende bank worden verzonden. Het verwerken van al deze gegevens door de uitgevende banken kan echter tijdrovend zijn. Daarom wordt aangeraden om alleen de meest essentiële en effectieve gegevenspunten te delen om zo veel mogelijk te profiteren van 'frictionless' betalingen (zonder extra authenticatiestap).


Verplichte gegevens in een betaalverzoek

De handelaar moet volgende gegevens verplicht doorsturen:

  • Kaartgegevens (in overeenstemming met PCI DSS-vereisten)
  • Transactiegegevens: identificatienummers, valuta en bedrag
  • Browsergegevens: locatie en verbindingssysteem van de gebruiker (taal, schermgrootte, IP-adres, enz.)
  • Kaarthoudergegevens: voor- en achternaam van de gebruiker
  • Gegevens over terugkerende betalingen (indien van toepassing)



Hoe 'frictionless' betalingen bevorderen?


De handelaar kan:

  1. Extra gegevens verstrekken (zie hieronder)
  2. Aangeven dat hij de voorkeur geeft aan een 'frictionless' betaling
  3. Een vrijstelling aanvragen (bijv. voor lage bedragen of lage risico's)

Aanbevolen extra gegevens voor betere risicoanalyse

Om de kans op een 'frictionless' betaling te vergroten, kan de handelaar volgende aanvullende gegevens meezenden:

Klantinformatie (customerInfo)

  • Voor- en achternaam
  • E-mailadres
  • Vast telefoonnummer
  • Mobiel telefoonnummer

Factuur- en verzendadres (billingAddress & shipping)

  • Stad, postcode, land
  • Leveringsdetails (leverdatum)

Winkelmandgegevens

  • Aantal artikelen in de bestelling

Browserinformatie (browserInfo)

  • IP-adres
  • Taalinstellingen
  • Schermresolutie

Overige gegevens

  • Accountinformatie (datum accountaanmaak, datum laatste wachtwoordwijziging)
  • Handelaarsscore (indien beschikbaar)


JSON-objecten die kunnen worden toegevoegd aan betaalverzoeken

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:

  • 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⚠️ Opmerking: Al deze gegevens worden alleen gebruikt om de online betaling te beveiligen en fraude te bestrijden. Uitgevende banken zijn strikt gereguleerd in het beheer van deze vertrouwelijke gegevens.

Code Block
languagejson
titleExample of Voorbeeld van 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 objects
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

Het toevoegen van deze extra gegevens zonder een expliciet verzoek voor een 'frictionless' betaling valt onder het geval 'geen voorkeur' (NO_PREFERENCE).

In dit geval, als de betaling 'frictionless' verloopt, geldt de overdracht van aansprakelijkheid naar de uitgevende bank.

Voor meer details: 

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 'frictionless', the liability shift to the issuing bank applies.

For more details: (NL) Liability Shift and 3D-Secure Matrices (EN)


Voorkeur voor

Indicate a

'frictionless'

payment preference

betaling aangeven


Het threeDsPolicy-object laat de handelaar toe om zijn voorkeur voor een 'frictionless' betaling aan te geven via de parameter challengePreference:

WaardeBeschrijving
NO_PREFERENCEDe handelaar laat de keuze aan de uitgevende bank om de koper al dan niet te authenticeren.
NO_CHALLENGEDe handelaar verzoekt om géén authenticatie (vrijstellingsverzoek, 'frictionless').
REQUEST_CHALLENGEDe handelaar verzoekt om authenticatie (bijv. voor verdachte transacties).
MANDATE_CHALLENGEDe handelaar eist authenticatie (bijv. voor de eerste betaling van een abonnement).

🔹 Let op: De uiteindelijke beslissing ligt altijd bij de uitgevende bank (de bank van de kaarthouder

The JSON 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 authentication:

  • NO_PREFERENCE: The merchant leaves the choice to the issuer to authenticate the buyer
  • NO_CHALLENGE: The merchant wants the buyer not to be authenticated (exemption request, frictionless)
  • REQUEST_CHALLENGE: The merchant wants to authenticate the buyer
  • MANDATE_CHALLENGE: 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 Voorbeeld van een frictionless betaling request
linenumberstrue
...

"paymentMethods": {
    "integrationType": "HOSTED",
    "type": "CARD",
    "card": {
        "threeDsPolicy": {
            "challengePreference" : "NO_CHALLENGE"
            }
        }
	}
...




Info

De aansprakelijkheidsoverdracht naar de uitgevende bank is afhankelijk van de keuze van de handelaar en het kaartmerk.

Voor meer details

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

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

Request an exemption




Een vrijstelling aanvragen


Het threeDsPolicy-object laat de handelaar ook toe om een vrijstelling aan te vragen via de parameter exemption:

VrijstellingsredenBeschrijvingVoorwaarden
LOW_VALUETransacties met laag bedrag (minder dan €30).Banken moeten toch authenticatie vragen als:
  • De vrijstelling al 5 keer is gebruikt sinds de laatste succesvolle authenticatie of
  • Het totaalbedrag van vrijgestelde betalingen €100 overschrijdt. | | TRANSACTION_RISK_ANALYSIS | Transacties met laag risico 

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

The threeDsPolicy – exemption.reason parameter indicates the exemption requested by the merchant:

  • LOW_VALUE: 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 100 €.

  • TRANSACTION_RISK_ANALYSIS: Low-risk transactions
  • (TRA: Transaction Risk Analysis)
    • 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.

  • . | Een vrijstelling kan worden toegekend, maar dit vereist een voorafgaande overeenkomst met de acquirer (gebaseerd op een real-time risicoanalyse). Neem contact op met je accountmanager. |

🔹 Let op: Ook hier geldt dat de uitgevende bank de uiteindelijke beslissing neemtIn all cases, the final decision is made by the issuing bank (the cardholder's bank).


Code Block
themeEclipse
titleExample of Voorbeeld van een LOW_VALUE exemption request-vrijstellingsverzoek
linenumberstrue
...

"paymentMethods": {
    "integrationType": "HOSTED",
    "type": "CARD",
    "card": {
        "threeDsPolicy": {
            "exemption" : {
                 "reason" : "LOW_VALUE"
            }
        }
    }
}
...


Info

De overdracht van aansprakelijkheid naar de uitgevende bank hangt af van de keuze van de handelaar en het kaartmerk (Visa, Mastercard, etc.).

Voor meer

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

For more details: Transfert de reponsabilité et Matrices 3D-Secure