Visa Sicheres Datenfeld Mandat: Erforderliche Datenfelder

  Zuletzt aktualisiert: 

 

visa-sicher_blu_2021.png

Visa Secure ist Visa's EMV 3-D Secure Authentifizierungsprodukt, das Starke Kundenauthentifizierung (SCA) für elektronische Zahlungen erleichtert.

Erfahren Sie mehr über SCA und EMV 3-D Secure

  Händler und Partner, die Trust Payments Warenkorb-Plugins verwenden, brauchen nichts zu unternehmen, da diese Plugins bereits so konfiguriert sind, dass sie diese Daten bereitstellen.

Um das Ökosystem des Zahlungsverkehrs dabei zu unterstützen, die Vorteile der EMV-Authentifizierung 3-D Secure voll auszuschöpfen, hat Visa die Händler angewiesen, ihre Authentifizierungsanfragen (AReq/THREEDQUERY) bis zum 12. August 2024 so zu aktualisieren, dass sie die unten beschriebenen Felder enthalten.


Die Nichteinhaltung dieses Mandats kann zum Scheitern der Authentifizierung, zur Herabstufung und zum Verlust des Haftungsschutzes von Visa führen.

 

Bitte erweitern Sie Ihre Lösung aus der folgenden Liste, um weitere Informationen zur Aktualisierung Ihrer Anfragen zu erhalten:

Payment Pages

Welche Schritte Sie durchführen müssen, hängt davon ab, wie die Kundendaten für die Transaktion beschafft werden. Bitte beachten Sie die nachstehenden Lösungen:

  Durchgang

Wie werden die Rechnungsdaten des Kunden an Trust Payments weitergegeben?


Ich sende die Rechnungsdaten an Payment Pages  Der Kunde gibt die Rechnungsdaten auf Payment Pages

Sie müssen Ihre Prozesse aktualisieren, um die neuen erforderlichen Felder auf Ihrer Seite zu erhalten, und diese in den POST an Payment Pages aufnehmen. Der aktualisierte POST würde etwa so aussehen:

Bitte beachten Sie, dass billingemail UND/ODER billingtelephone erforderlich sind - Sie können gerne eines der beiden Felder oder beide einreichen.
<html>
<body>
<form method="POST" action="<DOMAIN>/process/payments/choice">
<input type="hidden" name="sitereference" value="test_site12345">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="currencyiso3a" value="USD">
<input type="hidden" name="mainamount" value="100.00">

<!-- Posting the required billing fields -->
<input type="hidden" name="billingfirstname" value="Jay">
<input type="hidden" name="billinglastname" value="Doe">

<!-- Post billingemail, billingtelephone or both -->
<input type="hidden" name="billingemail" value="customer@email.com">
<input type="hidden" name="billingtelephone" value="01234567890">

<input type="hidden" name="version" value="2">
<input type="submit" value="Pay">
</form>
</body>
</html>

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.


Info zur Angabe von Pflichtfeldern Versuchen wir mal etwas anderes

Bitte aktualisieren Sie Ihr POST an Trust Payments um strequiredfields wie im folgenden Beispiel gezeigt.

Die strequiredfields stellt sicher, dass der Kunde nicht zur Authentifizierung auf 3-D Secure übergehen kann, ohne Werte für die Felder anzugeben, die als Teil dieses Mandats erforderlich sind.
<html>
<body>
<form method="POST" action="<DOMAIN>/process/payments/choice">
<input type="hidden" name="sitereference" value="test_site12345">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="currencyiso3a" value="USD">
<input type="hidden" name="mainamount" value="100.00">

<!-- Enforcing the required billing fields -->
<input type="hidden" name="strequiredfields" value="billingfirstname">
<input type="hidden" name="strequiredfields" value="billinglastname">

<!-- Enforcing billing email and/or telephone fields -->
<!-- Choose billingemail, billingtelephone or both -->

<input type="hidden" name="strequiredfields" value="billingemail">
<input type="hidden" name="strequiredfields" value="billingtelephone">

<input type="hidden" name="version" value="2">
<input type="submit" value="Pay">
</form>
</body>
</html>

Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.


Info zur Angabe von Pflichtfeldern Versuchen wir mal etwas anderes

  1. Sie müssen Ihr CSS aktualisieren, um den Code zu entfernen, der speziell diese Felder ausblendet, und das aktualisierte CSS mit Datei-Manager hochladen.

  2. Aktualisieren Sie dann Ihr POST an Trust Payments , um Folgendes einzuschließen strequiredfields wie im folgenden Beispiel gezeigt.

    Die strequiredfields stellt sicher, dass der Kunde nicht zur Authentifizierung auf 3-D Secure übergehen kann, ohne Werte für die Felder anzugeben, die als Teil dieses Mandats erforderlich sind.
    <html>
    <body>
    <form method="POST" action="<DOMAIN>/process/payments/choice">
    <input type="hidden" name="sitereference" value="test_site12345">
    <input type="hidden" name="stprofile" value="default">
    <input type="hidden" name="currencyiso3a" value="USD">
    <input type="hidden" name="mainamount" value="100.00">

    <!-- Enforcing the required billing fields -->
    <input type="hidden" name="strequiredfields" value="billingfirstname">
    <input type="hidden" name="strequiredfields" value="billinglastname">

    <!-- Enforcing billing email and/or telephone fields -->
    <!-- Choose billingemail, billingtelephone or both -->

    <input type="hidden" name="strequiredfields" value="billingemail">
    <input type="hidden" name="strequiredfields" value="billingtelephone">

    <input type="hidden" name="version" value="2">
    <input type="submit" value="Pay">
    </form>
    </body>
    </html>

    Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.


Informationen über den Datei-Manager Info über die Angabe von Pflichtfeldern Versuchen wir mal etwas anderes

  1. Wenn Sie eine der folgenden Standardprofilkonfigurationen verwenden, werden die Rechnungsfelder ausgeblendet:

    CP25-EN.png

    st_paymentcardonly

    CP26-EN.png

    st_cardonly

    CP27-EN.png

    st_iframe_cardonly


    Um sicherzustellen, dass die Rechnungsfelder angezeigt werden, sollten Sie Ihre Konfiguration auf eine der folgenden Alternativen aktualisieren:

    CP23-EN.png

    Standard

    CP24-EN.png

    st_Zahlungskarte

    Je nachdem, wie Ihr Website-Referenz konfiguriert wurde, kann es erforderlich sein, dass Sie unser Support-Team kontaktieren müssen, um Ihr Standardprofil zu ändern. Bitte kontaktieren Sie uns, wenn Sie sich nicht sicher sind.
  2. Aktualisieren Sie dann Ihr POST an Trust Payments , um Folgendes einzuschließen strequiredfields wie im folgenden Beispiel gezeigt.

    Die strequiredfields stellt sicher, dass der Kunde nicht zur Authentifizierung auf 3-D Secure übergehen kann, ohne Werte für die Felder anzugeben, die als Teil dieses Mandats erforderlich sind.
    <html>
    <body>
    <form method="POST" action="<DOMAIN>/process/payments/choice">
    <input type="hidden" name="sitereference" value="test_site12345">
    <input type="hidden" name="stprofile" value="default">
    <input type="hidden" name="currencyiso3a" value="USD">
    <input type="hidden" name="mainamount" value="100.00">

    <!-- Enforcing the required billing fields -->
    <input type="hidden" name="strequiredfields" value="billingfirstname">
    <input type="hidden" name="strequiredfields" value="billinglastname">

    <!-- Enforcing billing email and/or telephone fields -->
    <!-- Choose billingemail, billingtelephone or both -->

    <input type="hidden" name="strequiredfields" value="billingemail">
    <input type="hidden" name="strequiredfields" value="billingtelephone">

    <input type="hidden" name="version" value="2">
    <input type="submit" value="Pay">
    </form>
    </body>
    </html>

    Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.


Informationen über stdefaultprofile Info über die Angabe von Pflichtfeldern Versuchen wir etwas anderes

  1. Sie müssen eine der folgenden Optionen zu Ihrem HTML-Markup auf der Seite [stprofile]details.html hinzufügen und mit Hilfe von Datei-Manager erneut auf Ihre Seite Website-Referenz hochladen:

    Erforderliche Rechnungsfelder einzeln anzeigen
    {{st.billingfirstname.textfield}}
    {{st.billinglastname.textfield}}
    {{st.billingemail.textfield}}
    {{st.billingtelephone.textfield}}
    Weil billingemail OR billingtelephone Felder erforderlich sind, können Sie eines dieser Felder auslassen, wenn Sie dies wünschen.
    Anzeigesperre für alle Abrechnungsfelder
    {{st.block.billingdetailsdiv}}
  2. Aktualisieren Sie dann Ihr POST an Trust Payments , um Folgendes einzuschließen strequiredfields wie im folgenden Beispiel gezeigt.

    Die strequiredfields stellt sicher, dass der Kunde nicht zur Authentifizierung auf 3-D Secure übergehen kann, ohne Werte für die Felder anzugeben, die als Teil dieses Mandats erforderlich sind.
    <html>
    <body>
    <form method="POST" action="<DOMAIN>/process/payments/choice">
    <input type="hidden" name="sitereference" value="test_site12345">
    <input type="hidden" name="stprofile" value="default">
    <input type="hidden" name="currencyiso3a" value="USD">
    <input type="hidden" name="mainamount" value="100.00">

    <!-- Enforcing the required billing fields -->
    <input type="hidden" name="strequiredfields" value="billingfirstname">
    <input type="hidden" name="strequiredfields" value="billinglastname">

    <!-- Enforcing billing email and/or telephone fields -->
    <!-- Choose billingemail, billingtelephone or both -->

    <input type="hidden" name="strequiredfields" value="billingemail">
    <input type="hidden" name="strequiredfields" value="billingtelephone">

    <input type="hidden" name="version" value="2">
    <input type="submit" value="Pay">
    </form>
    </body>
    </html>

    Ersetzen Sie <DOMAIN> mit einer unterstützten Domäne. Klicken Sie hier für eine vollständige Liste.


Informationen über Felder und Blöcke Informationen über den Datei-Manager Info über die Angabe von Pflichtfeldern Versuchen wir etwas anderes

 

  Bitte nehmen Sie die Änderungen auf Ihrer Testseite Website-Referenz vor und überprüfen Sie, ob sie funktionieren, bevor Sie Ihre Live-Seite Website-Referenz aktualisieren!


Nach jeder Änderung führen Sie bitte einige Testtransaktionen durch, um sicherzustellen, dass Sie die Transaktion nur dann abschließen können, wenn die erforderlichen Felder während der Payment Pages Sitzung eingegeben werden. Wenn dies erfolgreich war, sind keine weiteren Schritte erforderlich. Bitte stellen Sie sicher, dass diese Änderungen nun in Ihrem Live-System Website-Referenz vorgenommen werden.

JavaScript Library

Sie müssen sicherstellen, dass die payload die folgenden, von Visa vorgeschriebenen Felder enthält (siehe Beispiele unten):

Für Felder, die im Folgenden für dieses spezifische Mandat als "erforderlich" gekennzeichnet sind, können in unseren anderen Unterlagen andere Anforderungen gelten.
  Feld Format Beschreibung
X2-EN.png billingemail E-Mail (255)

Die Adresse des Kunden Rechnungs-E-Mail . Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Zeichen).

Erforderlich, wenn billingtelephone NICHT übermittelt wird, ansonsten optional.

X1-EN.png billingfirstname Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsvorname.

X1-EN.png billinglastname Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsnachname.

X2-EN.png billingtelephone Alphanumerisch einschließlich
Symbole (20)
Die Telefonnummer des Kunden. Gültige Zeichen:
  • Ziffern 0-9
  • Räume
  • Sonderzeichen: + - ( )

Erforderlich, wenn billingemail NICHT übermittelt wird, ansonsten optional.

  Öffnen Sie die Feldspezifikation

 

(Payload)

{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingemail":"customer@email.com",
"billingtelephone":"01234567890",
"currencyiso3a":"GBP",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"test_site12345"
},
"iat":1559033849,
"iss":"jwt.user"
}
Android SDK / iOS SDK

Sie müssen sicherstellen, dass die payload die folgenden, von Visa vorgeschriebenen Felder enthält (siehe Beispiele unten):

Für Felder, die im Folgenden für dieses spezifische Mandat als "erforderlich" gekennzeichnet sind, können in unseren anderen Unterlagen andere Anforderungen gelten.
  Feld Format Beschreibung
X2-EN.png billingemail E-Mail (255)

Die Adresse des Kunden Rechnungs-E-Mail . Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Zeichen).

Erforderlich, wenn billingtelephone NICHT übermittelt wird, ansonsten optional.

X1-EN.png billingfirstname Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsvorname.

X1-EN.png billinglastname Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsnachname.

X2-EN.png billingtelephone Alphanumerisch einschließlich
Symbole (20)
Die Telefonnummer des Kunden. Gültige Zeichen:
  • Ziffern 0-9
  • Räume
  • Sonderzeichen: + - ( )

Erforderlich, wenn billingemail NICHT übermittelt wird, ansonsten optional.

Android SDK-Feldspezifikation iOS SDK-Feld-Spezifikation

 

(Payload)

{
"payload":{
"accounttypedescription":"ECOM",
"baseamount":"1050",
"billingfirstname":"Jay",
"billinglastname":"Doe",
"billingemail":"customer@email.com",
"billingtelephone":"01234567890",
"currencyiso3a":"GBP",
"requesttypedescriptions":["THREEDQUERY","AUTH"],
"sitereference":"test_site12345",
"termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener"
},
"iat":1559033849,
"iss":"jwt.user"
}
3DS API

Sie müssen sicherstellen, dass die Anfrage THREEDQUERY die folgenden Felder enthält:

  • billingfirstname
  • billinglastname
  • ENTWEDER billingemail ODER billingtelephone
  • browserscreenheight
  • browserscreenwidth
  • customerip
Bitte beachten Sie, dass billingemail UND/ODER billingtelephone erforderlich sind - Sie können gerne eines der beiden Felder oder beide einreichen.

  Wir empfehlen Ihnen, die vollständige Feldspezifikation für die Anfrage THREEDQUERY zu prüfen und sicherzustellen, dass alle erforderlichen Felder ausgefüllt werden.

  Öffnen Sie die Feldspezifikation

 

Reibungslos - JSON Herausforderung - JSON Reibungslos - XML Herausforderung - XML
{
"alias":"webservices@example.com",
"version":"1.00",
"request":[{
"accept": "text/html,*/*",
"accounttypedescription": "ECOM",
"acquirerbin": "408912",
"baseamount": "1050",
"billingemail": "customer@email.com",
"billingfirstname": "Jay",
"billinglastname": "Doe",
"billingtelephone": "01234567890",
"browsercolordepth": "24",
"browserjavaenabled": "false",
"browserjavascriptenabled": "true",
"browserlanguage": "en",
"browserscreenheight": "864",
"browserscreenwidth": "1536",
"browsertz": "120",
"cachetoken": "eyJkYXRhY2VudGVydXJsIjogImh0dHBzOi8vd2Vic2VydmljZXMuc2VjdXJldHJhZGluZy5uZXQiLCAiY2FjaGV0b2tlbiI6ICI1Ny04Y2RmNmY5MmZkY2MwMmZjZTY4YTUxYjc2NGQ5NTQxZDgzNDY5ZTFjMDIxMDJjNmM0NThmYWY5M2Q2MGQ1NWYyIn0=",
"challengewindowsize": "02",
"currencyiso3a": "GBP",
"customerip": "1.2.3.4",
"expirydate": "01/2038",
"merchantnumber": "9990000001",
"pan": "4900490000000501",
"requesttypedescription": "THREEDQUERY",
"sitereference": "test_3dsapi12345",
"termurl": "https://webhook.site/8543eb65-e5c7-40fc-a475-a862a825a562",
"threedscompind": "U",
"threedstransactionid":"733ab129-1126-4b80-97a4-f3d8fee9c564",
"useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.93 Safari/537.36"
}]
}

 

Visa hat die folgenden Hinweise zu diesem Mandat gegeben:

Konsistente und qualitativ hochwertige Daten tragen zu besseren Geschäftsergebnissen für Händler, Karteninhaber und Emittenten bei

Wenn Händler die Authentifizierung über Visa Secure nutzen, können sie sich darauf verlassen, dass Emittenten betrügerische Transaktionen erkennen. Die Schlüsseldaten in jeder AReq/THREEDQUERY -Nachricht sind entscheidend für eine genaue Risikobewertung der erfolgreichen Authentifizierung durch den Emittenten.

Wenn Händler die unten aufgeführten Felder in ihren AReq/THREEDQUERY Nachrichten bereitstellen, können die folgenden Vorteile im gesamten EMV 3DS-Ökosystem weltweit erzielt werden:

  • Die Erfolgsquote bei der Authentifizierung steigt um +4 % und die Genehmigungsquote um +6 %. (4,5)
  • Emittenten können eine Erhöhung der Betrugsaufdeckungsrate (FDR) um 65 % verzeichnen. (6)

Visa Secure wurde entwickelt, um ein reibungsloses Erlebnis für Visa Karteninhaber zu schaffen. Eine verbesserte Datenqualität kann den Karteninhabern ein nahtloseres Erlebnis, ein größeres Sicherheitsvertrauen und weniger falsche Ablehnungen bieten.

  • Karteninhaber erhalten ein besseres Erlebnis durch einen reibungslosen Tarifanstieg von +57 %. (5)

(4 ) Der Datensatz für diese Berechnungen enthält 95 % der weltweiten Visa Secure-Transaktionen, die in den Monaten Februar und März 2022 stattfanden. Die Uplift-Zahlen wurden von den Händlern auf der Grundlage der Rate, mit der sie die prioritären Datenelemente ausfüllen, und der Durchschnittswerte ihrer Produktleistung ermittelt. Weitere Informationen finden Sie in den globalen Geschäftsfällen im Global-Better Data Best Practices Guide für Visa Secure, der im Abschnitt Merchant Resources der Visa Secure Services Library verfügbar ist.
(5) Basierend auf Händlern, die mehr als 50 % der prioritären Datenelemente ausfüllen.
(6 ) Der Datensatz für diese Analyse enthält Visa globale Transaktionen, die im Monat August 2021 als Betrug gemeldet wurden. Der FDR-Leistungsanstieg wurde berechnet, indem die Leistung eines Visa Betrugserkennungsmodells in dem Szenario verglichen wurde, in dem prioritäre Datenelemente vorhanden waren, und in dem sie durch Null- oder Standardwerte ersetzt wurden, die im risikobasierten Authentifizierungsmodell (RBA) verwendet wurden.

 

Erforderliche Felder

Bitte stellen Sie sicher, dass Ihr System auf den neuesten Stand gebracht wird, um die folgende Feldspezifikation einzuhalten:

  Händler und Partner, die externe Zahlungsgateways und 3DS-Anbieter nutzen, müssen sich mit den von ihnen gewählten Zahlungsgateways und 3DS-Anbietern in Verbindung setzen, um zu erfahren, wie sie die Bereitstellung dieser Daten sicherstellen können.

Trust Payments
THREEDQUERY
Name des Feldes
Visa
AReq
Feldname
Anforderung Status Beschreibung
billingfirstname
XPath: /billing/name/first
Name des Karteninhabers Erforderlich (Browser / In-App) Der Kunde ist Rechnungsvorname.
billinglastname
XPath: /billing/name/last
Name des Karteninhabers Erforderlich (Browser / In-App) Der Kunde ist Rechnungsnachname.
billingemail
XPath: /billing/email
E-Mail Adresse des Karteninhabers Bedingt (Browser / In-App)

Die Adresse des Kunden Rechnungs-E-Mail .

Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Symbol).

Erforderlich, wenn billingtelephone nicht vorgelegt wird.

billingtelephone
XPath: /billing/telephone
Telefonnummer des Karteninhabers Bedingt (Browser / In-App)

Die Telefonnummer des Kunden. Gültige Zeichen:

  • Ziffern 0-9
  • Räume
  • Sonderzeichen: + - ( )

Erforderlich, wenn billingemail nicht vorgelegt wird.

customerip
XPath: /customer/ip
IP-Adresse des Browsers Erforderlich (Browser)

Payment Pages & JS Library: Trust Payments sammelt diese Daten und stellt sie zur Verfügung.

3DS API: Muss vom Händler oder Partner erhoben und bereitgestellt werden.

K.A. IP-Adresse des Geräts Erforderlich (In-App)

Gemeinsame Parameter zur Geräteidentifikation

Mobile SDK: Trust Payments sammelt und liefert diese Daten

browserscreenheight
XPath: /customer/browserscreenheight
Browser-Bildschirmhöhe Empfohlen (Browser)

Payment Pages & JS Library: Trust Payments sammelt diese Daten und stellt sie zur Verfügung.

3DS API: Muss vom Händler oder Partner erhoben und bereitgestellt werden.

browserscreenwidth
XPath: /customer/browserscreenwidth
Browser-Bildschirmbreite Empfohlen (Browser)

Payment Pages & JS Library: Trust Payments sammelt diese Daten und stellt sie zur Verfügung.

3DS API: Muss vom Händler oder Partner erhoben und bereitgestellt werden.

billingpremise
XPath: /billing/premise
K.A. Empfohlen Die erste Zeile der Rechnungsadresse des Kunden.
billingstreet
XPath: /billing/street
K.A. Empfohlen Die zweite Zeile der Rechnungsadresse des Kunden.
billingtown
XPath: /billing/town
K.A. Empfohlen Der Ort, der für die Rechnungsadresse des Kunden eingegeben wurde.
billingcounty
XPath: /billing/county
K.A. Empfohlen

Der Bezirk, der für die Rechnungsadresse des Kunden eingegeben wurde. Bei US-Adressen wird der Bundesstaat in dieses Feld eingegeben. Gültige Formate:

  • Bevorzugt: Zweistelliger Staatencode, z. B. "NY".
  • Vollständiger Name des Staates, z. B. "New York".
billingpostcode
XPath: /billing/postcode
K.A. Empfohlen Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für die eingereichte billingcountryiso2a handeln.
billingcountryiso2a
XPath: /billing/country
K.A. Empfohlen

Das Land, in dem die Rechnungsadresse des Kunden liegt. Diese muss im ISO2A-Format angegeben werden.

Klicken Sie hier für eine vollständige Liste der Ländercodes.

War dieser Artikel hilfreich?
0 von 0 Personen fanden dies hilfreich