3DS API Feld Spezifikation

THREEDLOOKUP Anfrage

Erforderlich	Feld	Format	Länge	Beschreibung
	requesttypedescription XPath: /@type	Alpha	20	Sie müssen in diesem Feld "THREEDLOOKUP" eingeben.
	accounttypedescription XPath: /operation/accounttypedescription	Alpha	20	Sie müssen in diesem Feld "ECOM" (E-Commerce) eingeben.
	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)
	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.
	expirydate XPath: /billing/payment/expirydate	Datum MM/JJJJ	7	Das auf der Karte aufgedruckte Ablaufdatum.
	pan XPath: /billing/payment/pan	Numerisch	12-19	Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
	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.
	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.
	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.
	paymenttypedescription XPath: /billing/payment/@type	Alpha	20	Geben Sie einen der folgenden unterstützten Werte an: "AMEX" "DELTA" "DINERS" "DISCOVER" "ELECTRON" "MAESTRO" "MASTERCARD" "MASTERCARDDEBIT" "PURCHASING" "VISA"

THREEDLOOKUP Antwort

Erforderlich	Field	Format	Länge	Beschreibung
	requesttypedescription XPath: /@type	Alpha	20	"THREEDLOOKUP" wird in der Antwort zurückgegeben.
	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.
	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.
	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.
	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.
	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.
	paymenttypedescription XPath: /billing/payment/@type	Alpha	20	Es kann einer der folgenden Werte zurückgegeben werden: "AMEX" "DELTA" "DINERS" "DISCOVER" "ELECTRON" "MAESTRO" "MASTERCARD" "MASTERCARDDEBIT" "PURCHASING" "VISA"
	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.
	threedstransactionid XPath: /threedsecure/transactionid	Alphanumerisch mit Bindestrichen	36	Universell eindeutiger Transaktionsbezeichner, der vom 3DS-Server zugewiesen wird, um eine einzelne Transaktion zu identifizieren.
	threedversion XPath: /threedsecure/version	Numerisch	6	Version von 3-D Secure , die zur Authentifizierung der Zahlung verwendet wird. (z. B. "2.2.0").
	transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	19	Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.
	errordata XPath: /error/data	Alphanumerisch	255	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
	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
	requesttypedescription XPath: /@type	Alpha	20	Sie müssen in diesem Feld "THREEDQUERY" eingeben.
	accept XPath: /customer/accept	Alphanumerisch	1024	Der genaue Inhalt des HTTP-Accept-Header-Feldes, wie er vom User-Agent des Karteninhabers empfangen wurde.
	accounttypedescription XPath: /operation/accounttypedescription	Alpha	20	Geben Sie "ECOM" (E-Commerce) in dieses Feld ein.
	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 "367636" - Diners/Entdecken Wenn Sie ein Trust Payments (Malta) Acquiring-Konto verwenden, geben Sie einen der folgenden Werte an: "408912" - Visa "529786" - Mastercard "10000000232" - American Express "367631" - Diners/Entdecken 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.
	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)
	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
	browserjavaenabled XPath: /customer/browserjavaenabled	Boolesche	5	Ob der Browser des Kunden Java ausführen kann oder nicht. Akzeptierte Werte: true, false.
	browserjavascriptenabled XPath: /customer/browserjavascriptenabled	Boolesche	5	Ob der Browser des Kunden JavaScript ausführen kann oder nicht. Akzeptierte Werte: true, false.
	browserlanguage XPath: /customer/browserlanguage	Alpha	8	Wert, der die Browsersprache gemäß der Definition in IETF BCP47 darstellt.
	browserscreenheight XPath: /customer/browserscreenheight	Numerisch	6	Gesamthöhe des Bildschirms des Kunden in Pixeln. Erforderlich für Visa Secure Data Field Mandate.
	browserscreenwidth XPath: /customer/browserscreenwidth	Numerisch	6	Gesamtbreite des Bildschirms des Kunden in Pixeln. Erforderlich für Visa Secure Data Field Mandate.
	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
	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.
	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
	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.
	customerip XPath: /customer/ip	IP-Adresse	39	Die IP des Kunden. Erforderlich für Visa Secure Data Field Mandate.
	expirydate XPath: /billing/payment/expirydate	Datum MM/JJJJ	7	Das auf der Karte aufgedruckte Ablaufdatum.
	pan XPath: /billing/payment/pan	Numerisch	12-19	Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist.
	paymenttypedescription XPath: /billing/payment/@type	Alpha	20	Geben Sie einen der folgenden unterstützten Werte an: "AMEX" "DELTA" "DINERS" "DISCOVER" "ELECTRON" "MAESTRO" "MASTERCARD" "MASTERCARDDEBIT" "PURCHASING" "VISA"
	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.
	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).
	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.
	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.
	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.
	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.
	billingfirstname XPath: /abrechnung/name/erste	Alphanumerisch einschließlich Symbole	127	Die Rechnungsvorname. Erforderlich für Visa Secure Data Field Mandate.
	billinglastname XPath: /abrechnung/name/last	Alphanumerisch einschließlich Symbole	127	Die Rechnungsnachname. Erforderlich für Visa Secure Data Field Mandate.
	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.
	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.
	billingmiddlename XPath: /abrechnung/name/mittelpunkt	Alphanumerisch einschließlich Symbole	127	Der mittlere Name der Rechnung.
	billingsuffixname XPath: /abrechnung/name/suffix	Alphanumerisch	25	Der Name des Rechnungssuffixes.
	billingpremise XPath: /abrechnung/premise	Alphanumerisch einschließlich Symbole	25	Die Hausnummer oder die erste Zeile der Rechnungsadresse.
	billingstreet XPath: /Rechnung/Straße	Alphanumerisch einschließlich Symbole	127	Die für die Rechnungsadresse eingegebene Straße.
	billingtown XPath: /abrechnung/stadt	Alphanumerisch einschließlich Symbole	127	Die für die Rechnungsadresse eingegebene Stadt.
	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".
	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.
	billingcountryiso2a XPath: /abrechnung/land	Alpha	2	Das für die Rechnungsadresse eingegebene Land im ISO2A-Format.
	billingtelephonetype XPath: /abrechnung/telefon/@type	Char	1	Der Typ der eingegebenen Telefonnummer. Die verfügbaren Optionen sind: H = Heim M = Handy W = Arbeit
	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.
	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.
	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.
	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.
	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.
	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.
	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.
	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: "111111119991111111" 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.*
	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.
	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
	requesttypedescription XPath: /@type	Alpha	20	"THREEDQUERY" wird in der Antwort zurückgegeben.
	accounttypedescription XPath: /operation/accounttypedescription	Alpha	20	In der Antwort wird "ECOM" (e-commerce) zurückgegeben.
	acsreferencenumber XPath: /threedsecure/acsreferencenumber	Alphanumerisch	32	Eindeutige Kennung, die dem ACS zugewiesen wurde.
	acstransid XPath: /threedsecure/acstransid	Alphanumerisch	36	Eindeutiger Bezeichner der Transaktion innerhalb des ACS-Systems.
	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.
	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.
	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.
	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.
	issuer XPath: /payment/issuer	Alphanumerisch	255	Der Kartenaussteller des Kunden.
	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.
	livestatus XPath: /live	Numerisch	1	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
	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.
	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.
	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.
	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.
	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.
	operatorname XPath: /merchant/operatorname	Alphanumeirc	255	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
	paymenttypedescription XPath: /billing/payment/@type	Alpha	20	Es kann einer der folgenden Werte zurückgegeben werden: "AMEX" "DELTA" "DINERS" "DISCOVER" "ELECTRON" "MAESTRO" "MASTERCARD" "MASTERCARDDEBIT" "PURCHASING" "VISA"
	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.
	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.
	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.
	threedsservertransid XPath: /threedsecure/threedsservertransid	Alphanumerisch	36	Universell eindeutige Transaktionskennung, die dem Server 3-D Secure zugewiesen wird, um eine einzelne Transaktion zu identifizieren.
	threedversion XPath: /threedsecure/version	Numerisch	6	Version von 3-D Secure , die zur Authentifizierung der Zahlung verwendet wird. (z.B. "2.2.0")
	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.
	transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	19	Der Zeitpunkt, zu dem die Anfrage bearbeitet wurde.
	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
	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
	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.
	errordata XPath: /error/data	Alphanumerisch	255	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
	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.
	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
	parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche	25	Sie müssen den transactionreference Wert, der in der Antwort THREEDQUERY zurückgegeben wird.
	requesttypedescription XPath: /@type	Alpha	20	Sie müssen in diesem Feld "THREEDRESULT" eingeben.
	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
	requesttypedescription XPath: /@type	Alpha	20	"THREEDRESULT" wird in der Antwort zurückgegeben.
	accounttypedescription XPath: /operation/accounttypedescription	Alpha	20	In der Antwort wird "ECOM" (e-commerce) zurückgegeben.
	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)
	cavv XPath: /threedsecure/cavv	Alphanumerisch	56	Die eindeutige Cardholder Authentication Verification Value (CAVV), die mit der Transaktion verbunden ist.
	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.
	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.
	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.
	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.
	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.
	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.
	issuer XPath: /billing/payment/issuer	Alphanumerisch	255	Der Kartenaussteller des Kunden.
	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.
	livestatus XPath: /live	Numerisch	1	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
	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.
	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.
	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.
	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.
	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.
	operatorname XPath: /merchant/operatorname	Alphanumerisch	255	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
	parenttransactionreference XPath: /operation/parenttransactionreference	Alphanumerisch & Bindestriche	25	Der zurückgegebene Wert entspricht dem parenttransactionreference in der Anfrage THREEDRESULT enthalten.
	paymenttypedescription XPath: /billing/payment/@type	Alpha	20	Es kann einer der folgenden Werte zurückgegeben werden: "AMEX" "DELTA" "DINERS" "DISCOVER" "ELECTRON" "MAESTRO" "MASTERCARD" "MASTERCARDDEBIT" "PURCHASING" "VISA"
	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.
	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.
	threeddirectorytransactionreference XPath: /threedsecure/directorytransactionreference	Alphanumerisch	48	Einzigartige DSTransactionId von Ihrem MPI Anbieter zurückgegeben.
	threedversion XPath: /threedsecure/version	Numerisch	6	Version von 3-D Secure , die zur Authentifizierung der Zahlung verwendet wird. (z.B. "2.2.0")
	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.
	transactionstartedtimestamp XPath: /timestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	19	Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
	errordata XPath: /error/data	Alphanumerisch	255	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
	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.

Wenden Sie sich bitte an unser Support-Team, wenn Sie Hilfe bei der Integration benötigen und/oder technische Fragen haben.

Weitere Lektüre