Een inleiding tot 3D Secure 2.0 (3DSV2) is beschikbaar in de betreffende sectie 3D Secure - Strong Authentication for Secure Payments (EN)



Het 3DS V2-protocol 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:

  • customerInfo
  • billingAddress
  • shipping
  • browserInfo

⚠️ 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.

...
    "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"
    },
...
...
    "billingAddress": {
      "streetName": "Schwarzenbergstr",
      "streetNumber": "4",
      "city": "Bamberg",
      "country": "DEU",
      "postalCode": "96050"
    },
    "shipping": {
      "address": {
        "streetName": "Schwarzenbergstr",
        "streetNumber": "4",
        "city": "Bamberg",
        "country": "DEU",
        "postalCode": "96050"
      }
    },
...


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: Liability Shift and 3D-Secure Matrices (EN)


Voorkeur voor 'frictionless' 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).


...

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




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

Voor meer details: Liability Shift and 3D-Secure Matrices




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 (TRA: Transaction Risk Analysis). | 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 neemt.


...

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


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

Voor meer details: Transfert de reponsabilité et Matrices 3D-Secure