TRANSACTIONQUERY

  Zuletzt aktualisiert: 

 

Der folgende Inhalt setzt voraus, dass Sie die erforderliche PCI-Zertifizierung erhalten haben, um sensible Karteninhaberdaten in der Anfrage an unsere Webservices API zu verarbeiten und zu übermitteln.
Lesen Sie diesen Artikel, um mehr zu erfahren.

Wenn Sie Informationen zu früher eingereichten Anträgen und Transaktionen abrufen möchten, können Sie eine Anfrage an TRANSACTIONQUERY richten.

 

Überblick über den Prozess

Ihr System muss eine TRANSACTIONQUERY Anfrage an Trust Payments senden. Trust Payments wird dann eine Antwort mit den angeforderten Informationen zurücksenden, wenn eine passende Anfrage gefunden wurde.

So können Sie zum Beispiel Informationen über alle Transaktionen abfragen, die auf Ihrem Website-Referenz zwischen 18.00 und 21.00 Uhr abgewickelt wurden oder ob eine Transaktion abgewickelt wurde oder nicht.

 

Filter

Der Antrag TRANSACTIONQUERY umfasst hauptsächlich folgende Punkte filters. Betrachten Sie die Filter als Suchkriterien; die zurückgegebene Antwort enthält Informationen, die den angegebenen Filtern entsprechen.

Zum Beispiel, ein Filter mit orderreference "100100" würde Details zu allen übereinstimmenden Anfragen mit dieser Referenz zurückgeben (falls welche existieren und auf Ihrer Website-Referenz bearbeitet wurden).

Und die Angabe einer starttimestamp und endtimestamp liefert Details zu allen Anfragen, die zwischen den angegebenen Zeiten auf Ihrem Konto bearbeitet wurden.

  Mehrere Datensätze können in einer einzigen Antwort zurückgegeben werden

Wir empfehlen Ihnen, Ihre Anfrage so spezifisch wie möglich zu formulieren und so viele Filter wie nötig anzugeben, um zu vermeiden, dass eine übermäßige Anzahl von Datensätzen in der Antwort erscheint.

Sie können auch mehrere Werte für jeden gegebenen Filter übermitteln. z.B. können Sie einen Filter übermitteln für transactionreference Werte "23-9-1" und "23-9-2", und alle Anfragen, die diesen Werten entsprechen, werden in der Antwort zurückgegeben. (Ein Beispiel für diesen Fall finden Sie weiter unten)

 

TRANSACTIONQUERY Anfrage

Damit die Anfrage TRANSACTIONQUERY erfolgreich bearbeitet werden kann, müssen Sie mindestens einen gültigen Filter übermitteln.

 

Beispiel anfordern

Python PHP cURL Rohes JSON Rohes XML
#!/usr/bin/python
import securetrading

stconfig = securetrading.Config()
stconfig.username = "webservices@example.com"
stconfig.password = "Password1^"
st = securetrading.Api(stconfig)

query = {
"requesttypedescriptions": ["TRANSACTIONQUERY"],
"filter":{
"sitereference": [{"value":"test_site12345"}],
"currencyiso3a": [{"value":"GBP"}],
"transactionreference": [{"value":"72-9-80005"},{"value":"72-9-80006"}]
}
}

strequest = securetrading.Request()
strequest.update(query)
stresponse = st.process(strequest) #stresponse contains the transaction response

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

 

Feldspezifikation

In der folgenden Tabelle sind alle Felder aufgeführt, die Sie bei der Bearbeitung einer TRANSACTIONQUERY -Anfrage in den Filter aufnehmen können.

  Obwohl keines der folgenden Filterfelder obligatorisch ist, muss mindestens ein Filter eingegeben werden, damit die Anfrage erfolgreich bearbeitet werden kann. Aus diesem Grund wurden die meisten Felder unten als bedingt gekennzeichnet.

Eine Ausnahme von diesem Verhalten ist die sitereference Filter, der nicht allein eingereicht werden kann; er muss von mindestens einem anderen Filter begleitet werden. Diese Einschränkung dient dazu, die Belastung unserer Server zu verringern.

  Feld Format Beschreibung
X2-EN.png accounttypedescription
XPath: /filter/accounttypedescription
Alpha (20) Die Quelle der Transaktion.
  • Bei einer Anfrage für den elektronischen Handel AUTH sollte der Wert "ECOM" lauten.
  • Bei telefonischen Bestellungen im Versandhandel (MOTO) sollte der Wert "MOTO" lauten.
  • Bei einer wiederkehrenden Transaktion sollte der Wert "RECUR" lauten.
X2-EN.png billingemail
XPath: /filter/billingemail
E-Mail (255)

Die Adresse des Kunden Rechnungs-E-Mail .

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

X2-EN.png billingfirstname
XPath: /filter/billingfirstname
Alphanumerisch einschließlich Symbole (127) Der Kunde ist Rechnungsvorname.
X2-EN.png billinglastname
XPath: /filter/billinglastname
Alphanumerisch einschließlich Symbole (127) Der Kunde ist Rechnungsnachname.
X2-EN.png billingpostcode
XPath: /filter/billingpostcode
Alphanumerisch einschließlich Symbole (25) Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a vorgelegt.
X2-EN.png billingpremise
XPath: /filter/billingpremise
Alphanumerisch einschließlich Symbole (20) Die Nummer oder der Name der Verbrauchsstelle mit der Rechnungsadresse des Kunden.
X2-EN.png billingstreet
XPath: /filter/billingstreet
Alphanumerisch einschließlich Symbole (20) Der Straßenname der Rechnungsadresse des Kunden.
X2-EN.png completiontimestamp
XPath: /filter/completiontimestamp
Datum Uhrzeit JJJJ-MM-TT HH:MM:SS Dies ist der Fall, wenn eine Vorauthentifizierung von einem POS-Terminal, bei dem derzeit keine Mittel für Abrechnung vorgesehen sind, aktualisiert wird, um Abrechnung zu ermöglichen, indem eine Abschlussanforderung durchgeführt wird.
X2-EN.png currencyiso3a
XPath: /filter/currencyiso3a
Alpha (3)

Die Transaktion Währung.

Klicken Sie hier für eine vollständige Liste der Währung Codes.

X2-EN.png customerip
XPath: /filter/customerip
IP-Adresse (39) Die IP-Adresse des Kunden.
X2-EN.png endtimestamp
XPath: /filter/endtimestamp
Datum Uhrzeit JJJJ-MM-TT HH:MM:SS Nur Anfragen, die vor dem angegebenen Zeitstempel bearbeitet wurden, werden zurückgegeben.

(Anders als bei anderen Filtern können Sie nur einen endtimestamp in einer Anfrage)

X2-EN.png orderreference
XPath: /filter/orderreference
Alphanumerisch einschließlich Symbole (25) Eindeutige Referenznummer, die vom Händler für die Anfrage angegeben wurde.
X2-EN.png pan
XPath: /filter/pan
Numerisch (12-19) Dies ist die Kartennummer, die auf der Vorderseite der Karte des Kunden aufgedruckt ist.
X2-EN.png parenttransactionreference
XPath: /filter/parenttransactionreference
Alphanumerisch einschließlich Bindestriche (25) Eindeutige Referenz der übergeordneten Anfrage.
X2-EN.png paymenttypedescription
XPath: /filter/paymenttypedescription
Alpha (20) Der Kartentyp des Kunden (z. B. "VISA" oder "MASTERCARD").
X2-EN.png requesttypedescription
XPath: /filter/requesttypedescription
Alpha (20)

Die mit der Transaktion verbundene Anforderungstyp . Zum Beispiel: "AUTH" oder "REFUND".

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

X3-EN.png sitereference
XPath: /filter/sitereference
Alpha (50)

Die Website-Referenz, die die Transaktion bearbeitet hat.

Die sitereference muss mit mindestens einem anderen Filter übermittelt werden, sonst wird ein Fehler zurückgegeben.

X2-EN.png starttimestamp
XPath: /filter/starttimestamp
Datum Uhrzeit JJJJ-MM-TT HH:MM:SS Nur Anfragen, die nach dem angegebenen Zeitstempel bearbeitet wurden, werden zurückgegeben.

(Anders als bei anderen Filtern können Sie nur einen starttimestamp in einer Anfrage)

X2-EN.png transactionreference
XPath: /filter/transactionreference
Alphanumerisch einschließlich Bindestriche (25) Die eindeutige Referenz, die der Transaktion zugeordnet ist und von Trust Payments zugewiesen wird.

Es können nur die oben genannten Filter eingegeben werden. Wenn ein übermittelter Filter nicht genau mit einem der oben aufgeführten unterstützten Werte übereinstimmt, wird er nicht zur Durchführung der Suche verwendet. Aus diesem Grund ist es wichtig, dass Sie sicherstellen, dass alle enthaltenen Filter korrekt geschrieben sind und dass Sie Ihre Lösung gründlich testen, um sicherzustellen, dass die erwarteten Datensätze zurückgegeben werden.

 

TRANSACTIONQUERY Antwort

Wenn Sie eine TRANSACTIONQUERY Anfrage erfolgreich abgeschickt haben, erhalten Sie eine Antwort, die in verschiedene Bereiche unterteilt ist records.

Jeder Datensatz enthält eine unterschiedliche Anzahl von Antwortfeldern, die von der im Datensatz angegebenen Anforderungstyp abhängen. Wenn der Datensatz zum Beispiel eine requesttypedescription von "AUTH", dann müssen Sie sich auf den Feldspezifikation in der Autorisierung.

Außerdem enthält die Antwort ein Feld namens foundSie gibt die Anzahl der Datensätze an, die mit den in der Anfrage angegebenen Filtern übereinstimmen. Wenn found den Wert "0" hat, wurden mit den von Ihnen angegebenen Filtern keine Datensätze gefunden.

Hier ein vereinfachtes Beispiel für die Struktur der Antwort, bestehend aus 2 Datensätzen (beide sind vom Typ "AUTH"):

Python PHP Rohes JSON Rohes XML
{
u 'requestreference': u 'W72-pg3q2he9',
u 'version': u '1.00',
u 'responses': [{
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'found': u '2',
u 'records': [{
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST22',
u 'baseamount': u '1050',
u 'cavv': u 'dHJ1c3RwYXltZW50c2F1dGhlbnQ',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'eci': u '05',
u 'enrolled': u 'Y',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'expirydate': u '10/2022',
u 'fraudrating': u '0',
u 'interface': u 'PASS-JSON-JSON',
u 'issuer': u 'SecureTrading Test Issuer1',
u 'issuercountryiso2a': u 'US',
u 'livestatus': u '0',
u 'maskedpan': u '411111######1111',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'VISA',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '2',
u 'settlebaseamount': u '1050',
u 'settleduedate': u '2019-12-17',
u 'settlestatus': u '0',
u 'sitereference': u 'test_site12345',
u 'splitfinalnumber': u '1',
u 'status': u 'Y',
u 'threedversion': u '2.2.0',
u 'tid': u '27882788',
u 'transactionreference': u '72-9-80005',
u 'transactionstartedtimestamp': u '2019-12-17 09:35:03'
}, {
u 'accounttypedescription': u 'ECOM',
u 'acquirerresponsecode': u '00',
u 'authcode': u 'TEST03',
u 'baseamount': u '1050',
u 'cavv': u 'dHJ1c3RwYXltZW50c2F1dGhlbnR',
u 'currencyiso3a': u 'GBP',
u 'dccenabled': u '0',
u 'debtrepayment': u '0',
u 'eci': u '05',
u 'enrolled': u 'Y',
u 'errorcode': u '0',
u 'errormessage': u 'Ok',
u 'expirydate': u '10/2022',
u 'fraudrating': u '0',
u 'interface': u 'PASS-JSON-JSON',
u 'issuer': u 'SecureTrading Test Issuer1',
u 'issuercountryiso2a': u 'US',
u 'livestatus': u '0',
u 'maskedpan': u '411111######1111',
u 'merchantcountryiso2a': u 'GB',
u 'merchantname': u 'Test Merchant',
u 'operatorname': u 'webservices@example.com',
u 'paymenttypedescription': u 'VISA',
u 'requesttypedescription': u 'AUTH',
u 'securityresponseaddress': u '0',
u 'securityresponsepostcode': u '0',
u 'securityresponsesecuritycode': u '2',
u 'settlebaseamount': u '1050',
u 'settleduedate': u '2019-12-17',
u 'settlestatus': u '0',
u 'sitereference': u 'test_site12345',
u 'splitfinalnumber': u '1',
u 'status': u 'Y',
u 'threedversion': u '2.2.0',
u 'tid': u '27882788',
u 'transactionreference': u '72-9-80006',
u 'transactionstartedtimestamp': u '2019-12-17 09:35:10'
}],
u 'requesttypedescription': u 'TRANSACTIONQUERY',
u 'transactionstartedtimestamp': u '2019-12-17 09:36:21'
}]
}

  Es können maximal 500 Datensätze pro Antwort zurückgegeben werden.

Die found wird nie einen höheren Wert als 500 zurückgeben, selbst wenn mehr als 500 Anfragen die angegebenen Kriterien erfüllen.

 

Verstehen von Fehlern

Bitte vergewissern Sie sich, dass Sie die Fehlercodes die in der Antwort zurückgegeben werden:

  • Auf der höchsten Ebene der Reaktion, zusammen mit transactionstartedtimestamp und found, gibt es eine errorcode. Dies zeigt an, ob die TRANSACTIONQUERY Anfrage erfolgreich war oder nicht. Wenn Fehlercode hier nicht "0" ist, war die TRANSACTIONQUERY -Anfrage nicht erfolgreich. Sie müssen das Problem beheben und es erneut versuchen.
  • Darüber hinaus wird jeder record enthalten ihre eigenen errorcode. Dies zeigt an, ob der im Datensatz dargestellte Antrag erfolgreich war oder nicht.
  • Eine vollständige Liste der von Trust Payments verwendeten Fehlercodes finden Sie hier.

 

Feldspezifikation

In der folgenden Tabelle sind alle Felder aufgelistet, die in einem bestimmten record.

Felder werden nur zurückgegeben, wenn die Daten für die abgefragte Anfrage verfügbar sind.
Dies kann je nach Anforderungstyp variieren.

  Feld Format Beschreibung
X4-EN.png accounttypedescription
XPath: /record/operation/accounttypedescription
Alpha (20) Die Art des Kontos, das für die Bearbeitung der abgefragten Anfrage verwendet wird:
  • "ECOM" - Elektronischer Geschäftsverkehr.
  • "MOTO" - Versandhandel Telefonische Bestellung
  • "RECUR" - Wiederkehrende Transaktionen
X2-EN.png

acquireradvicecode
XPath: /record/acquireradvicecode

 Numerisch (1) Ein numerischer Wert, der nach einer wiederholten Zahlungsanforderung zurückgegeben wird und angibt, ob weitere Zahlungen verarbeitet werden können.

Kartierung:

  • 0 - Keine Maßnahme erforderlich.
  • 1 - Neue Kontoinformationen verfügbar.
  • 2 - Kann zum jetzigen Zeitpunkt nicht genehmigt werden.
  • 4 - Keine weiteren wiederkehrenden Transaktionen verarbeiten.
  • 8 - Zahlung durch Kartensystem gesperrt.

Ob dieses Feld zurückgegeben wird, hängt von Ihrer anwerbenden Bank ab. Bitte kontaktieren Sie unser Support-Team, wenn Sie Hilfe benötigen.

X2-EN.png

acquirerresponsecode
XPath: /record/acquirerresponsecode

Alphanumerisch (255)

Wird von Ihrem Acquirer verwendet, um das Ergebnis der abgefragten Anfrage anzuzeigen.

Ob diese Felder zurückgegeben werden, hängt von Ihrer anwerbenden Bank ab. Bitte kontaktieren Sie unser Support-Team, wenn Sie Hilfe benötigen.

X2-EN.png

acquirerresponsemessage
XPath: /record/acquirerresponsemessage

Alphanumerisch (255)
X2-EN.png authcode
XPath: /record/authcode
Alphanumerisch (255)

Der Autorisierung Code, der von der ausstellenden Bank bereitgestellt wird. Dieser ist je nach Bank unterschiedlich.

Wird nur zurückgegeben, wenn die abgefragte Transaktion genehmigt wurde.

X2-EN.png authmethod
XPath: /record/operation/authmethod
Alpha (11)

Auth-Methoden werden verwendet, um festzulegen, wie eine Transaktion vom Kartenaussteller verarbeitet werden soll. Jede authmethod hat eine andere Reihe von Anforderungen. Klicken Sie auf die folgenden Links, um mehr zu erfahren:

Wird nur zurückgegeben, wenn der Anfrage ein authmethod Wert zugewiesen wurde.

X4-EN.png baseamount
XPath: /record/billing/amount
Numerisch (13) Der Betrag der abgefragten Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, so dass £10 als 1000 zurückgegeben wird.
X2-EN.png billingcountryiso2a
XPath: /record/billing/country
Alpha (2)

Das Land für die Rechnungsadresse des Kunden im ISO2A-Format.

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

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingcounty
XPath: /record/billing/county
Alphanumerisch einschließlich
Symbole (127)

Der Bezirk, der für die Rechnungsadresse des Kunden eingegeben wurde. Bei US-Adressen wird hier der Bundesstaat in einem zweistelligen Format zurückgegeben (z. B. "NY").

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingemail
XPath: /record/billing/email
E-Mail (255)

Die Adresse des Kunden Rechnungs-E-Mail .

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingfirstname
XPath: /record/billing/name/first
Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsvorname.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billinglastname
XPath: /record/billing/name/last
Alphanumerisch einschließlich
Symbole (127)

Der Kunde ist Rechnungsnachname.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingmiddlename
XPath: /record/billing/name/middle
Alphanumerisch einschließlich
Symbole (127)

Der/die mittlere(n) Rechnungsname(n) des Kunden.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingpostcode
XPath: /record/billing/postcode
Alphanumerisch (25)

Die Postleitzahl, die für die Rechnungsadresse des Kunden eingegeben wurde.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingprefixname
XPath: /record/billing/name/prefix
Alphanumerisch einschließlich
Symbole (25)

Das Präfix des Rechnungsnamens des Kunden (z. B. Herr, Frau, Dr.).

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingpremise
XPath: /record/billing/premise
Alphanumerisch einschließlich
Symbole (25)

Die Hausnummer oder die erste Zeile der Rechnungsadresse des Kunden.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingstreet
XPath: /record/billing/street
Alphanumerisch einschließlich
Symbole (127)

Die für die Rechnungsadresse des Kunden eingegebene Straße.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingsuffixname
XPath: /record/billing/name/suffix
Alphanumerisch einschließlich
Symbole (25)

Das Suffix des Rechnungsnamens des Kunden (z. B. Bsc).

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingtelephone
XPath: /record/billing/telephone
Alphanumerisch einschließlich
Symbole (20)

Die Telefonnummer des Kunden.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingtelephonetype
XPath: /record/billing/telephone/@type
Saibling (1) Die Art der Telefonnummer. Die verfügbaren Optionen sind:
  • H = Heim
  • M = Handy
  • W = Arbeit

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png billingtown
XPath: /record/billing/town
Alphanumerisch einschließlich
Symbole (127)

Der Ort, der für die Rechnungsadresse des Kunden eingegeben wurde.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png cavv
XPath: /record/threedsecure/cavv
Alphanumerisch (56)

Die eindeutige Cardholder Authentication Verification Value (CAVV), die mit der Transaktion verbunden ist.

Dieses Feld wird zurückgegeben, falls vorhanden.

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

Dies ist eine Beschreibung der abgefragten Zahlung, die auf dem Kontoauszug des Kunden erscheint.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png credentialsonfile
XPath: /record/operation/credentialsonfile
Numerisch (1) Die zulässigen Werte für dieses Feld sind 0, 1 und 2.
  • "0" - Keine Berechtigung für CoF oder keine Absicht, die Berechtigungsnachweise zu einem späteren Zeitpunkt wieder zu verwenden.
  • "1" - Transaktionsnachweise werden als für die zukünftige Verwendung verfügbar gekennzeichnet.
  • "2" - Zahlung mit zuvor gespeicherten Anmeldeinformationen.

Wird nur zurückgegeben, wenn ein credentialsonfile Wert der Anfrage zugewiesen wurde.

X4-EN.png currencyiso3a
XPath: /record/billing/amount/@currencycode
Alpha (3)

Die Währung der abgefragten Transaktion.

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

X2-EN.png customercountryiso2a
XPath: /record/customer/country
Alpha (2)

Das Land der Lieferadresse des Kunden im ISO2A-Format.

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

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customercounty
XPath: /record/customer/county
Alphanumerisch einschließlich
Symbole (127)

Der Bezirk, der für die Lieferadresse des Kunden eingegeben wurde. Bei US-Adressen wird hier der Bundesstaat in einem zweistelligen Format zurückgegeben (z. B. "NY").

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customeremail
XPath: /record/customer/email
E-Mail (255)

Die Liefer-E-Mail-Adresse des Kunden.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customerfirstname
XPath: /record/customer/name/first
Alphanumerisch einschließlich
Symbole (127)

Der Vorname des Kunden bei der Zustellung.

Dieses Feld wird zurückgegeben, falls vorhanden.

X4-EN.png customerip
XPath: /record/customer/ip
IP-Adresse (39) Die IP des Kunden.
X2-EN.png customerlastname
XPath: /record/customer/name/last
Alphanumerisch einschließlich
Symbole (127)

Der Nachname des Kunden bei der Zustellung.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customermiddlename
XPath: /record/customer/name/middle
Alphanumerisch einschließlich
Symbole (127)

Zweiter Vorname(n) des Kunden bei der Zustellung.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customerpostcode
XPath: /record/customer/postcode
Alphanumerisch (25)

Die Postleitzahl, die für die Lieferadresse des Kunden eingegeben wurde.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customerprefixname
XPath: /record/customer/name/prefix
Alphanumerisch einschließlich
Symbole (25)

Das Präfix des Liefernamens des Kunden (z. B. Herr, Frau, Dr.).

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customerpremise
XPath: /record/customer/premise
Alphanumerisch einschließlich
Symbole (25)

Die Hausnummer oder die erste Zeile der Lieferadresse des Kunden.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customerstreet
XPath: /record/customer/street
Alphanumerisch einschließlich
Symbole (127)

Die für die Lieferadresse des Kunden eingegebene Straße.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customersuffixname
XPath: /record/customer/name/suffix
Alphanumerisch einschließlich
Symbole (25)

Das Suffix des Liefernamens des Kunden (z. B. Bsc).

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customertelephone
XPath: /record/customer/telephone
Alphanumerisch einschließlich
Symbole (20)

Die Telefonnummer des Kunden.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customertelephonetype
XPath: /record/customer/telephone/@type
Saibling (1) Die Art der Telefonnummer. Die verfügbaren Optionen sind:
  • H = Heim
  • M = Handy
  • W = Arbeit

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png customertown
XPath: /record/customer/town
Alphanumerisch einschließlich
Symbole (127)

Der Ort, der für die Lieferadresse des Kunden eingegeben wurde.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png dccbaseamount
XPath: /record/billing/dcc/amount
Numerisch (13)

Bei DCC handelt es sich um den Betrag auf der Website des Händlers Währung. Dieser wird in Basiseinheiten ohne Kommas oder Dezimalpunkte angegeben, d. h. 10 £ werden als 1000 zurückgegeben.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png dccenabled
XPath: /record/billing/dcc/@enabled
Numerisch (1)

Zeigt an, ob Ihr Konto konfiguriert ist für DCC:
1= Ja
0 = Nein

Wird nur bei Kartentransaktionen zurückgegeben.

X2-EN.png dcccurrencyiso3a
XPath: /record/billing/dcc/amount/@currencycode
Alpha (3)

Für DCC ist dies die Seite des Händlers Währung im iso3a-Format.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png dccconversionrate
XPath: /record/billing/dcc/conversionrate
Numerisch (255)

Bei DCC ist dies der Umrechnungskurs, der zur Berechnung des Betrags auf Währung verwendet wird.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png dccratio
XPath: /record/billing/dcc/ratio
Numerisch (255)

Für DCC ist dies das Verhältnis zwischen den Beträgen in Haupteinheiten der Währung und der Währung des Händlers.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png debtrepayment
XPath: /record/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.

Klicken Sie hier, um mehr zu erfahren.

Wird nur bei Kartentransaktionen zurückgegeben.

X2-EN.png eci
XPath: /record/threedsecure/eci
Alphanumerisch (2)

Die mit der Transaktion verbundene Sicherheitsstufe ECI (E-Commerce Indicator).

Klicken Sie hier, um mehr über mögliche ECI Werte zu erfahren.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png enrolled
XPath: /record/threedsecure/enrolled
Saibling (1)

Zeigt an, ob die Karte des Kunden bei einem 3-D Secure System angemeldet ist oder nicht.

Klicken Sie hier, um mehr zu erfahren.

Dieses Feld wird zurückgegeben, falls vorhanden.

X4-EN.png errorcode
XPath: /record/error/code
Numerisch (1-5) Die Fehlercode sollte verwendet werden, um festzustellen, ob die abgefragte(n) Anfrage(n) erfolgreich waren.
  • 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 Nachrichtenwerte.

X2-EN.png errordata
XPath: /record/error/data
Alphanumerisch (255)

Zusätzliche Informationen zur Behebung des Fehlers.

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

X4-EN.png errormessage
XPath: /record/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 Nachrichtenwerte.

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

Das auf der Karte aufgedruckte Ablaufdatum.

Wird nur bei Kartentransaktionen zurückgegeben.

X2-EN.png fraudrating
XPath: /record/fraud/rating
Numerisch (2)

Dieses Feld bezieht sich auf unsere internen Betrugsprüfungen, wie in diesem Artikel dokumentiert. Dieser Wert stellt die aktuell zugewiesene Betrugsrating der abgefragten Transaktion dar.

Diese Funktion ist opt-in. Wenn sie auf Ihrer Website-Referenz nicht aktiviert ist, wird immer 0 zurückgegeben.

Wenn Sie sich für die Teilnahme entschieden haben:

  • -1 zeigt an, dass die Prüfungen noch nicht abgeschlossen sind.
  • Je höher Betrugsrating ist, desto größer ist die Anzahl der verdächtigen Merkmale, die von unserem Betrugssystem identifiziert wurden.
  • Standardmäßig benachrichtigen wir Sie über Transaktionen, die eine Betrugsrating von 2 oder höher haben.
  • Standardmäßig werden alle Transaktionen ausgesetzt, die eine Betrugsrating von 5 oder höher haben.

Klicken Sie hier, um mehr zu erfahren.

Wird nur bei Kartentransaktionen zurückgegeben.

X4-EN.png interface
XPath: /record/operation/interface
Alphanumerisch einschließlich Symbole (50)

Stellt die Schnittstelle dar, über die die abgefragte Anfrage bearbeitet wurde. Die folgenden Beispiele sind üblich:

  • "JWT-JWT-JWT" - JavaScript Library oder Mobile SDK.
  • "MYST" - MyST (z. B. Refund, Virtuelles Terminal oder Auszahlungsterminal).
  • "PASS-JSON-JSON" - Webservices API mit JSON-Auszeichnung.
  • "PASS-XML-XML" - Webservices API mit XML-Auszeichnung.
X2-EN.png issuer
XPath: /record/billing/payment/issuer
Alphanumerisch (255)

Der Kartenaussteller des Kunden.

Wird nur bei Kartentransaktionen zurückgegeben.

X2-EN.png issuercountryiso2a
XPath: /record/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.

Wird nur bei Kartentransaktionen zurückgegeben.

X4-EN.png livestatus
XPath: /record/live
Numerisch (1)
  • 0 - Die abgefragte Transaktion wurde über ein Testkonto abgewickelt.
  • 1 - Die abgefragte Transaktion wurde über ein Live-Konto abgewickelt.
X2-EN.png

maskedpan
XPath: /record/billing/payment/pan

Alphanumerisch einschließlich "#" (12-19)

Wenn tokenisedpayment wird nicht zurückgegeben:
Die maskedpan steht für die Kartennummer des Kunden.

Wenn tokenisedpayment wird mit dem Wert 1 zurückgegeben:
Die maskedpan steht für die eindeutige Token-Nummer des Kunden, die zur Durchführung der abgefragten Transaktion verwendet wird. Der Wert von maskedpan Feld ist in der Antwort maskiert. Der größte Teil der Nummer wird absichtlich durch "#"-Zeichen verdeckt, z. B. 411111######0211.

Wird nur bei Kartentransaktionen zurückgegeben.

X2-EN.png merchantcategorycode
XPath: /record/merchant/merchantcategorycode
Alphanumerisch (255)

Es handelt sich hierbei um Angaben zu dem Konto, das zur Bearbeitung der angefragten Transaktion verwendet wurde. Um diese Felder zu ändern, wenden Sie sich bitte an unser Support-Team.

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

merchantcity
XPath: /record/merchant/merchantcity
Alphanumerisch (127)
merchantcountryiso2a
XPath: /record/merchant/merchantcountryiso2a
Alpha (2)
merchantname
XPath: /record/merchant/merchantname
Alphanumerisch (255)
merchantstatecode
XPath: /record/merchant/merchantstatecode
Alphanumerisch (127)
merchantzipcode
XPath: /record/merchant/merchantzipcode
Alphanumerisch (10)
X4-EN.png operatorname
XPath: /record/merchant/operatorname
Alphanumerisch (255) Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
X2-EN.png orderreference
XPath: /record/merchant/orderreference
Alphanumerisch einschließlich
Symbole (25)

Die eindeutige Auftragsreferenz für die abgefragte Anfrage, die auf dem System Trust Payments gespeichert ist.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png parenttransactionreference
XPath: /record/operation/parenttransactionreference
Alphanumerisch
& Bindestriche (25)

Die transactionreference eines früheren Ersuchens, aus dem die wichtigsten Details hervorgegangen sind vererbt in der abgefragten Anfrage.

Dieses Feld wird zurückgegeben, falls vorhanden.

X4-EN.png paymenttypedescription
XPath: /record/billing/payment/@type
Alpha (20) Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
X4-EN.png requesttypedescription
XPath: /record/@type
Alpha (20) Die Art der im Datensatz zurückgegebenen Anfrage.
X2-EN.png retrievalreferencenumber
XPath: /record/other/retrievalreferencenumber
Alphanumerisch (255)

Ein ISO-Begriff. Dieser wird verwendet, um auf die Quelltransaktion zu verweisen.

Dieses Feld wird zurückgegeben, wenn es verfügbar ist. Dies hängt von Ihrer erwerbenden Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.

X2-EN.png scaexemptionindicator
XPath: /record/operation/scaexemptionindicator
Numerisch (1)

Wird zurückgegeben, wenn die abgefragte Transaktion als ausgenommen von EMV 3DS gekennzeichnet wurde. Klicken Sie hier, um mehr zu erfahren.

Die folgenden Werte können zurückgegeben werden:
1 - Niedriger Wert
2 - Analyse des Transaktionsrisikos
3 - Vertrauenswürdiger Händler
4 - Sichere Unternehmenszahlung
5 - Authentifizierung delegiert

X2-EN.png securityresponseaddress
XPath: /record/security/address
Numerisch (1)

Das Ergebnis der AVS und Sicherheitscode-Prüfungen. Diese enthalten einen der folgenden Werte:

  • 0 - Der Acquirer hat die für die Durchführung dieser Prüfung erforderlichen Informationen nicht erhalten.
  • 1 - Der Acquirer ist nicht in der Lage, die bereitgestellten Informationen zu überprüfen.
  • 2 - Die Angaben des Kunden stimmen mit den Angaben in den Unterlagen des Kartenausstellers überein.
  • 4 - Die vom Kunden angegebenen Daten stimmen NICHT mit den Daten in den Unterlagen des Kartenausstellers überein.

Klicken Sie hier, um mehr zu erfahren.

Diese Felder werden zurückgegeben, wenn sie verfügbar sind.

X2-EN.png securityresponsepostcode
XPath: /record/security/postcode
Numerisch (1)
X2-EN.png securityresponsesecuritycode
XPath: /record/security/securitycode
Numerisch (1)
X4-EN.png settlebaseamount
XPath: /record/settlement/settlebaseamount
Numerisch (13)

Der Wert des abzurechnenden Betrags. Der abgerechnete Betrag kann über eine TRANSACTIONUPDATE Anfrage aktualisiert werden, so dass er niedriger ist als der ursprünglich genehmigte Betrag.

X4-EN.png settleduedate
XPath: /record/settlement/settleduedate
Datum JJJJ-MM-TT Das Datum, an dem die abgefragte Transaktion abgewickelt wird.
X2-EN.png settledtimestamp
XPath: /record/settlement/settledtimestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss

Das Datum und die Uhrzeit, zu der die abgefragte Transaktion abgewickelt wurde.

Wird nur zurückgegeben, wenn die Transaktion abgewickelt wurde.

X4-EN.png settlestatus
XPath: /record/settlement/settlestatus
Numerisch (3)

Ein numerischer Wert, der den Fortschritt von Abrechnung in Bezug auf die abgefragte Transaktion anzeigt.

Klicken Sie hier für eine vollständige Liste der settlestatus Werte.

X4-EN.png sitereference
XPath: /record/operation/sitereference
Alphanumerisch
& Unterstrich (50)

Die Website-Referenz , über die die abgefragte Anfrage bearbeitet wurde.

X2-EN.png splitfinalnumber
XPath: /operation/splitfinalnumber
Numerisch (2)

Gesamtzahl der zulässigen Splits.

Wenn Sie keinen Gesplittete Sendung durchführen, wird dies als 1 zurückgegeben.

Klicken Sie hier, um mehr über den Gesplittete Sendung zu erfahren.

Wird nur bei Kartentransaktionen zurückgegeben.

X2-EN.png stan
XPath: /record/other/stan
ISO 8583

Die STAN (System Trace Audit Number), die mit der Transaktion verbunden ist. Dies entspricht der Norm ISO 8583.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png status
XPath: /record/threedsecure/status
Saibling (1)

Zeigt an, ob der Kunde im ACS des Kartenausstellers authentifiziert wurde oder nicht.

Klicken Sie hier, um mehr zu erfahren.

X2-EN.png threedversion
XPath: /record/threedsecure/version
Numerisch (6)

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

X2-EN.png tid
XPath: /record/merchant/tid
Alphanumerisch (255)

Die Terminal-ID, die für die Verarbeitung der abgefragten Transaktion verwendet wurde. Diese wird Ihrer Händlernummer zugeordnet, wenn wir Ihr Konto in unseren Systemen einrichten.

Ob dieses Feld zurückgegeben wird, hängt von Ihrer anwerbenden Bank ab. Bitte kontaktieren Sie unser Support-Team, wenn Sie Hilfe benötigen.

X2-EN.png tokenisedpayment
XPath: /record/billing/payment/pan/@tokenised
Numerisch (1)

Wenn dieses Feld mit dem Wert 1 zurückgegeben wird, bedeutet dies, dass die abgefragte Transaktion unter Verwendung eines Tokens verarbeitet wurde.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png tokentype
XPath: /record/billing/payment/pan/@tokentype
Alphanumerisch (50)

Dient zur Identifizierung der Art des für die abgefragte Zahlung verwendeten Tokens (z. B. "VISATOKEN").

Dieses Feld wird zurückgegeben, falls vorhanden.

X4-EN.png transactionreference
XPath: /record/transactionreference
Alphanumerisch einschließlich
Bindestriche (25)
Eine eindeutige Referenz für die abgefragte 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: /record/timestamp
Datum Uhrzeit JJJJ-MM-TT hh:mm:ss Der Zeitpunkt, zu dem die abgefragte Transaktion verarbeitet wurde.
X2-EN.png updatereason
XPath: /record/settlement/updatereason
Alphanumerisch (255)

Die letzte Partei, die eine Aktualisierung der zurückgegebenen Transaktion vorgenommen hat. Wenn die Transaktion nach dem Senden der ersten Anfrage nie aktualisiert wurde, wird dieses Feld nicht ausgefüllt. Übliche Beispiele:

  • Der Benutzername des Benutzers, der die Aktualisierung durchgeführt hat.
  • "rulemanager" - Die Transaktion wurde von unserem Regel-Manager.
  • "securitypolicy" - Die Transaktion wurde gemäß der Sicherheitspolitik auf Ihr Konto.
  • "settle" - Die Transaktion wurde von unserem Abrechnung Motor.
  • "duplicate" - Die Transaktion wurde als Duplikat betrachtet und von unserer Behörde ausgesetzt Scheckduplikate.

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png walletdisplayname
XPath: /record/billing/payment/wallet/displayname
Alphanumerisch (255)

Diese enthält normalerweise die letzten vier Ziffern der Kartennummer des Kunden (z. B. "1111").

Dieses Feld wird zurückgegeben, falls vorhanden.

X2-EN.png walletsource
XPath: /record/billing/payment/wallet/source
Alphanumerisch (20)

Dient zur Identifizierung der Art der für die abgefragte Zahlung verwendeten Brieftasche (z. B. "APPLEPAY").

Dieses Feld wird zurückgegeben, falls vorhanden.

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