3DS API Feld Spezifikation

  Zuletzt aktualisiert: 

 

THREEDLOOKUP Anfrage

Erforderlich Feld Format Länge Beschreibung
X1-EN.png requesttypedescription
XPath: /@type
Alpha

20

Sie müssen in diesem Feld "THREEDLOOKUP" eingeben.

X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha

20

Sie müssen in diesem Feld "ECOM" (E-Commerce) eingeben.

X1-EN.png baseamount
XPath: /billing/amount
Numerisch

13

Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. 10€ wird als 1000 übermittelt. Dieser Wert muss größer als Null sein. (Die maximale Länge kann je nach Bank variieren - wenden Sie sich für weitere Informationen an Ihre Bank)

X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha

3

Die Währung der Transaktion.

Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.

 

X1-EN.png expirydate
XPath: /billing/payment/expirydate
Datum MM/JJJJ

7

Das auf der Karte aufgedruckte Ablaufdatum.

X1-EN.png pan
XPath: /billing/payment/pan
Numerisch

12-19

Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.

X1-EN.png sitereference
XPath: /operation/sitereference
Alphanumerisch & Unterstrich

50

Identifiziert Ihre Website auf dem System Trust Payments .

Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

X3-EN.png applicationtype
XPath: /operation/applicationtype
Alpha

3

Geben Sie einen der folgenden unterstützten Werte an:

  • "APP" - Zahlung über eine mobile App.
  • "WAP" - Für browserbasierte Zahlungen.
X3-EN.png orderreference
XPath: /merchant/orderreference
Alphanumerisch einschließlich Symbole

25

Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann.

Empfohlene Länge 25 Zeichen oder weniger (genaue Länge abhängig von der erwerbenden Bank). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird.

X3-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha

20

Geben Sie einen der folgenden unterstützten Werte an:

  • "AMEX"
  • "DELTA"
  • "ELECTRON"
  • "MAESTRO"
  • "MASTERCARD"
  • "MASTERCARDDEBIT"
  • "PURCHASING"
  • "VISA"

 

THREEDLOOKUP Antwort

Erforderlich Field Format Länge Beschreibung
X4-EN.png requesttypedescription
XPath: /@type
Alpha

20

"THREEDLOOKUP" wird in der Antwort zurückgegeben.
X4-EN.png cachetoken
XPath: /operation/cachetoken
Alphanumerisch

64

Eindeutige Kennung, die die Kartendaten des Kunden im System von Trust Payment darstellt. Diese Kennung muss in der Anfrage THREEDQUERY (Schritt 3) enthalten sein. Sie ist 15 Minuten lang gültig, sobald die Antwort THREEDLOOKUP zurückgegeben wird.
X4-EN.png debtrepayment
XPath: /merchant/debtrepayment
Numerisch

1

Gibt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist:

  • 1 - Die Transaktion ist als Schuldentilgung gekennzeichnet.
  • 0 - Transaktion ist nicht als Schuldentilgung gekennzeichnet.
X4-EN.png errorcode
XPath: /error/code
Numerisch

1-5

Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht.
  • Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich.
  • Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich.

Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerten.

X4-EN.png errormessage
XPath: /error/message
Alphanumerisch

255

Hier finden Sie eine kurze Erklärung für die Fehlerursache.

Bei erfolgreichen Transaktionen wird dies als "Ok" zurückgegeben.

Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerten.

X4-EN.png maskedpan
XPath: /billing/payment/pan
Alphanumerisch einschließlich "#"

12-19

Das Feld maskedpan steht für die Kartennummer des Kunden, die zur Durchführung der Transaktion verwendet wurde. Der Wert des Feldes maskedpan Feldes ist in der Antwort maskiert. Der größte Teil der Nummer wird absichtlich durch "#"-Zeichen verdeckt, z. B. 411111######0211.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha

20

Es kann einer der folgenden Werte zurückgegeben werden:

  • "AMEX"
  • "DELTA"
  • "ELECTRON"
  • "MAESTRO"
  • "MASTERCARD"
  • "MASTERCARDDEBIT"
  • "PURCHASING"
  • "VISA"
X4-EN.png threednotificationurl
XPath: /threedsecure/notificationurl
URL

Nicht definiert

Dieses Feld wird bei der Authentifizierung von 3-D Secure Version 2 zurückgegeben. Es kann ignoriert werden, da Sie Ihr eigenes threednotificationurl definieren, das in Schritt 2 verwendet wird.

X4-EN.png threedstransactionid
XPath: /threedsecure/transactionid
Alphanumerisch mit Bindestrichen

36

Universell eindeutiger Transaktionsbezeichner, der vom 3DS-Server zugewiesen wird, um eine einzelne Transaktion zu identifizieren.
X4-EN.png threedversion
XPath: /threedsecure/version
Numerisch

6

Version von 3-D Secure , die zur Authentifizierung der Zahlung verwendet wird. (z. B. "2.2.0").

X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss

19

Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.
X2-EN.png errordata
XPath: /error/data
Alphanumerisch

255

Zusätzliche Informationen zur Behebung des Fehlers.

Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.

X2-EN.png threedmethodurl
XPath: /threedsecure/methodurl
URL

Nicht definiert

URL, an die Ihr 3D-Server ein HTTPS POST als Teil des kommenden Schritts 2 (Methoden-URL) sendet. Diese URL wird vom ACS bereitgestellt.

Wenn threedmethodurl nicht zurückgegeben wird, aber threedversion mit dem Wert 2.2.0 oder höher zurückgegeben wird, fahren Sie mit Schritt 3 (3-D-Abfrage) fort.

 

THREEDQUERY Anfrage

Erforderlich Field Format Länge Beschreibung
X1-EN.png requesttypedescription
XPath: /@type
Alpha

20

Sie müssen in diesem Feld "THREEDQUERY" eingeben.

X1-EN.png accept
XPath: /customer/accept
Alphanumerisch

1024

Der genaue Inhalt des HTTP-Accept-Header-Feldes, wie er vom User-Agent des Karteninhabers empfangen wurde.

X1-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha

20

Geben Sie "ECOM" (E-Commerce) in dieses Feld ein.
X1-EN.png acquirerbin
XPath: /acquirer/acquirerbin
Alphanumerisch

11

Wenn Sie ein Trust Payments (UK/FCA) Acquiring-Konto verwenden, geben Sie einen der folgenden Werte an:

  • "456896" - Visa
  • "271708" - Mastercard
  • "10000000232" - American Express

Wenn Sie ein Trust Payments (Malta) Acquiring-Konto verwenden, geben Sie einen der folgenden Werte an:

  • "408912" - Visa
  • "529786" - Mastercard
  • "10000000232" - American Express

  Verwenden Sie die oben genannten BINs nur, wenn Sie die Anfrage Autorisierung über das TRU Connect Gateway bearbeiten. Bei anderen Acquirern/Gateways wenden Sie sich bitte an diese, um die korrekte BIN zu bestätigen.
X1-EN.png baseamount
XPath: /billing/amount
Numerisch

13

Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. 10€ wird als 1000 übermittelt. Dieser Wert muss größer als Null sein. (Die maximale Länge kann je nach Bank variieren - wenden Sie sich für weitere Informationen an Ihre Bank)
X1-EN.png browsercolordepth
XPath: /customer/browsercolordepth
Numerisch

2

Wert, der die Bittiefe der Farbpalette für die Anzeige von Bildern in Bits pro Pixel angibt.

Akzeptierte Werte:

  • 1
  • 4
  • 8
  • 15
  • 16
  • 24
  • 32
  • 48
X1-EN.png browserjavaenabled
XPath: /customer/browserjavaenabled
Boolesche

5

Ob der Browser des Kunden Java ausführen kann oder nicht.

Akzeptierte Werte: true, false.

X1-EN.png browserjavascriptenabled
XPath: /customer/browserjavascriptenabled
Boolesche

5

Ob der Browser des Kunden JavaScript ausführen kann oder nicht.

Akzeptierte Werte: true, false.

X1-EN.png browserlanguage
XPath: /customer/browserlanguage
Alpha

8

Wert, der die Browsersprache gemäß der Definition in IETF BCP47 darstellt.

X1-EN.png browserscreenheight
XPath: /customer/browserscreenheight
Numerisch

6

Gesamthöhe des Bildschirms des Kunden in Pixeln.

Erforderlich für Visa Secure Data Field Mandate.

X1-EN.png browserscreenwidth
XPath: /customer/browserscreenwidth
Numerisch

6

Gesamtbreite des Bildschirms des Kunden in Pixeln.

Erforderlich für Visa Secure Data Field Mandate.

X1-EN.png browsertz
XPath: /customer/browsertz
Numerisch

5

Zeitzonenabweichung in Minuten zwischen UTC und der Ortszeit des Kundenbrowsers.

Beachten Sie, dass der Offset positiv ist, wenn die lokale Zeitzone hinter UTC liegt, und negativ, wenn sie vor UTC liegt.

z.B. Wenn UTC -5 Stunden: 300 oder +300

z.B. Wenn UTC +5 Stunden: -300

X1-EN.png cachetoken
XPath: /operation/cachetoken
Alphanumerisch

64

Eindeutige Kennung, die die Kartendaten des Kunden im System von Trust Payment darstellt. Sie ist 15 Minuten lang gültig, sobald die Antwort THREEDLOOKUP zurückgegeben wird.

Diese wird Ihnen in der Antwort THREEDLOOKUP (Schritt 1) zurückgegeben.

X1-EN.png

challengewindowsize
XPath: /customer/challengewindowsize

Numerisch

2

Größe des Pop-up-Fensters für die Step-up-Authentifizierung.

Akzeptierte Werte:

  • 01 - Für 250x400
  • 02 - Für 390x400
  • 03 - Für 500x600
  • 04 - Für 600x400
  • 05 - Für Vollbild
X1-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha

3

Die Währung der Transaktion.

Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.

X1-EN.png customerip
XPath: /customer/ip
IP-Adresse

39

Die IP des Kunden.

Erforderlich für Visa Secure Data Field Mandate.

X1-EN.png expirydate
XPath: /billing/payment/expirydate
Datum MM/JJJJ

7

Das auf der Karte aufgedruckte Ablaufdatum.
X1-EN.png pan
XPath: /billing/payment/pan
Numerisch

12-19

Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
X1-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha

20

Geben Sie einen der folgenden unterstützten Werte an:

  • "AMEX"
  • "DELTA"
  • "ELECTRON"
  • "MAESTRO"
  • "MASTERCARD"
  • "MASTERCARDDEBIT"
  • "PURCHASING"
  • "VISA"
X1-EN.png sitereference
XPath: /operation/sitereference
Alphanumerisch
& Unterstrich

50

Identifiziert Ihre Website auf dem System Trust Payments .

Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

X1-EN.png termurl
XPath: /merchant/termurl
URL

1024

Diese URL wird verwendet, um dem Kartenaussteller mitzuteilen, wohin der Browser des Kunden geschickt werden soll, nachdem er sich am ACS des Kartenausstellers authentifiziert hat (für die Step-up-Authentifizierung).
X1-EN.png threedscompind
XPath: /threedsecure/threedscompind
Char

1

Zeigt an, ob die 3DS-Methode erfolgreich abgeschlossen wurde.

Akzeptierte Werte:

  • Y - Senden Sie Y, wenn Schritt 2 (Methode URL) erfolgreich abgeschlossen wurde.
  • N - N einreichen, wenn threedmethodurl und threednotificationurl waren in THREEDLOOKUP zurückgegeben wurden, aber Schritt 2 (Methoden-URL) übersprungen wurde.
  • U - U einreichen, wenn threedmethodurl wurde nicht in THREEDLOOKUP zurückgegeben.
X1-EN.png threedstransactionid
XPath: /threedsecure/transactionid
Alphanumerisch mit Bindestrichen

36

Universell eindeutiger Transaktionsbezeichner, der vom 3DS-Server zugewiesen wird, um eine einzelne Transaktion zu identifizieren.

Diese wird Ihnen in der Antwort THREEDLOOKUP (Schritt 1) zurückgegeben.

X1-EN.png useragent
XPath: /customer/useragent
Alphanumerisch

2048

Genauer Inhalt des HTTP-User-Agent-Headers. Wenn die übermittelte Länge die maximale Länge von 2048 überschreitet, schneidet der Server 3-D Secure den überzähligen Teil ab.
X2-EN.png billingemail
XPath: /abrechnung/email
E-Mail

255

Die Adresse Rechnungs-E-Mail . Diese kann dann für die Korrespondenz mit dem Kunden verwendet werden. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Zeichen).

Erforderlich für Visa Secure Data Field Mandate, wenn billingtelephone nicht angegeben ist.

X2-EN.png billingfirstname
XPath: /abrechnung/name/erste
Alphanumerisch einschließlich Symbole

127

Die Rechnungsvorname.

Erforderlich für Visa Secure Data Field Mandate.

X2-EN.png billinglastname
XPath: /abrechnung/name/last
Alphanumerisch einschließlich Symbole

127

Die Rechnungsnachname.

Erforderlich für Visa Secure Data Field Mandate.

X2-EN.png billingtelephone
XPath: /abrechnung/telefon
Alphanumerisch einschließlich
Symbole

20

Die Telefonnummer für die Rechnungsstellung. Gültige Zeichen:
  • Ziffern 0-9
  • Räume
  • Sonderzeichen: + - ( )

Erforderlich für Visa Secure Data Field Mandate, wenn billingemail nicht angegeben ist.

X3-EN.png billingprefixname
XPath: /abrechnung/name/präfix
Alphanumerisch einschließlich
Symbole

25

Das Präfix des Rechnungsnamens, aus der folgenden Liste: Herr, Frau, Dr., Prof., Hochwürden, Sir, Lord, Lady, Dame & Mx.
X3-EN.png billingmiddlename
XPath: /abrechnung/name/mittelpunkt
Alphanumerisch einschließlich
Symbole

127

Der mittlere Name der Rechnung.
X3-EN.png billingsuffixname
XPath: /abrechnung/name/suffix
Alphanumerisch

25

Der Name des Rechnungssuffixes.
X3-EN.png billingpremise
XPath: /abrechnung/premise
Alphanumerisch einschließlich
Symbole

25

Die Hausnummer oder die erste Zeile der Rechnungsadresse.
X3-EN.png billingstreet
XPath: /Rechnung/Straße
Alphanumerisch einschließlich
Symbole

127

Die für die Rechnungsadresse eingegebene Straße.
X3-EN.png billingtown
XPath: /abrechnung/stadt
Alphanumerisch einschließlich
Symbole

127

Die für die Rechnungsadresse eingegebene Stadt.
X3-EN.png billingcounty
XPath: /abrechnung/landkreis
Alphanumerisch einschließlich
Symbole

127

Der für die Rechnungsadresse eingegebene Bezirk.

Dies wird angezeigt als "State code (eg. NY)” auf Seiten mit dem Gebietsschema "us_US".

Bei US-Adressen wird der Bundesstaat in dieses Feld eingegeben.

Gültige Formate:

  • Bevorzugt: Zweistelliger Staatencode, z. B. "NY".
  • Vollständiger Name des Staates (keine Abkürzungen), z. B. "New York".
X3-EN.png billingpostcode
XPath: /abrechnung/postleitzahl
Alphanumerisch

25

Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a eingereicht werden.
X3-EN.png billingcountryiso2a
XPath: /abrechnung/land
Alpha

2

Das für die Rechnungsadresse eingegebene Land im ISO2A-Format.
X3-EN.png billingtelephonetype
XPath: /abrechnung/telefon/@type
Char

1

Der Typ der eingegebenen Telefonnummer. Die verfügbaren Optionen sind:
  • H = Heim
  • M = Handy
  • W = Arbeit
X3-EN.png merchantcountryiso2a*
XPath: /merchant/merchantcountryiso2a
Alpha

2

Ländercode, der mit Ihrem Konto verknüpft ist.

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

Die angegebenen Informationen müssen mit den Informationen übereinstimmen, die für die Registrierung des Kontos auf Visa und Mastercard für die Authentifizierung auf 3-D Secure verwendet wurden.

X3-EN.png merchantcategorycode*
XPath: /merchant/merchantcategorycode
Numerisch

4

Dient zur Klassifizierung der Art der von Ihrem Unternehmen angebotenen Waren und Dienstleistungen.

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

Die angegebenen Informationen müssen mit den Informationen übereinstimmen, die für die Registrierung des Kontos auf Visa und Mastercard für die Authentifizierung auf 3-D Secure verwendet wurden.

X3-EN.png merchantname*
XPath: /merchant/merchantname
Alphanumerisch

255

Name, der mit Ihrem Konto bei Trust Payments verbunden ist.

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

Die angegebenen Informationen müssen mit den Informationen übereinstimmen, die für die Registrierung des Kontos auf Visa und Mastercard für die Authentifizierung auf 3-D Secure verwendet wurden.

X3-EN.png merchantnumber*
XPath: /merchant/merchantnumber
Alphanumerisch

32

Die Händlernummer, die zur Bearbeitung der Transaktion verwendet wurde. Wird von der erwerbenden Bank zur Verfügung gestellt.

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

Die angegebenen Informationen müssen mit den Informationen übereinstimmen, die für die Registrierung des Kontos auf Visa und Mastercard für die Authentifizierung auf 3-D Secure verwendet wurden.

X3-EN.png orderreference
XPath: /merchant/orderreference
Alphanumerisch einschließlich
Symbole

25

Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann.

Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.

X3-EN.png requestorurl*
XPath: /merchant/requestorurl
URL

2048

Vollständig qualifizierte URL der Website des 3DS-Antragstellers oder der Kundenbetreuungsseite. Dieses Datenelement liefert dem empfangenden System 3-D Secure zusätzliche Informationen, wenn ein Problem auftritt, und sollte Kontaktinformationen enthalten.

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

X3-EN.png trustpaymentsrequestoridmastercard*
XPath: /merchant/trustpaymentsrequestoridmastercard
Alphanumerisch

26

Das Präfix "TRU93918" für den Antragsteller, gefolgt von "_", und dann die Händlerkennung (MID).
Beispiel: "TRU93918_9991111111"

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

Die angegebene Händlerkennung (MID) muss mit den Informationen übereinstimmen, die zur Registrierung des Kontos auf Visa und Mastercard für die Authentifizierung auf 3-D Secure verwendet wurden.

X3-EN.png trustpaymentsrequestoridvisa*
XPath: /merchant/trustpaymentsrequestoridvisa
Alphanumerisch

26

In unserer Testumgebung muss Ihr System das Präfix "11111111" für die Antragsteller-ID, gefolgt von einem "*", und dann die Händlerkennung (MID) übermitteln.

Beispiel: "11111111*9991111111"

In einer Live-Umgebung wäre dies die Visa Bank id (BID) des Acquirers, gefolgt von einem "*", und dann die MID, die vom Acquirer des Händlers bereitgestellt wird.

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

Die angegebene Händlerkennung (MID) muss mit den Informationen übereinstimmen, die zur Registrierung des Kontos auf Visa und Mastercard für die Authentifizierung auf 3-D Secure verwendet wurden.

X3-EN.png trustpaymentsrequestornamemastercard*
XPath: /merchant/trustpaymentsrequestornamemastercard
Alphanumerisch

40

Trust Payments zugewiesenen 3DS-Anfragenamen für Mastercard, im folgenden Format:

3DS Servername+"_"+Name des Händlers

z.B. "TrustPayments_Handelsname"

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

Die angegebenen Name des Händlers müssen mit den Informationen übereinstimmen, die für die Registrierung des Kontos bei Visa und Mastercard für die Authentifizierung bei 3-D Secure verwendet wurden.

X3-EN.png trustpaymentsrequestornamevisa*
XPath: /merchant/trustpaymentsrequestornamevisa
Alphanumerisch

40

Name des Händlers die Sie definieren.

z.B. "Test Merchant1 Ltd"

Wenn keine Angaben gemacht werden, werden standardmäßig die in unseren Datensätzen gespeicherten Daten verwendet. Andernfalls können Sie dieses Feld übermitteln, um diesen Wert für jede einzelne Anfrage zu überschreiben.

Die angegebenen Name des Händlers müssen mit den Informationen übereinstimmen, die für die Registrierung des Kontos bei Visa und Mastercard für die Authentifizierung bei 3-D Secure verwendet wurden.

*Wenn eines der folgenden optionalen Felder in der Anfrage THREEDQUERY angegeben wird, müssen Sie Werte für alle Felder angeben.

  • merchantcategorycode
  • merchantcountryiso2a
  • merchantname
  • merchantnumber
  • trustpaymentsrequestoridmastercard
  • trustpaymentsrequestoridvisa
  • trustpaymentsrequestornamemastercard
  • trustpaymentsrequestornamevisa
  • requestorurl

 

THREEDQUERY Antwort

Erforderlich Field Format Länge Beschreibung
X4-EN.png requesttypedescription
XPath: /@type
Alpha

20

"THREEDQUERY" wird in der Antwort zurückgegeben.
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha

20

In der Antwort wird "ECOM" (e-commerce) zurückgegeben.
X4-EN.png acsreferencenumber
XPath: /threedsecure/acsreferencenumber
Alphanumerisch

32

Eindeutige Kennung, die dem ACS zugewiesen wurde.
X4-EN.png acstransid
XPath: /threedsecure/acstransid
Alphanumerisch

36

Eindeutiger Bezeichner der Transaktion innerhalb des ACS-Systems.
X4-EN.png debtrepayment
XPath: /merchant/debtrepayment
Numerisch

1

Gibt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist:

  • 1 - Die Transaktion ist als Schuldentilgung gekennzeichnet.
  • 0 - Transaktion ist nicht als Schuldentilgung gekennzeichnet.
X4-EN.png enrolled
XPath: /threedsecure/enrolled
Char

1

Der Zulassungsstatus der Zahlungskarte:

  • Y - Die Karte des Kunden ist registriert.
  • N - Die Karte des Kunden ist nicht registriert.
  • U - Es kann nicht festgestellt werden, ob die Karte registriert ist.
  • B - Die Authentifizierungsregel des Händlers wird ausgelöst, um die Authentifizierung in diesem Anwendungsfall zu umgehen.
X4-EN.png errorcode
XPath: /error/code
Numerisch

1-5

Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht.
  • Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich.
  • Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich.

Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerten.

X4-EN.png errormessage
XPath: /error/message
Alphanumerisch

255

Hier finden Sie eine kurze Erklärung für die Fehlerursache.

Bei erfolgreichen Transaktionen wird dies als "Ok" zurückgegeben.

Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerten.

X4-EN.png issuer
XPath: /payment/issuer
Alphanumerisch

255

Der Kartenaussteller des Kunden.
X4-EN.png issuercountryiso2a
XPath: /billing/payment/issuercountry
Alpha

2

Das Land, in dem der Kartenaussteller des Kunden ansässig ist.
Es wird im ISO2A-Format angegeben.

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

X4-EN.png livestatus
XPath: /live
Numerisch

1

  • 0 - Die Transaktion wurde über ein Testkonto abgewickelt.
  • 1 - Transaktion wird über ein Live-Konto abgewickelt.
X4-EN.png maskedpan
XPath: /billing/payment/pan
Alphanumerisch einschließlich "#"

12-19

Das Feld maskedpan steht für die eindeutige Token-Nummer des Kunden, die zur Durchführung der Transaktion verwendet wird. Der Wert des Feldes maskedpan Feldes ist in der Antwort maskiert. Der größte Teil der Nummer wird absichtlich durch "#"-Zeichen verdeckt, z. B. 411111######0211.

X4-EN.png merchantcategorycode
XPath: /merchant/merchantcategorycode
Alphanumerisch

255

Dies ist die Kunden Categorie Nummer (MCC), die mit dem in der Anfrage definierten Konto verbunden ist.

Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.

X4-EN.png merchantcountryiso2a
XPath: /merchant/merchantcountryiso2a
Alpha

2

Dies ist das Land des Händlers, das mit dem in der Anfrage definierten Konto verbunden ist.

Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.

X4-EN.png merchantname
XPath: /merchant/merchantname
Alphanumerisch

255

Dies ist die Name des Händlers , die mit dem in der Anfrage definierten Konto verbunden ist.

Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.

X4-EN.png merchantnumber
XPath: /merchant/merchantnumber
Alphanumerisch

32

Dies ist die Händlernummer, die mit dem in der Anfrage definierten Konto verbunden ist.

Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.

X4-EN.png operatorname
XPath: /merchant/operatorname
Alphanumeirc

255

Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha

20

Es kann einer der folgenden Werte zurückgegeben werden:

  • "AMEX"
  • "DELTA"
  • "ELECTRON"
  • "MAESTRO"
  • "MASTERCARD"
  • "MASTERCARDDEBIT"
  • "PURCHASING"
  • "VISA"
X4-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-TT

10

Das Datum, an dem die Transaktion abgewickelt wird, wenn die nachfolgende Zahlung über das Gateway TRU Connect abgewickelt wird, es sei denn, es wird in AUTH überschrieben.
X4-EN.png settlestatus
XPath: /settlement/settlestatus
Numerisch

3

Dies ist der zugewiesene settlestatus Wert für den Fall, dass die nachfolgende Zahlung über das Gateway TRU Connect abgewickelt wird, es sei denn, er wird in der AUTH überschrieben. Um mehr über settlestatus zu erfahren, klicken Sie hier.

X4-EN.png status
XPath: /threedsecure/status
Char

1

Zeigt an, ob der Kunde im ACS des Kartenausstellers authentifiziert wurde oder nicht:
  • Y - Kunde authentifiziert. Die für die Bearbeitung einer Transaktion erforderlichen Informationen sind in dieser Antwort enthalten. Sie können direkt mit Schritt 5 fortfahren, um die THREEDRESULT Anfrage zu bearbeiten.
  • A - Die Authentifizierung wurde versucht, konnte aber nicht abgeschlossen werden. Sie können direkt mit Schritt 5 fortfahren, um die THREEDRESULT Anfrage zu bearbeiten, aber beachten Sie bitte, dass die Haftpflichtschicht möglicherweise nicht verfügbar ist.
  • U - Die Authentifizierung kann nicht durchgeführt werden. Die Haftungsverschiebung tritt nicht in Kraft. Wenn Sie fortfahren möchten, fahren Sie mit Schritt 5 fort, um den Antrag THREEDRESULT zu bearbeiten.
  • N - Die Authentifizierung war nicht erfolgreich. Sie dürfen nicht mit der Zahlung fortfahren.
  • C - Herausforderung für die Authentifizierung erforderlich. Fahren Sie mit Schritt 4 fort und schließen Sie die Step-up-Authentifizierung ab.
  • R - Die Authentifizierung wurde abgelehnt. Sie dürfen nicht mit der Zahlung fortfahren.
X4-EN.png threedsservertransid
XPath: /threedsecure/threedsservertransid
Alphanumerisch

36

Universell eindeutige Transaktionskennung, die dem Server 3-D Secure zugewiesen wird, um eine einzelne Transaktion zu identifizieren.
X4-EN.png threedversion
XPath: /threedsecure/version
Numerisch

6

Version von 3-D Secure , die zur Authentifizierung der Zahlung verwendet wird. (z.B. "2.2.0")

X4-EN.png transactionreference
XPath: /transactionreference
Alphanumerisch mit Bindestrichen

25

Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird. Sie benötigen diese Referenz, um eine Erstattung durchzuführen oder die Transaktion zu aktualisieren.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss

19

Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.
X2-EN.png acquirerresponsecode
XPath: /acquirerresponsecode
Numerisch

255

Enthält Informationen über Fehler, die während des Prozesses 3-D Secure zurückgegeben wurden.

Wird nur im Falle eines Fehlers zurückgegeben

X2-EN.png acquirerresponsemessage
XPath: /acquirerresponsemessage
Alphanumerisch

255

Enthält Informationen über Fehler, die während des Prozesses 3-D Secure zurückgegeben wurden.

Wird nur im Falle eines Fehlers zurückgegeben

X2-EN.png acsurl
XPath: /threedsecure/acsurl
URL

1024

Wird nur zurückgegeben, wenn der Status C ist (was eine Herausforderung bedeutet).

Der Browser des Kunden muss im Rahmen von Schritt 4 (Step-up-Authentifizierung) auf diese URL umgeleitet werden.

X2-EN.png errordata
XPath: /error/data
Alphanumerisch

255

Zusätzliche Informationen zur Behebung des Fehlers.

Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.

X2-EN.png orderreference
XPath: /merchant/orderreference
Alphanumerisch einschließlich Symbole

25

Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann.

Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.

X2-EN.png threedpayload
XPath: /threedsecure/threedpayload
Base64-kodiert payload

K.A.

Wird nur zurückgegeben, wenn der Status C ist (was eine Herausforderung bedeutet).

Enthält Informationen über die Benutzeroberfläche für die Herausforderung. Wird als Teil von Schritt 4 (Step-up-Authentifizierung) an das ACS weitergegeben.

Der Wert des threedpayload ist der für Schritt 4 (Herausforderung) erforderliche Creq.

 

THREEDRESULT Anfrage

Erforderlich Field Format Länge Beschreibung
X1-EN.png parenttransactionreference
XPath: /operation/parenttransactionreference
Alphanumerisch
& Bindestriche

25

Sie müssen den transactionreference Wert, der in der Antwort THREEDQUERY zurückgegeben wird.
X1-EN.png requesttypedescription
XPath: /@type
Alpha

20

Sie müssen in diesem Feld "THREEDRESULT" eingeben.
X1-EN.png sitereference
XPath: /operation/sitereference
Alphanumerisch

50

Identifiziert Ihre Website auf dem System Trust Payments .

Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.

 

THREEDRESULT Antwort

Erforderlich Field Format Länge Beschreibung
X4-EN.png requesttypedescription
XPath: /@type
Alpha

20

"THREEDRESULT" wird in der Antwort zurückgegeben.
X4-EN.png accounttypedescription
XPath: /operation/accounttypedescription
Alpha

20

In der Antwort wird "ECOM" (e-commerce) zurückgegeben.
X4-EN.png baseamount
XPath: /billing/amount
Numerisch

13

Der Betrag der Transaktion in Basiseinheiten, wie in der Anfrage angegeben, ohne Kommas oder Dezimalpunkte, d.h. €10 wird als 1000 angegeben. (Die maximale Länge kann je nach Bank variieren - für weitere Informationen wenden Sie sich an Ihre Bank)

X4-EN.png cavv
XPath: /threedsecure/cavv
Alphanumerisch

56

Die eindeutige Cardholder Authentication Verification Value (CAVV), die mit der Transaktion verbunden ist.
X4-EN.png currencyiso3a
XPath: /billing/amount/@currencycode
Alpha

3

Die Währung der Transaktion.

Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.

X4-EN.png debtrepayment
XPath: /merchant/debtrepayment
Numerisch

1

Gibt an, ob die Transaktion als Schuldentilgung gekennzeichnet ist:

  • 1 - Die Transaktion ist als Schuldentilgung gekennzeichnet.
  • 0 - Transaktion ist nicht als Schuldentilgung gekennzeichnet.
X4-EN.png eci
XPath: /threedsecure/eci
Alphanumerisch

2

Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator). Klicken Sie hier, um mehr über die möglichen ECI Werte zu erfahren.
X4-EN.png enrolled
XPath: /threedsecure/enrolled
Char

1

Der Zulassungsstatus der Zahlungskarte:

  • Y - Die Karte des Kunden ist registriert.
  • N - Die Karte des Kunden ist nicht registriert.
  • U - Es kann nicht festgestellt werden, ob die Karte registriert ist.
  • B - Die Authentifizierungsregel des Händlers wird ausgelöst, um die Authentifizierung in diesem Anwendungsfall zu umgehen.
X4-EN.png errorcode
XPath: /error/code
Numerisch

1-5

Die Fehlercode (errorcode) sollte verwendet werden, um festzustellen, ob die Anfrage erfolgreich war oder nicht.
  • Wenn die Fehlercode "0" ist, war die Transaktion erfolgreich.
  • Wenn die Fehlercode nicht "0" ist, war die Transaktion nicht erfolgreich.

Klicken Sie hier, um eine vollständige Liste der errorcode und der Nachrichtenwerte zu erhalten.

X4-EN.png errormessage
XPath: /error/message
Alphanumerisch

255

Hier finden Sie eine kurze Erklärung für die Fehlerursache.

Bei erfolgreichen Transaktionen wird dies als "Ok" zurückgegeben.

Klicken Sie hier, um eine vollständige Liste der errorcode und der Nachrichtenwerte zu erhalten.

X4-EN.png issuer
XPath: /billing/payment/issuer
Alphanumerisch

255

Der Kartenaussteller des Kunden.
X4-EN.png issuercountryiso2a
XPath: /billing/payment/issuercountry
Alpha

2

Das Land, in dem der Kartenaussteller des Kunden ansässig ist.
Es wird im ISO2A-Format angegeben.

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

X4-EN.png livestatus
XPath: /live
Numerisch

1

  • 0 - Die Transaktion wurde über ein Testkonto abgewickelt.
  • 1 - Transaktion wird über ein Live-Konto abgewickelt.
X4-EN.png maskedpan
XPath: /billing/payment/pan
Alphanumerisch einschließlich "#"

12-19

Das Feld maskedpan steht für die eindeutige Token-Nummer des Kunden, die zur Durchführung der Transaktion verwendet wird. Der Wert des Feldes maskedpan Feldes ist in der Antwort maskiert. Der größte Teil der Nummer wird absichtlich durch "#"-Zeichen verdeckt, z. B. 411111######0211.

X4-EN.png merchantcategorycode
XPath: /merchant/merchantcategorycode
Alphanumerisch

255

Dies ist die Kunden Categorie Nummer (MCC), die mit dem in der Anfrage definierten Konto verbunden ist.

Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.

X4-EN.png merchantcountryiso2a
XPath: /merchant/merchantcountryiso2a
Alpha

2

Dies ist das Land des Händlers, das mit dem in der Anfrage definierten Konto verbunden ist.

Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.

X4-EN.png merchantname
XPath: /merchant/merchantname
Alphanumerisch

255

Dies ist die Name des Händlers , die mit dem in der Anfrage definierten Konto verbunden ist.

Die zurückgegebenen Werte hängen von der Konfiguration Ihres Kontos ab.

X4-EN.png merchantnumber
XPath: /merchant/merchantnumber
Alphanumerisch

32

Die Händlernummer, die zur Bearbeitung der Anfrage verwendet wurde. Wird von der erwerbenden Bank zur Verfügung gestellt.
X4-EN.png operatorname
XPath: /merchant/operatorname
Alphanumerisch

255

Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
X4-EN.png parenttransactionreference
XPath: /operation/parenttransactionreference
Alphanumerisch
& Bindestriche

25

Der zurückgegebene Wert entspricht dem parenttransactionreference in der Anfrage THREEDRESULT enthalten.
X4-EN.png paymenttypedescription
XPath: /billing/payment/@type
Alpha

20

Es kann einer der folgenden Werte zurückgegeben werden:

  • "AMEX"
  • "DELTA"
  • "ELECTRON"
  • "MAESTRO"
  • "MASTERCARD"
  • "MASTERCARDDEBIT"
  • "PURCHASING"
  • "VISA"
X4-EN.png settleduedate
XPath: /settlement/settleduedate
Datum JJJJ-MM-TT

10

Das Datum, an dem die Transaktion abgewickelt wird, wenn die nachfolgende Zahlung über das Gateway TRU Connect abgewickelt wird, es sei denn, es wird in AUTH überschrieben.
X4-EN.png status
XPath: /threedsecure/status
Char

1

Zeigt an, ob der Kunde im ACS des Kartenausstellers authentifiziert wurde oder nicht:
  • Y - Kunde authentifiziert. Sie können mit Schritt 6 (Autorisierung) fortfahren und eine Zahlung anhand der in dieser Antwort zurückgegebenen Felder verarbeiten.
  • A - Die Authentifizierung wurde versucht, konnte aber nicht abgeschlossen werden. Sie können mit Schritt 6 (Autorisierung) fortfahren und eine Zahlung unter Verwendung der in dieser Antwort zurückgegebenen Felder abwickeln, aber bitte beachten Sie, dass die Haftungsverlagerung möglicherweise nicht verfügbar ist.
  • U - Die Authentifizierung kann nicht durchgeführt werden. Sie können die Zahlung abwickeln, aber die Haftungsverlagerung wird nicht wirksam.
  • N - Die Authentifizierung war nicht erfolgreich. Sie dürfen nicht mit der Zahlung fortfahren.
  • R - Die Authentifizierung wurde abgelehnt. Sie dürfen nicht mit der Zahlung fortfahren.
X4-EN.png threeddirectorytransactionreference
XPath: /threedsecure/directorytransactionreference
Alphanumerisch

48

Einzigartige DSTransactionId von Ihrem MPI Anbieter zurückgegeben.
X4-EN.png threedversion
XPath: /threedsecure/version
Numerisch

6

Version von 3-D Secure , die zur Authentifizierung der Zahlung verwendet wird. (z.B. "2.2.0")
X4-EN.png transactionreference
XPath: /transactionreference
Alphanumerisch einschließlich
Bindestriche

25

Eine eindeutige Referenz für die Transaktion, die von Trust Payments zugewiesen wird. Sie benötigen diese Referenz, um eine Erstattung durchzuführen oder die Transaktion zu aktualisieren.
X4-EN.png transactionstartedtimestamp
XPath: /timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss

19

Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
X2-EN.png errordata
XPath: /error/data
Alphanumerisch

255

Zusätzliche Informationen zur Behebung des Fehlers.

Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.

X2-EN.png orderreference
XPath: /merchant/orderreference
Alphanumerisch einschließlich
Symbole (25)

25

Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann.

Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.

 

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