Webservices API-Leitfaden für POS-Entwickler

Wenden Sie sich direkt an Trust Payments , um eine Genehmigung zu erhalten, bevor Sie diese Inhalte in Ihrer Integration verwenden.

Erste Schritte

Konfigurieren Sie Ihre Bibliothek

Zunächst müssen Sie Ihr System für eine sichere Verbindung mit Trust Payments konfigurieren. Bitte klicken Sie auf den unten stehenden Link und folgen Sie den Anweisungen, um sicherzustellen, dass Ihr System erfolgreich eine Basisanfrage an unser Gateway senden kann. Anschließend wird in den nachstehenden Anweisungen erläutert, wie Sie Anfragen zur Durchführung von Zahlungsfunktionen mit Ihrem POS-Terminal senden können.

Konfigurationsanweisungen in einer neuen Registerkarte öffnen

Transaktion verarbeiten

AUTH Übersicht

Um eine Kartentransaktion zu verarbeiten, müssen Sie eine AUTH Anfrage stellen und die zurückgegebene Antwort bearbeiten.

Autorisierung
- Sie übermitteln eine AUTH Anfrage an den Trust Payments Endpunkt unter Verwendung unserer Webservices API.
- Die Abrechnungsstatus wird verwendet, um den Status der Transaktion anzugeben.
- Wenn eine Zahlung von der erwerbenden Bank autorisiert wurde, wird die Abrechnungsstatus normalerweise auf "0" gesetzt.
- Trust Payments gibt eine AUTH Antwort zurück, die entweder einen Erfolg oder einen Fehler anzeigt.
Anhängig Abrechnung
- Nach einer erfolgreichen Autorisierung wird das Geld auf dem Bankkonto des Kunden reserviert, bis Abrechnung.
- Während dieser Zeit können Sie Abfragen und Aktualisierungen über unsere Webservices API oder MyST (unsere Online-Transaktionsverwaltung portal) vornehmen.
- Aktualisierungen können nur durchgeführt werden, wenn die Abrechnungsstatus "0" oder "1" ist.
Fertigstellung
- Abrechnung erfolgt in der Regel innerhalb von 24 Stunden, was jedoch je nach Bank und Zahlungsmethode variieren kann.
- Sobald die Zahlung erfolgt ist, wird das Geld auf Ihr Bankkonto überwiesen. Dies aktualisiert die Abrechnungsstatus auf "100".
- Sie können Erstattungen vornehmen, indem Sie einen Antrag über unsere Webservices API oder MyST (unsere Online-Transaktionsverwaltung portal) stellen.
- Bei einigen Zahlungsarten kann die Transaktion den Status "10" haben, d. h. Abrechnung ist in Bearbeitung, aber noch nicht abgeschlossen.
Umgang mit Fehlern
- Wird eine Transaktion abgebrochen oder tritt zu irgendeinem Zeitpunkt des Prozesses ein Fehler auf, wird die Abrechnungsstatus auf "3" gesetzt.
- Weitere Aktionen können nicht durchgeführt werden, und das Geld wird wieder auf das Bankkonto des Kunden überwiesen.
- Wenn Sie sich die Fehlercode (errorcode) sehen, können Sie den Grund für unerwartete Ausfälle erfahren.

Verarbeitung AUTH

AUTH Anfrage

Um eine AUTH Anfrage erfolgreich bearbeiten zu können, müssen Sie die folgenden Angaben beachten:

{
  "alias":"webserv3",
  "version":"1.00",
  "request":[{
    "accounttypedescription":"POS",
    "baseamount":"1000",
    "carddataentrymode":"CONTACTLESS",
    "cardholderauthenticationmethod":"ONLINEPIN",
    "currencyiso3a":"GBP",
    "deviceencryptedtrack2data":"C8AC965B70FD1F590EAA44F2D55511A5B29D55A1B98F0C70",
    "deviceencryptedpin":"C9A8FEB60C5B26CD",
    "deviceencryptionkeytype":"AES-256",
    "deviceksn":"1234567822334A0000000001",
    "expirydate":"12/2028",
    "iccdata": "9F02060000000010009F03060000000000009F2608A1B2C3D4E5F6A1B28202A1B29F360200018A02A1B29F3403A1B2C39F2701A18410A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29F3501A19F6E06A1B2C3D4E5F69F1E10313233343536373831323334353637389F1020A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29110A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2DF3114A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D49F5B14A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D47166A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B7219A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A19F0901019F3303015ABC9F1A0208269505A1B2C3D4E59F5301A15F2A0208269A032212129C01009F370400010001",
    "orderreference":"My_Order_123",
    "requesttypedescriptions":"AUTH",
    "sitereference":"test_mikepos76455",
    "terminalcardcapturecapability":"2",
    "terminalcardoutputcapability": "3",
    "terminalid":"12345678",
    "terminalinputcapability":["CONTACTLESS","ICC"],
    "terminaloperatingenvironment":"2",
    "terminaloutputcapability":"B",
    "terminalpinentrycapability":"4"
  }]
}

Feldspezifikation

Erforderlich	Feld	Format	Länge	Beschreibung
	accounttypedescription	Alpha	Maximal 20	Die Art des Kontos, das für die Verarbeitung der Transaktion verwendet wird. Geben Sie "POS" ein, wenn Sie POS-Transaktionen verarbeiten.
	baseamount	Numerisch	Maximal 13	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. €10 werden als 1000 übermittelt. Wenn der Kunde Cashback anfordert, ist dies baseamount der Gesamtbetrag, der von der Karte des Kunden abgebucht wird, einschließlich des im Feld " Cashback-Basisbetrag " angegebenen Wertes.
	Kartendateneingabemodus	Alpha	Maximal 18	Folgende Werte werden unterstützt: CONTACTLESS - Auto über kontaktlosen M/Chip. ICC - Auto über ICC. ICCUNRELIABLE - Die Daten wurden per Chip gelesen und sind möglicherweise unzuverlässig. MAGSTRIPE - Auto über Magnetstreifen. MAGSTRIPEFAILEDICC - Auto via Mag Stripe - Fallback, wenn Auto via ICC fehlgeschlagen ist. MAGSTRIPEPARTIAL - Auto über Magnetstreifen, aber Magnetstreifendaten nicht vollständig gelesen/übertragen. Wenn Sie eine Online-PIN-Transaktion ermöglichen, können Sie nur CONTACTLESS, ICC oder ICCUNRELIABLE eingeben.
	karteninhaber-authentifizierungsmethode	Alpha	Maximal 15	Folgende Werte werden unterstützt: SIGNATURE - Unterschrift. (Kann nur übermittelt werden, wenn der Kartendateneingabemodus "CONTACTLESS", "ICC", "ICCUNRELIABLE", "MAGSTRIPE", "MAGSTRIPEFAILEDICC" oder "MAGSTRIPEPARTIAL" ist) MOBILEDEVICECVM - CVM, durchgeführt von einem mobilen Gerät. (Kann nur übermittelt werden, wenn carddataentrymode "CONTACTLESS" ist) NOCVM - Nicht authentifiziert. (Kann nur übermittelt werden, wenn der Kartendateneingabemodus "CONTACTLESS", "ICC", "ICCUNRELIABLE", "MAGSTRIPE", "MAGSTRIPEFAILEDICC" oder "MAGSTRIPEPARTIAL" ist) ONLINEPIN - Online-PIN. (kann nur übermittelt werden, wenn der Kartendateneingabemodus "CONTACTLESS", "ICC" oder "ICCUNRELIABLE" ist) OFFLINEPIN - Offline-PIN. (Kann nur übermittelt werden, wenn der Kartendateneingabemodus "ICC" oder "ICCUNRELIABLE" ist)
	currencyiso3a	ISO3A	3	Die Währung der Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
	requesttypedescriptions	Alpha	Maximal 20	Sie müssen "AUTH" eingeben, wie im Beispiel des Antrags gezeigt.
	sitereference	Alphanumerisch & Unterstrich	Maximal 50	Identifiziert Ihre Website auf dem System Trust Payments . Wenn Sie die Anfrage AUTH testen, stellen Sie sicher, dass Sie Ihren Test übermitteln sitereference. Dadurch wird sichergestellt, dass die Transaktionen an unsere Testbank weitergeleitet werden und kein Geld den Besitzer wechselt. Wenn Sie live gehen, müssen Sie Ihren Test sitereference gegen Ihre Live sitereference. Klicken Sie hier, um Testkartennummern zu erhalten, die Sie während der Testphase unter AUTH anfordern können. Wenn Sie Ihre Website-Referenz nicht kennen, wenden Sie sich bitte an unser Support-Team.
	terminalcardcapturecapability	Numerisch	1	Folgende Werte werden unterstützt: 0 - Unbekannt. 1 - Keine Kartenerfassung möglich. 2 - Verfügt über eine Kartenerfassungsfunktion.
	terminalcardoutputcapability	Alphanumerisch	1	Folgende Werte werden unterstützt: 0 - Unbekannt. 1 - Keine. 2 - Magnetstreifen schreiben. 3 - ICC. S - Sonstiges
	terminalid	Numerisch	8	Kennung des POS-Terminals.
	Terminal-Eingangsleistung	Liste der Strings		Legen Sie eine Liste der von diesem Terminal unterstützten Kartendateneingabemodi vor (siehe unten): CONTACTLESS - Fähigkeit, kontaktlose Zahlungen zu akzeptieren (sowohl mobil als auch mit Karte). ICC - Fähigkeit, Zahlungen mit kontaktbehafteten integrierten Schaltkreiskarten (auch bekannt als "Chip und PIN") zu akzeptieren. KEYED - Möglichkeit, Zahlungen zu akzeptieren, bei denen die Kartendaten manuell in das Terminal eingegeben werden. MAGSTRIPE - Möglichkeit zur Annahme von Zahlungen per Durchzug.
	terminal-operationsumgebung	Numerisch	1	Folgende Werte werden unterstützt: 0 - Unbekannt. 1 - Kein Terminal verwendet. 2 - In den Räumen des Kartenakzeptanten, in Begleitung. 3 - Außerhalb der Räumlichkeiten des Kartenakzeptanten, betreut.
	terminal-outputcapability	Char	1	Folgende Werte werden unterstützt: U - Unbekannt. N - Keine. P - Drucken. D - Anzeige. B - Drucken und Anzeigen.
	terminalpentrycapability	Alphanumerisch	1	Folgende Werte werden unterstützt: U - Unbekannt. N - Das Terminal verfügt nicht über die Möglichkeit der PIN-Eingabe. X - Das Terminal verfügt über die Möglichkeit der PIN-Eingabe, aber das PIN-Pad ist derzeit nicht betriebsbereit. O - Sonstiges. 4 - Das Terminal verfügt über eine PIN-Eingabe, 4-stellig. 5 - Das Terminal verfügt über eine PIN-Eingabe, 5-stellig. 6 - Das Terminal verfügt über die Möglichkeit der PIN-Eingabe mit mehr als 6 Ziffern.
	Kartenfolgenummer	Alphanumerisch	Maximal 3	Die Kartenfolgenummer dient zur Identifizierung und Unterscheidung von Karten, die dieselbe PAN haben. Dieser wird als zweistelliger Wert bis "99" übermittelt (diesem kann auch eine 0 vorangestellt werden, z. B. "099"). Muss vorgelegt werden, wenn vorhanden.
	geräteverschlüsseltespan	Alphanumerisch	K.A.	Verschlüsselte PAN Nummer. Je nach Zahlungsart müssen Sie EINES der folgenden Felder ausfüllen: geräteverschlüsseltespan deviceencryptedtrack2data (empfohlen) pan track2data
	deviceencryptedpin	Alphanumerisch	K.A.	Verschlüsselter PIN-Block. Erforderlich, wenn die Online-PIN-Funktionalität ermöglicht wird.
	geräteverschlüsselttrack2data	Alphanumerisch	K.A.	Verschlüsselte Spur-2-Daten. Je nach Zahlungsart müssen Sie EINES der folgenden Felder ausfüllen: geräteverschlüsseltespan deviceencryptedtrack2data (empfohlen) pan track2data
	deviceencryptionkeytype	Alphanumerisch mit Bindestrichen	K.A.	Kann entweder sein: "2DES", "3DES", "AES-128", "AES-192", "AES-256". Wir empfehlen, immer die stärkste Verschlüsselung zu verwenden (in diesem Fall AES-256). Erforderlich, wenn die Felder deviceencryptedpan oder deviceencryptedtrack2data übermittelt werden.
	deviceksn	Alphanumerisch	20-24	Key Serial Number (KSN) der Transaktion. Diese wird vom Verschlüsselungsgerät durch die Verkettung einer eindeutigen Kennung mit einem internen Verschlüsselungszähler bereitgestellt. Erforderlich, wenn die Felder deviceencryptedpan oder deviceencryptedtrack2data übermittelt werden.
	expirydate	Datum MM/JJJJ	Maximal 7	Das auf der Karte aufgedruckte Ablaufdatum. Erforderlich bei der Übermittlung von deviceencryptedpan oder pan.
	iccdata	EMV-Tag-Format	4	Unterstützte Werte: 5F2A, 71, 72, 82, 84, 8A, 91, 95, 9A, 9C, 9F02, 9F03, 9F09, 9F10, 9F1A, 9F1E, 9F26, 9F27, 9F33, 9F34, 9F35, 9F36, 9F37, 9F3B, 9F53, 9F6E, DF31. Erforderlich für ICC, CONTACTLESS, ICCUNRELIABLE.
	pan	Numerisch	12-19	Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist. Je nach Zahlungsart müssen Sie EINES der folgenden Felder ausfüllen: geräteverschlüsseltespan deviceencryptedtrack2data (empfohlen) pan track2data
	track2data	ISO 7813	Maximal 40	Track-2-Daten - dies sind die Informationen, die auf dem Chip oder Magnetstreifen der Kredit-/Debitkarte des Kunden gespeichert sind. Senden Sie diese mit Start-/End-Sentinel und LRC, falls vorhanden. Je nach Zahlungsart müssen Sie EINES der folgenden Felder ausfüllen: geräteverschlüsseltespan deviceencryptedtrack2data (empfohlen) pan track2data
	billingpostcode	Alphanumerisch	Maximal 25	Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a eingereicht werden.
	billingpremise	Alphanumerisch einschließlich Symbole	Maximal 25	Die Hausnummer oder die erste Zeile der Rechnungsadresse des Kunden.
	billingstreet	Alphanumerisch einschließlich Symbole	Maximal 127	Die für die Rechnungsadresse des Kunden eingegebene Straße.
	Cashbackbase-Betrag	Numerisch	Maximal 13	Der vom Kunden gewünschte Cashback-Betrag.
	chargedescription	Alphanumerisch einschließlich Symbole	Maximal 25	Dies ist eine Beschreibung der Zahlung, die auf dem Kontoauszug des Kunden erscheint. Gültige Zeichen: Großbuchstaben/Kleinbuchstaben A-Z Ziffern 0-9 Räume Zeichensetzung: + - _ . @ ( )
	merchantemail	E-Mail	Maximal 255	Die E-Mail-Adresse des Händlers. Maximale Länge von 255 (maximal 64 Zeichen vor dem "@"-Symbol).
	operatorname	Alphanumerisch	Maximal 255	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat. Standardmäßig ist dies der in der Anfrage enthaltene Webdienst-Benutzername. Dies kann durch einen benutzerdefinierten Wert überschrieben werden, indem dieses Feld in der Anfrage übergeben wird (optional).
	orderreference	Alphanumerisch einschließlich Symbole	Maximal 25	Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Hinweis: Dies kann zu einem späteren Zeitpunkt aktualisiert werden (nur wenn die Transaktion noch nicht abgeschlossen ist Abrechnung). Empfohlene Länge 25 Zeichen oder weniger (die genaue Länge hängt von der erwerbenden Bank ab). Die Nichteinhaltung dieser Anforderung kann dazu führen, dass der Text in der Transaktion abgeschnitten wird.
	parenttransactionreference	Alphanumerisch & Bindestriche	Maximal 25	Ermöglicht Ihnen die Angabe der transactionreference einer früheren Anfrage. Die Schlüsseldetails werden von diesem Antrag geerbt.
	paymenttypedescription	Alpha	Maximal 20	Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
	settleduedate	Datum JJJJ-MM-TT	10	Sie können dieses Feld in der Anfrage ausfüllen, um das Datum anzugeben, an dem Sie Ihre Transaktion abrechnen möchten. Dieses Datum muss innerhalb von 7 Tagen nach dem Datum von Autorisierung liegen.
	settlestatus	Numerisch	Maximal 3	Ein numerischer Wert, der zur Definition der Anweisung Abrechnung verwendet wird. Wenn Sie hier keinen Wert eingeben, wird der settlestatus standardmäßig auf "0" gesetzt. Klicken Sie hier, um mehr über den Prozess Abrechnung zu erfahren.

AUTH Antwort

Im Folgenden finden Sie ein Beispiel für eine Antwort von AUTH , die anzeigt, dass die Anfrage erfolgreich bearbeitet wurde.

{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "accounttypedescription": "POS",
    "acquirerresponsecode": "00",
    "acquirerresponsemessage": "Approved or completed Successfully",
    "authcode": "000005",
    "baseamount": "2000",
    "currencyiso3a": "GBP",
    "errorcode": "0",
    "errormessage": "Ok",
    "iccdataresponse": "8A023030",
    "issuer":"Test Issuer",
    "issuercountryiso2a": "GB",
    "livestatus": "0",
    "maskedpan": "411111######1111",
    "merchantcategorycode": "7001",
    "merchantcountryiso2a": "GB",
    "merchantname": "Test Merchant",
    "merchantnumber": "12345",
    "operatorname": "webservices@example.com",
    "orderreference": "MyOrder123",
    "paymenttypedescription": "VISA",
    "requesttypedescription": "AUTH",
    "retrievalreferencenumber": "300316080007",
    "securityresponseaddress": "0",
    "securityresponsepostcode": "0",
    "securityresponsesecuritycode": "0",
    "settleduedate": "2023-01-03",
    "settlestatus": "0",
    "stan": "080007",
    "transactionreference": "8-103-7",
    "transactionstartedtimestamp": "2023-01-03 16:36:53"
  }],
  "secrand":"zO9"
}

Feldspezifikation

Erforderlich	Feld	Format	Länge	Beschreibung
	accounttypedescription	Alpha	Maximal 20	Die Art des Kontos, über das die Transaktion abgewickelt wird. Erwarten Sie bei POS-Transaktionen die Rückgabe von "POS".
	baseamount	Numerisch	Maximal 13	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. €10 werden als 1000 übermittelt. Mastercard kann Cashback-Anträge ablehnen. In diesem Fall wird das Feld cashbackbaseamount mit dem Wert "0" zurückgegeben und dieser Betrag wird ebenfalls von der Gesamtsumme abgezogen. baseamount zurückgegeben.
	currencyiso3a	ISO3A	3	Die Währung der Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
	errorcode	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	Alphanumerisch	Maximal 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.
	Emittent	Alphanumerisch	Maximal 255	Der Kartenaussteller des Kunden.
	issuercountryiso2a	ISO2A	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	Numerisch	1	0 - Die Transaktion wurde über ein Testkonto abgewickelt. 1 - Transaktion wird über ein Live-Konto abgewickelt.
	maskedpan	Alphanumerisch einschließlich "#"	12-19	Das Feld maskedpan Feld steht für die Kartennummer des Kunden. 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.
	merchantnumber	Alphanumerisch	Maximal 32	Die Händlernummer, die zur Bearbeitung der Transaktion verwendet wurde. Wird von der erwerbenden Bank zur Verfügung gestellt.
	operatorname	Alphanumerisch	Maximal 255	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
	paymenttypedescription	Alpha	Maximal 20	Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
	requesttypedescription	Alpha	Maximal 20	"AUTH" wird in der Antwort zurückgegeben.
	securityresponseaddress	Numerisch	1	Das Ergebnis der AVS und Sicherheitscode-Prüfungen. Klicken Sie hier, um mehr zu erfahren.
	securityresponsepostcode	Numerisch	1	Das Ergebnis der AVS und Sicherheitscode-Prüfungen. Klicken Sie hier, um mehr zu erfahren.
	securityresponsesecuritycode	Numerisch	1	Das Ergebnis der AVS und Sicherheitscode-Prüfungen. Klicken Sie hier, um mehr zu erfahren.
	settleduedate	Datum JJJJ-MM-TT	10	Das Datum, an dem die Transaktion abgewickelt wird.
	settlestatus	Numerisch	Maximal 3	Ein numerischer Wert, der verwendet wird, um den Fortschritt von Abrechnung in Bezug auf diese Transaktion anzuzeigen. Klicken Sie hier für eine vollständige Liste der settlestatus Werte.
	transactionreference	Alphanumerisch einschließlich Bindestriche	Maximal 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	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	19	Der Zeitpunkt, zu dem die Transaktion bearbeitet wurde.
	acquirerresponsecode	Alphanumerisch	Maximal 255	Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
	acquirerresponsemessage	Alphanumerisch	Maximal 255	Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
	authcode	Alphanumerisch	Maximal 255	Der Autorisierung Code, der von der ausstellenden Bank bereitgestellt wird. Dieser ist je nach Bank unterschiedlich. Wird nur zurückgegeben, wenn die Transaktion genehmigt ist.
	Cashbackbase-Betrag	Numerisch	Maximal 13	Der vom Kunden gewünschte Cashback-Betrag. Mastercard kann Cashback-Anträge ablehnen. Wenn dies geschieht, wird der Cashback-Basisbetrag mit dem Wert "0" zurückgegeben. Dieses Feld wird zurückgegeben, falls vorhanden.
	chargedescription	Alphanumerisch einschließlich Symbole	Maximal 25	Dies ist eine Beschreibung der Zahlung, die auf dem Kontoauszug des Kunden erscheint. Gültige Zeichen: Großbuchstaben/Kleinbuchstaben A-Z Ziffern 0-9 Räume Zeichensetzung: + - _ . @ ( ) Dieses Feld wird zurückgesendet, wenn es an die erwerbende Bank gesendet wird.
	errordata	Alphanumerisch	Maximal 255	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
	iccdataresponse	EMV-Tag-Format	Maximal 4	ICC-Datenantwort vom Kartenaussteller des Kunden. Nur für ICC, CONTACTLESS, ICCUNRELIABLE zurückgegeben.
	merchantcategorycode	Alphanumerisch	Maximal 255	Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. 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	Alphanumerisch	Maximal 127	Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. 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.
	merchantcountryiso2a	ISO2A	2	Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. 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.
	merchantname	Alphanumerisch	Maximal 255	Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. 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.
	merchantstatecode	Alphanumerisch	Maximal 127	Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. 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.
	merchantzipcode	Alphanumerisch	Maximal 10	Es handelt sich dabei um Angaben zu dem Konto, das für die Bearbeitung der Transaktion verwendet wird. 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.
	orderreference	Alphanumerisch einschließlich Symbole	Maximal 255	Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Hinweis: Dies kann zu einem späteren Zeitpunkt aktualisiert werden (nur wenn die Transaktion noch nicht abgeschlossen ist Abrechnung). Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.
	retrievalreferencenumber	Alphanumerisch	Maximal 255	Ein ISO-Begriff. Dieser wird verwendet, um auf die Quelltransaktion zu verweisen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
	stan	ISO 8583	Unbestimmt	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.
	tid	Alphanumerisch	Maximal 255	Die für die Bearbeitung der Transaktion verwendete Terminal-ID. Diese wird Ihrer Händlernummer zugeordnet, wenn wir Ihr Konto in unserem System 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.

Erstattungstransaktion

REFUND Übersicht

Um eine bearbeitete Transaktion zu erstatten, müssen Sie eine Anfrage an REFUND senden und die zurückgegebene Antwort bearbeiten.

Der Händler/Partner stellt einen Antrag an REFUND .
Trust Payments prüft den Antrag und setzt sich mit der Bank in Verbindung.
Trust Payments wickelt die Erstattung mit dem jeweiligen Erwerber ab.
Trust Payments erhält die Ergebnisse der Anfrage und gibt diese an den Händler/Partner zurück.
Der Händler/Partner erhält diese Antwort und wertet sie aus.

Verarbeitung REFUND

REFUND Anfrage

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "parenttransactionreference":"1-2-345678",
    "requesttypedescriptions":"REFUND",
    "sitereference":"test_site12345"
  }]
}

{
  "alias":"webserv3",
  "version":"1.00",
  "request":[{
    "accounttypedescription":"POS",
    "baseamount":"1000",
    "carddataentrymode":"CONTACTLESS",
    "cardholderauthenticationmethod":"ONLINEPIN",
    "currencyiso3a":"GBP",
    "deviceencryptedpan":"5F9ADEFA3CE08AB0ACD5943FB764E155B29D55A1B98F0C70",
    "deviceencryptedpin":"C9A8FEB60C5B26CD",
    "deviceencryptionkeytype":"AES-256",
    "deviceksn":"1234567822334A0000000001",
    "expirydate":"12/2028",
    "iccdata": "9F02060000000010009F03060000000000009F2608A1B2C3D4E5F6A1B28202A1B29F360200018A02A1B29F3403A1B2C39F2701A18410A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29F3501A19F6E06A1B2C3D4E5F69F1E10313233343536373831323334353637389F1020A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29110A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2DF3114A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D49F5B14A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D47166A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B7219A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A19F0901019F3303015ABC9F1A0208269505A1B2C3D4E59F5301A15F2A0208269A032212129C01009F370400010001",
    "orderreference":"My_Order_123",
    "requesttypedescriptions":"REFUND",
    "sitereference":"test_mikepos76455",
    "terminalcardcapturecapability":"2",
    "terminalcardoutputcapability": "3",
    "terminalid":"12345678",
    "terminalinputcapability":["CONTACTLESS","ICC"],
    "terminaloperatingenvironment":"2",
    "terminaloutputcapability":"B",
    "terminalpinentrycapability":"4"
  }]
}

Feldspezifikation

Erforderlich	Feld	Format	Länge	Beschreibung
	requesttypedescriptions	Alpha	Maximal 20	Die erforderliche Anforderungstyp ist "REFUND".
	sitereference	Alphanumerisch & Unterstrich	Maximal 50	Eine eindeutige Referenz, die Ihr Konto identifiziert. Sie erhalten diese, wenn Sie sich zum ersten Mal bei uns anmelden. Die in der Anfrage REFUND angegebene Website-Referenz muss dieselbe sein wie die Website-Referenz , die für die Bearbeitung der übergeordneten AUTH Anfrage verwendet wurde.
	accounttypedescription	Alpha	Maximal 20	Die Art des Kontos, das für die Verarbeitung der Transaktion verwendet wird. Geben Sie "POS" ein, wenn Sie POS-Transaktionen verarbeiten. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	baseamount	Numerisch	Maximal 13	Der Erstattungsbetrag in Basiseinheiten ohne Kommas oder Dezimalpunkte, d. h. 10 £ werden als 1000 £ angegeben. Dieser Betrag kann nicht höher sein als der endgültige Betrag, der auf Ihr Bankkonto überwiesen wird. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen. Wenn parenttransactionreference übermittelt wird, wird der volle baseamount von der übergeordneten Transaktion geerbt (einschließlich aller Cashbacks, die in der ursprünglichen Transaktion angegeben wurden), es sei denn, sie wird durch die Übermittlung eines niedrigeren Wertes im Feld baseamount Feld.
	Kartendateneingabemodus	Alpha	Maximal 18	Folgende Werte werden unterstützt: CONTACTLESS - Auto über kontaktlosen M/Chip. ICC - Auto über ICC. ICCUNRELIABLE - Die Daten wurden per Chip gelesen und sind möglicherweise unzuverlässig. MAGSTRIPE - Auto über Magnetstreifen. MAGSTRIPEFAILEDICC - Auto via Mag Stripe - Fallback, wenn Auto via ICC fehlgeschlagen ist. MAGSTRIPEPARTIAL - Auto über Magnetstreifen, aber Magnetstreifendaten nicht vollständig gelesen/übertragen. Wenn Sie eine Online-PIN-Transaktion ermöglichen, können Sie nur CONTACTLESS, ICC oder ICCUNRELIABLE eingeben. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	karteninhaber-authentifizierungsmethode	Alpha	Maximal 15	Folgende Werte werden unterstützt: SIGNATURE - Unterschrift. (Kann nur übermittelt werden, wenn der Kartendateneingabemodus "CONTACTLESS", "ICC", "ICCUNRELIABLE", "MAGSTRIPE", "MAGSTRIPEFAILEDICC" oder "MAGSTRIPEPARTIAL" ist) MOBILEDEVICECVM - CVM, durchgeführt von einem mobilen Gerät. (Kann nur übermittelt werden, wenn carddataentrymode "CONTACTLESS" ist) NOCVM - Nicht authentifiziert. (Kann nur übermittelt werden, wenn der Kartendateneingabemodus "CONTACTLESS", "ICC", "ICCUNRELIABLE", "MAGSTRIPE", "MAGSTRIPEFAILEDICC" oder "MAGSTRIPEPARTIAL" ist) ONLINEPIN - Online-PIN. (kann nur übermittelt werden, wenn der Kartendateneingabemodus "CONTACTLESS", "ICC" oder "ICCUNRELIABLE" ist) OFFLINEPIN - Offline-PIN. (Kann nur übermittelt werden, wenn der Kartendateneingabemodus "ICC" oder "ICCUNRELIABLE" ist) Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	Kartenfolgenummer	Alphanumerisch	Maximal 3	Die Kartenfolgenummer dient zur Identifizierung und Unterscheidung von Karten, die dieselbe PAN haben. Dieser wird als zweistelliger Wert bis "99" übermittelt (diesem kann auch eine 0 vorangestellt werden, z. B. "099"). Dieses Feld muss angegeben werden, wenn es verfügbar ist, es sei denn, parenttransactionreference wird angegeben, dann werden die Daten stattdessen von der zu erstattenden Transaktion übernommen.
	currencyiso3a	ISO3A	3	Die Währung der Erstattung. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	geräteverschlüsseltespan	Alphanumerisch	K.A.	Verschlüsselte PAN Nummer. Wenn parenttransactionreference übermittelt wird, werden die Daten aus der zu erstattenden Transaktion übernommen. Wenn nicht angegeben, müssen Sie stattdessen EINES der folgenden Felder übermitteln: geräteverschlüsseltespan deviceencryptedtrack2data (empfohlen) pan track2data
	deviceencryptedpin	Alphanumerisch	K.A.	Verschlüsselter PIN-Block. Erforderlich, wenn die Online-PIN-Funktionalität ermöglicht wird.
	geräteverschlüsselttrack2data	Alphanumerisch	K.A.	Verschlüsselte Spur-2-Daten. Wenn parenttransactionreference übermittelt wird, werden die Daten aus der zu erstattenden Transaktion übernommen. Wenn nicht angegeben, müssen Sie stattdessen EINES der folgenden Felder übermitteln: geräteverschlüsseltespan deviceencryptedtrack2data (empfohlen) pan track2data
	deviceencryptionkeytype	Alphanumerisch mit Bindestrichen	K.A.	Kann entweder sein: "2DES", "3DES", "AES-128", "AES-192", "AES-256". Wir empfehlen, immer die stärkste Verschlüsselung zu verwenden (in diesem Fall AES-256). Erforderlich, wenn die Felder deviceencryptedpan oder deviceencryptedtrack2data übermittelt werden.
	deviceksn	Alphanumerisch	20-24	Key Serial Number (KSN) der Transaktion. Diese wird vom Verschlüsselungsgerät durch die Verkettung einer eindeutigen Kennung mit einem internen Verschlüsselungszähler bereitgestellt. Erforderlich, wenn die Felder deviceencryptedpan oder deviceencryptedtrack2data übermittelt werden.
	expirydate	Datum MM/JJJJ	Maximal 7	Dieses Feld wird verwendet, um eine Erstattung mit aktualisiertem Verfallsdatum zu bearbeiten. Erforderlich bei der Übermittlung von deviceencryptedpan.
	iccdata	EMV-Tag-Format	4	Unterstützte Werte: 5F2A, 71, 72, 82, 84, 8A, 91, 95, 9A, 9C, 9F02, 9F03, 9F09, 9F10, 9F1A, 9F1E, 9F26, 9F27, 9F33, 9F34, 9F35, 9F36, 9F37, 9F3B, 9F53, 9F6E, DF31. Erforderlich für ICC, CONTACTLESS und ICCUNRELIABLE, es sei denn, die parenttransactionreference wird eingereicht, um stattdessen Daten aus der zu erstattenden Transaktion zu übernehmen.
	pan	Numerisch	12-19	Dies ist die lange Nummer, die auf der Vorderseite der Kundenkarte aufgedruckt ist. Wenn parenttransactionreference übermittelt wird, werden die Daten aus der zu erstattenden Transaktion übernommen. Wenn nicht angegeben, müssen Sie stattdessen EINES der folgenden Felder übermitteln: geräteverschlüsseltespan deviceencryptedtrack2data (empfohlen) pan track2data
	parenttransactionreference	Alphanumerisch & Bindestriche	Maximal 25	Dieses Feld muss die Transaktionsnummer des Antrags enthalten AUTH Antrag, den Sie erstatten möchten. Entweder muss parenttransactionreference die Daten aus der zu erstattenden Transaktion übernehmen, oder es müssen stattdessen die folgenden Felder übermittelt werden: accounttypedescription baseamount Kartendateneingabemodus karteninhaber-authentifizierungsmethode Kartenfolgenummer currencyiso3a Nur EINE der folgenden Möglichkeiten: deviceencryptedpan, deviceencryptedtrack2data, pan oder track2data deviceencryptedpin deviceencryptionkeytype deviceksn expirydate (Nur erforderlich, wenn deviceencryptedpan oder pan eingereicht wird) iccdata (nur erforderlich für ICC, CONTACTLESS und ICCUNRELIABLE) terminalcardcapturecapability terminalcardoutputcapability terminalid Terminal-Eingangsleistung terminal-operationsumgebung terminal-outputcapability terminalpentrycapability track2data Wenn Sie die parenttransactionreference um die Erstattung durchzuführen, beachten Sie bitte, dass standardmäßig der volle baseamount zurückerstattet wird (einschließlich des Cashback-Basisbetrags, falls zutreffend). Sie können dieses Verhalten außer Kraft setzen, indem Sie einen niedrigeren baseamount in der Anfrage angeben.
	terminalcardcapturecapability	Numerisch	1	Folgende Werte werden unterstützt: 0 - Unbekannt. 1 - Keine Kartenerfassung möglich. 2 - Verfügt über eine Kartenerfassungsfunktion. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	terminalcardoutputcapability	Alphanumerisch	1	Folgende Werte werden unterstützt: 0 - Unbekannt. 1 - Keine. 2 - Magnetstreifen schreiben. 3 - ICC. S - Sonstiges Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	terminalid	Numerisch	8	Kennung des POS-Terminals. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	Terminal-Eingangsleistung	Liste der Strings		Legen Sie eine Liste der von diesem Terminal unterstützten Kartendateneingabemodi vor (siehe unten): CONTACTLESS - Fähigkeit, kontaktlose Zahlungen zu akzeptieren (sowohl mobil als auch mit Karte). ICC - Fähigkeit, Zahlungen mit kontaktbehafteten integrierten Schaltkreiskarten (auch bekannt als "Chip und PIN") zu akzeptieren. KEYED - Möglichkeit, Zahlungen zu akzeptieren, bei denen die Kartendaten manuell in das Terminal eingegeben werden. MAGSTRIPE - Möglichkeit zur Annahme von Zahlungen per Durchzug. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	terminal-operationsumgebung	Numerisch	1	Folgende Werte werden unterstützt: 0 - Unbekannt. 1 - Kein Terminal verwendet. 2 - In den Räumen des Kartenakzeptanten, in Begleitung. 3 - Außerhalb der Räumlichkeiten des Kartenakzeptanten, betreut. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	terminal-outputcapability	Char	1	Folgende Werte werden unterstützt: U - Unbekannt. N - Keine. P - Drucken. D - Anzeige. B - Drucken und Anzeigen. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	terminalpentrycapability	Alphanumerisch	1	Folgende Werte werden unterstützt: U - Unbekannt. N - Das Terminal verfügt nicht über die Möglichkeit der PIN-Eingabe. X - Das Terminal verfügt über die Möglichkeit der PIN-Eingabe, aber das PIN-Pad ist derzeit nicht betriebsbereit. O - Sonstiges. 4 - Das Terminal verfügt über eine PIN-Eingabe, 4-stellig. 5 - Das Terminal verfügt über eine PIN-Eingabe, 5-stellig. 6 - Das Terminal verfügt über die Möglichkeit der PIN-Eingabe mit mehr als 6 Ziffern. Dieses Feld muss ausgefüllt werden, es sei denn, die parenttransactionreference soll stattdessen Daten aus der zu erstattenden Transaktion übernehmen.
	track2data	ISO 7813	Maximal 40	Track-2-Daten - dies sind die Informationen, die auf dem Chip oder Magnetstreifen der Kredit-/Debitkarte des Kunden gespeichert sind. Senden Sie diese mit Start-/End-Sentinel und LRC, falls vorhanden. Wenn parenttransactionreference übermittelt wird, werden die Daten aus der zu erstattenden Transaktion übernommen. Wenn nicht angegeben, müssen Sie stattdessen EINES der folgenden Felder übermitteln: geräteverschlüsseltespan deviceencryptedtrack2data (empfohlen) pan track2data
	chargedescription	Alphanumerisch einschließlich Symbole	Maximal 25	Dies ist eine Beschreibung der Zahlung, die auf dem Kontoauszug des Kunden erscheint. Gültige Zeichen: Großbuchstaben/Kleinbuchstaben A-Z Ziffern 0-9 Räume Zeichensetzung: + - _ . @ ( )
	orderreference	Alphanumerisch einschließlich Symbole	Maximal 25	Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Wird dieser nicht eingereicht, wird er vom übergeordneten Antrag AUTH geerbt.
	paymenttypedescription	Alpha	Maximal 20	Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").

REFUND Antwort

{
  "requestreference":"W23-22rd4301",
  "version":"1.00",
  "response":[{
    "accounttypedescription":"POS",
    "acquirerresponsecode":"00",
    "acquirerresponsemessage": "Approved or completed Successfully",
    "authcode":"TEST REFUND ACCEPTED",
    "baseamount":"2000",
    "currencyiso3a":"GBP",
    "errorcode":"0",
    "errormessage":"Ok",
    "issuer":"SecureTrading Test Issuer1",
    "issuercountryiso2a":"US",
    "livestatus":"0",
    "maskedpan":"411111######1111",
    "merchantcategorycode": "7001",
    "merchantcountryiso2a":"GB",
    "merchantname":"Test Merchant",
    "merchantnumber":"00000000",
    "operatorname":"webservices@example.com",
    "orderreference":"My_Order_123",
    "parenttransactionreference":"1-2-345678",
    "paymenttypedescription":"VISA",
    "requesttypedescription":"REFUND",
    "securityresponseaddress":"0",
    "securityresponsepostcode":"0",
    "securityresponsesecuritycode":"0",
    "settleduedate":"2016-12-07",
    "settlestatus":"0",
    "transactionreference":"1-2-345679",
    "transactionstartedtimestamp":"2016-12-07 15:31:48"
  }],
  "secrand":"SNQVg"
}

Feldspezifikation

Erforderlich	Feld	Format	Länge	Beschreibung
	accounttypedescription	Alpha	Maximal 20	Die Art des Kontos, das für die Bearbeitung der Erstattung verwendet wird. Erwarten Sie bei POS-Transaktionen die Rückgabe von "POS".
	baseamount	Numerisch	Maximal 13	Der Erstattungsbetrag in Basiseinheiten, ohne Kommas oder Dezimalpunkte, d. h. 10 £ werden als 1000 £ angegeben.
	currencyiso3a	ISO3A	Maximal 3	Die Währung der Erstattung. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
	errorcode	Numerisch	1-5	Die Website Fehlercode sollte verwendet werden, um festzustellen, ob die Erstattung erfolgreich war oder nicht. Wenn die Fehlercode "0" lautet, war die Erstattung erfolgreich. Wenn die Fehlercode nicht "0" ist, war die Erstattung nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerten.
	errormessage	Alphanumerisch	Maximal 255	Hier finden Sie eine kurze Erklärung für die Fehlerursache. Bei erfolgreichen Erstattungen wird dies als "Ok" zurückgegeben. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerten.
	Emittent	Alphanumerisch	Maximal 255	Der Kartenaussteller des Kunden.
	issuercountryiso2a	ISO2A	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	Numerisch	1	0 - Die Erstattung wird über ein Testkonto abgewickelt. 1 - Die Erstattung wird über ein Live-Konto abgewickelt.
	maskedpan	Alphanumerisch einschließlich "#"	12-19	Das Feld maskedpan Feld steht für die Kartennummer des Kunden. 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.
	merchantnumber	Alphanumerisch	Maximal 32	Die Händlernummer, die für die Bearbeitung der Erstattung verwendet wurde. Wird von der erwerbenden Bank zur Verfügung gestellt.
	operatorname	Alphanumerisch	Maximal 255	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Erstattung bearbeitet hat.
	paymenttypedescription	Alpha	Maximal 20	Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
	requesttypedescription	Alpha	Maximal 20	"REFUND" wird in der Antwort zurückgegeben.
	securityresponseaddress	Numerisch	1	Das Ergebnis der AVS und Sicherheitscode-Prüfungen. Klicken Sie hier, um mehr zu erfahren.
	securityresponsepostcode	Numerisch	1	Das Ergebnis der AVS und Sicherheitscode-Prüfungen. Klicken Sie hier, um mehr zu erfahren.
	securityresponsesecuritycode	Numerisch	1	Das Ergebnis der AVS und Sicherheitscode-Prüfungen. Klicken Sie hier, um mehr zu erfahren.
	settleduedate	Datum JJJJ-MM-TT	10	Das Datum, an dem die Erstattung abgewickelt wird.
	settlestatus	Numerisch	Maximal 3	Ein numerischer Wert, der verwendet wird, um den Fortschritt von Abrechnung bezüglich dieser Erstattung anzuzeigen. Klicken Sie hier für eine vollständige Liste der settlestatus Werte.
	transactionreference	Alphanumerisch mit Bindestrichen	Maximal 25	Eine eindeutige Referenz für die Erstattung, die von Trust Payments zugewiesen wurde. Sie benötigen diese Referenz, um die Erstattung zu aktualisieren.
	transactionstartedtimestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Maximal 19	Der Zeitpunkt, zu dem die Erstattung bearbeitet wurde.
	acquirerresponsecode	Alphanumerisch	Maximal 255	Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
	acquirerresponsemessage	Alphanumerisch	Maximal 255	Wird von Ihrem Acquirer verwendet, um das Ergebnis der Anfrage anzuzeigen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
	authcode	Alphanumerisch	Maximal 255	Der Autorisierung Code, der von der ausstellenden Bank bereitgestellt wird. Dieser ist je nach Bank unterschiedlich. Nur zurückgegeben, wenn die Erstattung genehmigt ist.
	Cashbackbase-Betrag	Numerisch	Maximal 13	Der vom Kunden gewünschte Cashback-Betrag. Dieses Feld wird zurückgegeben, falls vorhanden.
	errordata	Alphanumerisch	Maximal 255	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
	merchantcategorycode	Alphanumerisch	Maximal 255	Dies sind die Angaben zu dem Konto, das für die Bearbeitung der Erstattung verwendet wird. 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	Alphanumerisch	Maximal 127	Dies sind die Angaben zu dem Konto, das für die Bearbeitung der Erstattung verwendet wird. 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.
	merchantcountryiso2a	ISO2A	Maximal 2	Dies sind die Angaben zu dem Konto, das für die Bearbeitung der Erstattung verwendet wird. 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.
	merchantname	Alphanumerisch	Maximal 255	Dies sind die Angaben zu dem Konto, das für die Bearbeitung der Erstattung verwendet wird. 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.
	merchantstatecode	Alphanumerisch	Maximal 127	Dies sind die Angaben zu dem Konto, das für die Bearbeitung der Erstattung verwendet wird. 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.
	merchantzipcode	Alphanumerisch	Maximal 10	Dies sind die Angaben zu dem Konto, das für die Bearbeitung der Erstattung verwendet wird. 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.
	orderreference	Alphanumerisch einschließlich Symbole	Maximal 255	Ihre eindeutige Auftragsnummer, die im System Trust Payments gespeichert werden kann. Hinweis: Dies kann zu einem späteren Zeitpunkt aktualisiert werden (nur wenn die Erstattung noch aussteht Abrechnung). Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.
	parenttransactionreference	Alphanumerisch mit Bindestrichen	Maximal 25	Die transactionreference des zu erstattenden Vorgangs, von dem die wichtigsten Details übernommen wurden. Dieses Feld wird zurückgegeben, wenn es in der Anfrage übermittelt wurde.
	retrievalreferencenumber	Alphanumerisch	Maximal 255	Ein ISO-Begriff. Dieser wird verwendet, um auf die Quellenerstattung zu verweisen. Dies hängt von Ihrer Bank ab. Bitte kontaktieren Sie Ihre Bank für weitere Informationen.
	tid	Alphanumerisch	Maximal 255	Die für die Bearbeitung der Erstattung verwendete Terminal-ID. Diese wird Ihrer Händlernummer zugeordnet, wenn wir Ihr Konto in unserem System 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.

Transaktion aktualisieren

TRANSACTIONUPDATE Übersicht

Um eine verarbeitete Transaktion zu aktualisieren, müssen Sie eine TRANSACTIONUPDATE Anfrage stellen und die zurückgegebene Antwort bearbeiten. Die Anfrage TRANSACTIONUPDATE besteht aus Filtern und Aktualisierungen.

Filter
- Betrachten Sie die Filter als Suchkriterien. Trust Payments wird diese verwenden, um die zu aktualisierende Transaktion zu finden, die Aktualisierungen, wenn möglich, durchzuführen und eine Antwort als Bestätigung zurückzusenden.
- Zum Beispiel würde ein Filter mit transactionreference "1-2-345" würde die Transaktion finden und aktualisieren, die dieser Referenz entspricht.
Aktualisierungen
- Es gibt eine Reihe von Feldern, die aktualisiert werden können, wie in der folgenden Spezifikation beschrieben.
- So kann zum Beispiel eine ausstehende Transaktion storniert werden, indem die settlestatus auf "3" aktualisiert wird, woraufhin die reservierten Mittel auf dem Konto des Kunden automatisch storniert werden.
- Die Website settlebaseamount kann auch aktualisiert werden, um einen niedrigeren Zahlungsbetrag als den ursprünglich genehmigten zu begleichen.

Verarbeitung TRANSACTIONUPDATE

TRANSACTIONUPDATE Anfrage

Im Folgenden finden Sie Beispiele für TRANSACTIONUPDATE :

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"issuerscriptresults":"8A023030A1"}
  }]
}

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"settlestatus":"2"}
  }]
}

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"settlestatus":"1"}
  }]
}

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"settlestatus":"3"}
  }]
}

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"settlebaseamount":"100"}
  }]
}

Spezifikation des Filterfeldes

Erforderlich	Feld	Format	Länge	Beschreibung
	sitereference	Alphanumerisch einschließlich Unterstrich	Maximal 50	Die eindeutige Referenz für die Website Trust Payments , die mit der zu aktualisierenden Transaktion verbunden ist.
	transactionreference	Alphanumerisch mit Bindestrichen	Maximal 25	Die eindeutige Referenz Trust Payments für die Transaktion, die Sie aktualisieren möchten.

Aktualisiert die Feldspezifikation

Die folgenden Felder können bei der Aktualisierung von AUTH und REFUND Anfragen aktualisiert werden.

Erforderlich	Feld	Format	Länge	Beschreibung
	issuerscriptresults	Hexadezimal (0-9, A-F)	10	Wird nur unterstützt, wenn AUTH mit einer Antwort aktualisiert wird, die iccdataresponse enthält. Vom Kartenaussteller des Kunden gesendete Befehle (so genannte "Issuer Scripts") können aus der iccdataresponse extrahiert werden. Sobald das Terminal diese Befehle gegen die Karte ausgeführt hat, können die Ergebnisse als Aktualisierung der Transaktion über das Feld issuerscriptresults übermittelt werden. Am besten führen Sie diesen Schritt nach der Bearbeitung einer AUTH Anfrage durch, damit unsere Unterlagen auf dem neuesten Stand sind.
	orderreference	Alphanumerisch einschließlich Symbole	Maximal 25	Aktualisierung der eindeutigen Auftragsreferenz, die im System Trust Payments gespeichert werden kann.
	settlebaseamount	Numerisch	Maximal 13	Der Betrag der Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, also €10,50 wäre 1050. Dieser Wert muss über Null liegen und kleiner oder gleich dem ursprünglichen Genehmigungsbetrag sein.
	settleduedate	Datum JJJJ-MM-TT	Maximal 10	Datum, an dem die Transaktion abgewickelt wird. Wenn heute oder früher, wird die Transaktion bei der Abrechnung das nächste Mal ausgeführt wird (sofern nicht ausgesetzt oder abgebrochen).
	settlestatus	Numerisch	Maximal 3	Dieser Wert bezieht sich auf den Status der Transaktion.

TRANSACTIONUPDATE Antwort

Nachstehend finden Sie ein Beispiel für eine Antwort von TRANSACTIONUPDATE , die nach einer erfolgreichen Aktualisierung einer Transaktion zurückgegeben wurde.

{
  "requestreference":"W23-tkrxwkc6",
  "version":"1.00",
  "response":[{
    "errorcode":"0",
    "errormessage":"Ok",
    "requesttypedescription":"TRANSACTIONUPDATE",
    "transactionstartedtimestamp":"2019-12-17 10:58:20"
  }],
  "secrand":"SptlJutnBnQ"
}

Vergewissern Sie sich, dass Fehlercode "0" lautet. Dies bedeutet, dass die Anfrage TRANSACTIONUPDATE erfolgreich verarbeitet wurde. Wenn Fehlercode nicht "0" ist, wurde die Anfrage möglicherweise nicht wie erwartet verarbeitet.

Feldspezifikation

Erforderlich	Feld	Format	Länge	Beschreibung
	errorcode	Numerisch	Maximal 5	Die Fehlercode sollte verwendet werden, um festzustellen, ob die Aktualisierung erfolgreich war oder nicht. Wenn die Fehlercode "0" ist, war die Aktualisierung erfolgreich. Die Fehlercode "20004" (Missing parent) kann manchmal zurückgegeben werden, wenn Sie eine Aktualisierung zu früh nach der Verarbeitung der ersten Anfrage versuchen. Warten Sie in diesem Fall ein paar Sekunden und versuchen Sie es erneut. Wenn die Fehlercode nicht "0" ist, war die Aktualisierung nicht erfolgreich. Klicken Sie hier für eine vollständige Liste der errorcode und Nachrichtenwerten.
	errormessage	Alphanumerisch	Maximal 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.
	requesttypedescription	Alpha	Maximal 20	"TRANSACTIONUPDATE" wird in der Antwort zurückgegeben.
	transactionstartedtimestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	19	Der Zeitpunkt, zu dem die Aktualisierung durchgeführt wurde.
	errordata	Alphanumerisch	Maximal 255	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.

Abfrage der Transaktion

TRANSACTIONQUERY Übersicht

Um Details und den Status einer bearbeiteten Transaktion zu überprüfen, müssen Sie eine Anfrage an TRANSACTIONQUERY senden und die zurückgegebene Antwort bearbeiten.

Filter
- Die Anfrage TRANSACTIONQUERY besteht hauptsächlich aus Filtern. Stellen Sie sich die Filter als Suchkriterien vor; die zurückgegebene Antwort enthält Informationen, die den angegebenen Filtern entsprechen.
- Zum Beispiel würde ein Filter mit transactionreference "1-2-345" die gespeicherten Details für diese Transaktion zurückgeben.
Erweiterte Suche
- Wenn eine Abfrage auf mehrere Anfragen zutrifft, werden alle Anfragen in einer einzigen Antwort zurückgegeben. Wenn Sie dies vermeiden möchten, empfehlen wir Ihnen, Ihre Anfrage so spezifisch wie möglich zu formulieren und so viele Filter wie nötig zu übermitteln.
- Wenn Sie beispielsweise einen Start- und einen Endzeitstempel angeben, erhalten Sie Details zu allen Anfragen, die zwischen den angegebenen Zeitpunkten auf Ihrem Konto bearbeitet wurden.
- Sie können auch mehrere Werte für jeden gegebenen Filter übermitteln. Sie können z. B. einen Filter für die transactionreference Werte "23-9-1" und "23-9-2" übermitteln, und alle Anfragen, die diesen Werten entsprechen, werden in der Antwort zurückgegeben. (Ein Beispiel für diesen Fall finden Sie weiter unten)

Verarbeitung TRANSACTIONQUERY

TRANSACTIONQUERY Anfrage

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

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONQUERY"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"23-9-1"},{"value":"23-9-2"}]
    }
  }]
}

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 der sitereference 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.

Erforderlich	Feld	Format	Länge	Beschreibung
	accounttypedescription	Alpha	Maximal 20	Die Art des Kontos, das für die Bearbeitung der Anfrage verwendet wird. Geben Sie "POS" ein, um POS-Transaktionen zu filtern.
	billingpostcode	Alphanumerisch einschließlich Symbole	Maximal 25	Die Rechnungspostleitzahl oder die Postleitzahl. Es muss sich um eine gültige Postleitzahl für den billingcountryiso2a eingereicht werden.
	billingpremise	Alphanumerisch einschließlich Symbole	Maximal 20	Die Nummer oder der Name der Verbrauchsstelle mit der Rechnungsadresse des Kunden.
	billingstreet	Alphanumerisch einschließlich Symbole	Maximal 20	Der Straßenname der Rechnungsadresse des Kunden.
	currencyiso3a	ISO3A	3	Die Transaktion Währung. Klicken Sie hier für eine vollständige Liste der Währung Codes.
	endtimestamp	Datum Uhrzeit JJJJ-MM-TT HH:MM:SS	Maximal 19	Nur Anfragen, die vor dem angegebenen Zeitstempel bearbeitet wurden, werden zurückgegeben. (Anders als bei anderen Filtern können Sie nur einen Endzeitstempel in einer Anfrage übermitteln)
	orderreference	Alphanumerisch einschließlich Symbole	Maximal 25	Eindeutige Referenznummer, die Sie für den Antrag angeben.
	pan	Numerisch	12-19	Dies ist die Kartennummer, die auf der Vorderseite der Karte des Kunden aufgedruckt ist.
	parenttransactionreference	Alphanumerisch mit Bindestrichen	Maximal 25	Eindeutige Referenz der übergeordneten Anfrage.
	paymenttypedescription	Alpha	Maximal 20	Der Kartentyp des Kunden (z. B. "VISA" oder "MASTERCARD").
	requesttypedescription	Alpha	Maximal 20	Die mit der Transaktion verbundene Anforderungstyp . Zum Beispiel: "AUTH" oder "REFUND". Klicken Sie hier für eine vollständige Liste der Antragsarten.
	starttimestamp	Datum Uhrzeit JJJJ-MM-TT HH:MM:SS	Maximal 19	Nur Anfragen, die nach dem angegebenen Zeitstempel bearbeitet wurden, werden zurückgegeben. (Anders als bei anderen Filtern können Sie nur einen Startzeitstempel in einer Anfrage übermitteln)
	transactionreference	Alphanumerisch mit Bindestrichen	Maximal 25	Die eindeutige Referenz, die der Transaktion zugeordnet ist und von Trust Payments zugewiesen wird.
	sitereference	Alpha	Maximal 50	Die Website-Referenz, die die Transaktion bearbeitet hat. Der Filter sitereference muss mit mindestens einem anderen Filter übermittelt werden, andernfalls wird ein Fehler zurückgegeben.

TRANSACTIONQUERY Antwort

Wenn Sie eine Anfrage an TRANSACTIONQUERY erfolgreich gestellt haben, erhalten Sie eine Antwort, die in einzelne Datensätze unterteilt ist.

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 die Feldspezifikation in der Autorisierung beziehen.

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

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

{"requestreference":"W72-pg3q2he9",
  "version":"1.00",
  "response":[{
    "errorcode":"0",
    "errormessage":"Ok",
    "found":"2",
    "records":[{
      "accounttypedescription":"POS",
      "acquirerresponsecode":"00",
      "acquirerresponsemessage": "Approved or completed Successfully",
      "authcode":"TEST22",
      "baseamount":"1050",
      "currencyiso3a":"GBP",
      "errorcode":"0",
      "errormessage":"Ok",
      "expirydate":"10\/2022",
      "fraudrating":"0",
      "interface":"PASS-JSON-JSON",
      "issuer":"Test Issuer",
      "issuercountryiso2a":"GB",
      "livestatus":"0",
      "maskedpan":"411111######1111",
      "merchantcategorycode": "7001",
      "merchantcountryiso2a":"GB",
      "merchantname":"Test Merchant",
      "operatorname":"webservices@example.com",
      "orderreference":"My_Order_123",
      "paymenttypedescription":"VISA",
      "requesttypedescription":"AUTH",
      "retrievalreferencenumber": "300316080007",
      "securityresponseaddress":"0",
      "securityresponsepostcode":"0",
      "securityresponsesecuritycode":"2",
      "settlebaseamount":"1050",
      "settleduedate":"2019-12-17",
      "settlestatus":"0",
      "sitereference":"test_site12345",
      "terminalid":"12345678",
      "transactionreference":"23-9-1",
      "transactionstartedtimestamp":"2019-12-17 09:35:03"
    },
    {
      "accounttypedescription":"POS",
      "acquirerresponsecode":"00",
      "acquirerresponsemessage": "Approved or completed Successfully",
      "authcode":"TEST03",
      "baseamount":"1050",
      "currencyiso3a":"GBP",
      "errorcode":"0",
      "errormessage":"Ok",
      "expirydate":"10\/2022",
      "fraudrating":"0",
      "interface":"PASS-JSON-JSON",
      "issuer":"SecureTrading Test Issuer1",
      "issuercountryiso2a":"US",
      "livestatus":"0",
      "maskedpan":"411111######1111",
      "merchantcategorycode": "7001",
      "merchantcountryiso2a":"GB",
      "merchantname":"Test Merchant",
      "operatorname":"webservices@example.com",
      "orderreference":"My_Order_123",
      "paymenttypedescription":"VISA",
      "requesttypedescription":"AUTH",
      "retrievalreferencenumber": "300316080007",
      "securityresponseaddress":"0",
      "securityresponsepostcode":"0",
      "securityresponsesecuritycode":"2",
      "settlebaseamount":"1050",
      "settleduedate":"2019-12-17",
      "settlestatus":"0",
      "sitereference":"test_site12345",
      "terminalid":"12345678",
      "transactionreference":"23-9-2",
      "transactionstartedtimestamp":"2019-12-17 09:35:10"
    }],
    "requesttypedescription":"TRANSACTIONQUERY",
    "transactionstartedtimestamp":"2019-12-17 09:36:21"
  }],
  "secrand":"uISZfw8wKWR"
}

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

Das Feld " Gefunden" gibt niemals einen höheren Wert als 500 zurück, 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 Antwort, zusammen mit transactionstartedtimestamp und gefunden, befindet sich ein errorcode. Dies zeigt an, ob die Anfrage TRANSACTIONQUERY 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 enthält jeder Datensatz seine eigene errorcode. Dies zeigt an, ob die im Datensatz dargestellte Anfrage 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 aufgeführt, die in einem bestimmten Datensatz zurückgegeben werden können.

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

Erforderlich	Feld	Format	Länge	Beschreibung
	accounttypedescription	Alpha	Maximal 20	Die Art des Kontos, das für die Bearbeitung der abgefragten Anfrage verwendet wird. Bei der Abfrage von POS-Transaktionen ist die Rückgabe von "POS" zu erwarten.
	baseamount	Numerisch	Maximal 13	Der Betrag der abgefragten Transaktion in Basiseinheiten, ohne Kommas oder Dezimalpunkte, so dass 10€ als 1000 übermittelt wird. Mastercard kann Cashback-Anträge ablehnen. In diesem Fall wird das Feld cashbackbaseamount mit dem Wert "0" zurückgegeben und dieser Betrag wird ebenfalls von der Gesamtsumme abgezogen. baseamount zurückgegeben.
	currencyiso3a	ISO3A	3	Die Währung der abgefragten Transaktion. Klicken Sie hier für eine vollständige Liste der verfügbaren Währungen.
	errorcode	Numerisch	Maximal 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 Nachrichtenwerten.
	errormessage	Alphanumerisch	Maximal 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.
	Schnittstelle	Alphanumerisch einschließlich Symbole	Maximal 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 Payout terminal). "PASS-JSON-JSON" - Webservices API mit JSON-Auszeichnung. "PASS-XML-XML" - Webservices API mit XML-Auszeichnung.
	livestatus	Numerisch	1	0 - Die abgefragte Transaktion wurde über ein Testkonto abgewickelt. 1 - Die abgefragte Transaktion wurde über ein Live-Konto abgewickelt.
	maskedpan	Alphanumerisch einschließlich "#"	12-19	Das Feld maskedpan Feld steht für die Kartennummer des Kunden. 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.
	operatorname	Alphanumerisch	Maximal 255	Der Wert dieses Feldes enthält den Namen des Benutzers, der die Anfrage bearbeitet hat.
	paymenttypedescription	Alpha	Maximal 20	Zahlungsmethode (z. B. "VISA" oder "MASTERCARD").
	requesttypedescription	Alpha	Maximal 20	Die Art der im Datensatz zurückgegebenen Anfrage.
	settlebaseamount	Numerisch	Maximal 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.
	settleduedate	Datum JJJJ-MM-TT	Maximal 10	Das Datum, an dem die abgefragte Transaktion abgewickelt wird.
	settlestatus	Numerisch	Maximal 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.
	sitereference	Alphanumerisch & Unterstrich	Maximal 50	Die Website-Referenz , über die die abgefragte Anfrage bearbeitet wurde.
	terminalid	Alphanumerisch	8	Kennung des POS-Terminals.
	transactionreference	Alphanumerisch einschließlich Bindestriche	Maximal 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.
	transactionstartedtimestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Maximal 19	Der Zeitpunkt, zu dem die abgefragte Transaktion verarbeitet wurde.
	acquirerresponsecode	Alphanumerisch	Maximal 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.
	acquirerresponsemessage	Alphanumerisch	Maximal 255
	authcode	Alphanumerisch	Maximal 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.
	billingpostcode	Alphanumerisch	Maximal 25	Die Postleitzahl, die für die Rechnungsadresse des Kunden eingegeben wurde. Dieses Feld wird zurückgegeben, falls vorhanden.
	billingpremise	Alphanumerisch einschließlich Symbole	Maximal 25	Die Hausnummer oder die erste Zeile der Rechnungsadresse des Kunden. Dieses Feld wird zurückgegeben, falls vorhanden.
	billingstreet	Alphanumerisch einschließlich Symbole	Maximal 127	Die für die Rechnungsadresse des Kunden eingegebene Straße. Dieses Feld wird zurückgegeben, falls vorhanden.
	Cashbackbase-Betrag	Numerisch	Maximal 13	Der vom Kunden gewünschte Cashback-Betrag. Mastercard kann Cashback-Anträge ablehnen. Wenn dies geschieht, wird der Cashback-Basisbetrag mit dem Wert "0" angezeigt. Dieses Feld wird zurückgegeben, falls vorhanden.
	chargedescription	Alphanumerisch einschließlich Symbole	Maximal 25	Dies ist eine Beschreibung der abgefragten Zahlung, die auf dem Kontoauszug des Kunden erscheint. Dieses Feld wird zurückgegeben, falls vorhanden.
	errordata	Alphanumerisch	Maximal 255	Zusätzliche Informationen zur Behebung des Fehlers. Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist.
	expirydate	Datum MM/JJJJ	Maximal 7	Das auf der Karte aufgedruckte Ablaufdatum. Wird nur bei Kartentransaktionen zurückgegeben.
	fraudrating	Numerisch	Maximal 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.
	Emittent	Alphanumerisch	Maximal 255	Der Kartenaussteller des Kunden. Wird nur bei Kartentransaktionen zurückgegeben.
	issuercountryiso2a	ISO2A	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.
	merchantcategorycode	Alphanumerisch	Maximal 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	Alphanumerisch	Maximal 127	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.
	merchantcountryiso2a	ISO2A	2	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.
	merchantname	Alphanumerisch	Maximal 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.
	merchantstatecode	Alphanumerisch	Maximal 127	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.
	merchantzipcode	Alphanumerisch	Maximal 10	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.
	orderreference	Alphanumerisch einschließlich Symbole	Maximal 25	Die eindeutige Auftragsreferenz für die abgefragte Anfrage, die auf dem System Trust Payments gespeichert ist. Dieses Feld wird zurückgegeben, falls vorhanden.
	parenttransactionreference	Alphanumerisch & Bindestriche	Maximal 25	Die transactionreference einer früheren Anfrage, von der wichtige Details in die abgefragte Anfrage übernommen wurden. Dieses Feld wird zurückgegeben, falls vorhanden.
	retrievalreferencenumber	Alphanumerisch	Maximal 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.
	securityresponseaddress	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.
	securityresponsepostcode	Numerisch	1
	securityresponsesecuritycode	Numerisch	1
	settledtimestamp	Datum Uhrzeit JJJJ-MM-TT hh:mm:ss	Maximal 19	Das Datum und die Uhrzeit, zu der die abgefragte Transaktion abgewickelt wurde. Wird nur zurückgegeben, wenn die Transaktion abgewickelt wurde.
	stan	ISO 8583	Unbestimmt	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.
	tid	Alphanumerisch	Maximal 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.
	updatereason	Alphanumerisch	Maximal 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" - Transaktion wurde von unserem Regel-Manager. "securitypolicy" - Die Transaktion wurde gemäß der Sicherheitsrichtlinie für Ihr Konto aktualisiert. "settle" - Transaktion wurde von unserer Abrechnung Engine aktualisiert. "Duplikat" - Die Transaktion wurde als Duplikat eingestuft und durch unsere Duplikatsprüfungen ausgesetzt. Dieses Feld wird zurückgegeben, falls vorhanden.

Weitere Lektüre zu diesem Thema