CSV-Transaktionen herunterladen

Sie müssen einen Trust Payments API-Benutzernamen mit ausreichenden Benutzerrechten angeben, um den Download für die angegebene(n) Website-Referenz durchzuführen.

--user=example@example.com --ask-password

Die CSV-Datei kann über einen HTTPS POST-Abfrage-String mit Basic Access Authentication heruntergeladen werden. Basic Access Authentication ist eine Methode, bei der ein Webbrowser-Clientprogramm einen Benutzernamen und ein Passwort angeben muss, wenn es eine Anfrage bearbeitet.

Unterstützte Benutzerrollen

Sie können mit Ihrem Webservices Benutzernamen und Passwort verwenden, um Transaktionsdatensätze und Berichte herunterzuladen. Wenn Sie noch keinen Webservices Benutzernamen haben, können Sie einen neuen API-Benutzer erstellen mit Portal oder MyST erstellen.

Alternativ können Sie eine neue Benutzerrolle Extra Transaktionsdownload erstellen, die Zugriff auf zusätzliche Acquirer-Gebühreninformationen hat. (Informationen zu Acquirer-Gebühren sind nur für Transaktionen verfügbar, die mit einer teilnehmenden Acquirer-Bank abgewickelt werden. Kontaktieren Sie unser Support-Team für weitere Informationen)

Autorisierung Kopfzeile

Ein Benutzername und ein Passwort, getrennt durch einen Doppelpunkt, dann base64 kodiert, müssen in der Autorisierung Kopfzeile enthalten sein, wenn die Anfrage durchgeführt wird. Die meisten URL-Bibliotheken erstellen den Basis-Authentifizierungs-Header automatisch, aber wenn Sie dies manuell durchführen müssen, folgen Sie bitte diesem Beispiel:

Benutzername: csvdownload@example.com
Passwort: pa55word
Getrennt durch einen Doppelpunkt: csvdownload@example.com:pa55word
Base64 kodieren: Y3N2ZG93bmxvYWRAZXhhbXBsZS5jb206cGE1NXdvcmQ=

Daher sollte die Kopfzeile Autorisierung lauten:

Authorization: Basic Y3N2ZG93bmxvYWRAZXhhbXBsZS5jb206cGE1NXdvcmQ=

Die Anfrage kann mit Filtern versehen werden, so dass nur Datensätze zurückgegeben werden, die bestimmten Kriterien entsprechen.

sitereferences=test_site12345&startdate=2017-01-01&enddate=2017-01-31&settlestatuss=100

Standardmäßig werden alle Transaktionen innerhalb des Datumsbereichs für die angegebene(n) Website-Referenz im Download zurückgegeben. Es können Filter auf den Download angewendet werden, so dass nur bestimmte Datensätze zurückgegeben werden. Im obigen Beispiel wurden die folgenden Filter angewandt:

• Website-Referenz: test_site12345
• Datum der Transaktion Autorisierung : 1. Januar 2017 - 31. Januar 2017
• Abrechnungsstatus: 100

Mehrere Werte für dieselben Filter können durch ein "&" getrennt in den Aufruf aufgenommen werden.

Zum Beispiel für das Herunterladen von E-Commerce und MOTO Transaktionen, die accounttypedescriptions Filter kann zweimal mit zwei verschiedenen Werten enthalten sein:

accounttypedescriptions=ECOM&accounttypedescriptions=MOTO

Erforderliche Filter

Die folgenden Felder müssen in den POST-Daten enthalten sein:

Daten können für mehrere Website-Referenzen heruntergeladen werden, indem zusätzliche Website-Referenzen Felder durch ein "&" getrennt in den Aufruf aufgenommen werden.

Wenn zum Beispiel Transaktionen für Standort1 und Standort2 benötigt werden, würde der Aufruf Folgendes beinhalten:

sitereferences=site1&sitereferences=site2

Optionale Filter

Nützliche Filter

Im Folgenden finden Sie eine Liste der von unseren Händlern am häufigsten verwendeten Filter:
(Wenden Sie sich an unser Support-Team, um sich über die Verfügbarkeit weiterer Filter zu informieren)

Nach Zeit filtern

Verwenden Sie die folgenden Filter, um Daten zu Transaktionen innerhalb eines bestimmten Zeitraums herunterzuladen:

Zum Beispiel für das Herunterladen von Transaktionen zwischen 13:30:00 und 14:29:59:

starttimehour=13&starttimeminute=30&endtimehour=14&endtimeminute=29

Datumstyp

Standardmäßig werden die angegebenen Datums- und Zeitangaben auf der Grundlage des Zeitpunkts gefiltert, zu dem die Transaktion ursprünglich verarbeitet wurde. Sie können jedoch explizit angeben, welche Art von Datum/Uhrzeit gefiltert wird, indem Sie den folgenden zusätzlichen Filter einfügen:

Hier können Sie die Datenfelder angeben, die zurückgegeben werden sollen.

Als Minimum müssen alle Transaktionsdownload CSVs die Transaktionsnummer für jeden zurückgegebenen Datensatz enthalten.

Beispielhafte Ausgabe:

transactionreference
13-2-81000
13-28-1
13-28-10
13-28-11

Sie können zusätzliche Felder angeben, die in der Transaktionsdownload zurückgegeben werden sollen, wie im folgenden Beispiel gezeigt:

optionalfields=errorcode&optionalfields=currencyiso3a&optionalfields=authcode&optionalfields=orderreference&optionalfields=paymenttypedescription&optionalfields=settlestatus&optionalfields=settlemainamount&optionalfields=settleduedate&optionalfields=customercountryiso2a

Das obige Beispiel enthält die folgenden optionalen Felder:

• Fehlercode
• Währung
• Auth-Code
• Auftragsnummer
• Zahlungsart
• Abrechnungsstatus (settlestatus)
• Abrechnung Hauptbetrag
• Abrechnungsfälligkeitsdatum
• Land des Kunden

Die Ausgabe würde diese optionalen Felder enthalten. Die in der Anfrage angegebenen Feldnamen werden in der ersten Zeile der CSV-Ausgabe in der gleichen Reihenfolge angezeigt:

transactionreference,errorcode,currencyiso3a,authcode,orderreference,paymenttypedescription,settlestatus,settlemainamount,settleduedate,customercountryiso2a
23-9-1,0,GBP,TEST,20161,VISA,100,10.99,2017-01-03,GB
23-9-2,0,GBP,TEST,20162,MASTERCARD,100,11.98,2017-01-10,GB
23-9-3,0,GBP,TEST,20163,MASTERCARD,100,10.99,2017-01-11,GB
23-9-4,0,GBP,TEST,20164,MASTERCARD,100,10.99,2017-01-16,GB

Vollständige Liste der fakultativen Felder

In den folgenden Abschnitten sind die Felder aufgeführt, die in die Ausgabe aufgenommen werden können, wenn sie in der Anfrage angegeben sind:

Einzelheiten der Transaktion

Einzelheiten zur Zahlung

Abrechnung Details

Sicherheitsantwort

Die Antwort der AVS und Sicherheitscode-Prüfungen, die während Autorisierung durchgeführt werden. Dies kann einer der folgenden Werte sein:

• 0 = DATA NOT GIVEN
• 1 = DATA NOT CHECKED
• 2 = DATA MATCH
• 4 = DATA NOT MATCHED

Angaben zur Rechnungsstellung

Einzelheiten zur Lieferung

Angaben zum Händler

Angaben zur Acquirer-Gebühr

Die folgenden Felder können nur zurückgegeben werden, wenn die folgenden Bedingungen erfüllt sind:

• Diese Felder werden nur ausgefüllt, wenn Transaktionen mit einem unterstützten Acquirer verarbeitet werden. Kontaktieren Sie unser Support-Team für weitere Informationen.
• Die Benutzerrolle Zusätzlicher Transaktionsdownload muss verwendet werden, um den Download durchzuführen (diese Felder können nicht mit der Benutzerrolle zurückgegeben werden Webservices).

Laden Sie die CSV-Datei von der folgenden URL herunter:

https://myst.securetrading.net/auto/transactions/transactionsearch