Über dieses Handbuch

Dieses Handbuch dient als Referenz für das Format und die Inhalte der Berichte, die mit dem Produkt Computop Smart Data erzeugt und geliefert werden.

Beabsichtigte Zielgruppe

Diese Dokument richtet sich an technischer Mitarbeiter, die Berichte abrufen und analysieren, die von Computop Smart Data erzeugt wurden.

Datenformate

Definitionen

Produktüberblick

Computop Smart Data ist ein automatisierter Dienst, um einen oder mehrere vordefinierte Berichte zu erzeugen, die im FTP-Zugang eines Händlers zum Abruf bereitgestellt werden. Der Dienst ermöglicht Händlern, periodische Berichte gemäß den individuellen Anforderungen zu planen.

Smart-Data-Berichte werden standardmäßig als kommaseparierte Textdateien (CSV) mit einer Standardauswahl an Datenfeldern geliefert. Händler können ihre Berichte jedoch anpassen, indem sie jene Felder aus der Standardauswahl wählen, die einbezogen werden sollen. Datensätze können Transaktionen zwischen einem Tag und maximal einem Jahr vor dem Berichtsdatum umfassen. Bitte beachten Sie, dass durch dieses Produkt keine Echtzeitdaten unterstützt werden.

Zur individuellen Einrichtung und Konfiguration wenden Sie sich bitte an Computop Helpdesk.

Berichtsfilter

Folgende Filteroptionen sind verfügbar:

• MerchantID
• Firma
• Währung
• Zahlungsmethode
• Zahlungsstatus
• Kartenmarke
• Aktion
• Nur erfolgreiche Transaktionen
• Nur fehlgeschlagene Transaktionen,
• Nur Transaktionen mit spezifischen/m Code/s,
• Nur Transaktionen ausser spezifischen/m Code/s

Beachten Sie bitte, dass alle Filteroptionen mehrere Werte enthalten können.

Berichtszeitplan

Smart-Data-Berichte können gemäß folgender Optionen eingerichtet werden:

Einmaliger Bericht

• Angegebener Zeitraum zwischen zwei Datumsangaben

Periodische Berichte

• Täglich
• Wöchentlich (Wochentag der Lieferung nach Ermessen des Händlers)
• Monatlich (am 1., 2., 3., ... jeden Monats)

Datei-Layout

Berichte von Computop Smart Data werden als reine Textdateien im CSV-Format erzeugt. Als Trennzeichen zwischen den Werten werden derzeit Komma, Tabulator und Semikolon unterstützt (Bitte fragen Sie den Computop Helpdesk für eine individuelle Einrichtung). Das Standard-Trennzeichen ist das Semikolon, sofern nicht anders angegeben.

Jede Datei enthält zu Beginn eine Header-Zeile sowie keine oder einige Datenzeilen. Eine Header-Zeile besteht aus einer separierten Liste der individuellen Feldnamen in der angegebenen Reihenfolge, wie in diesem Dokument definiert. Die Feldnamen der Header-Zeile sind derzeit in Englisch und Deutsch verfügbar. Die Datenzeilen bestehen aus einer separierten Liste von Datenfeldwerten, die Zeichen in der Codierung UTF-8 enthalten.

Sicherheit

Aus Sicherheitsgründen sind alle Dateien mit PGP verschlüsselt und werden per SFTP übertragen.

Dateinamen

Die Dateinamen werden gemäß folgender Konvention zugeordnet: ComputopSmartData_[JobID]_[TaskID]_[YYYYMMDD_hhmmss].CSV.pgp

In der folgenden Tabelle sind die einzelnen Namenselemente beschrieben.

Ein gültiges Beispiel eines Dateinamens ist: ComputopSmartData_12_789_20160320_023609.CSV.pgp.

Datensätze und Feldbeschreibung

Jeder Datensatz steht für eine zu einer Zahlung ausgeführten Operation/Aktion. Gewöhnlich besteht eine Zahlung aus mehreren Operations-Datensätzen. Die verfügbaren Datenfelder sind in nachstehender Tabelle aufgeführt. Auf Anforderung können einzelne Datenfelder weggelassen werden.