Dokumentation
Dokumentation
Transaktion
Schliessen API Dokumentation
Transaktion

A transaction can go through the following states:

Pending

The transaction is initialized. Most of the information on the transaction can be changed. The transaction’s next state is Confirmed.

Confirmed

The transaction is confirmed by the web shop or by the merchant. Once a transaction is Confirmed no changes can be made on it. The transaction’s next state is Processing.

Processing

The transaction switches to Processing when we start with the collecting of the payment information and start with the processing. A transaction can remain a long time in the Processing state (e.g. when used with charge flows). In case the processing of the transaction is successful the transaction switches into Authorized. If the processing is not successful the transaction switches into Failed.

Failed

The transaction could not be Authorized. Typically either the customer cancelled the transaction or the customer was unable or not willing to authorize the payment. Details why the transaction Failed can be found in the failure reason on the transaction. This is a final state.

Authorized

The customer has Authorized the payment. Authorized means the customer has accepted the payment and the amount could be reserved. However the transfer of the amount to the merchant account is not be initiated. In this state the merchant can change the line items of the transaction. The transaction’s next state is Completed.

Completed

The payment has been initiated. The transfer of the money to the merchant account has been done or is initiated. As such the amount cannot be changed anymore. It is not recommend to initiate the delivery when this state is reached. The decision if the delivery of the goods should occur depends on the payment method on the settings done by the merchant. The transaction’s next states are Fulfill or Decline.

Fulfill

The transaction is ready to be delivered by the merchant. All the risk checks are executed and indicate that the transaction is safe to be delivered. This is a final state.

Decline

The transaction should not be delivered. It is recommended to decline the delivery because either the money will never arrive on the merchant account or the chances are high that the customer is not willing to pay the payment. This is a final state.

Zustände
  • Erstellen
    Der Erstellstatus wird während der Transaktionserstellung gesetzt.
  • Ausstehend
    Die Transaktion wurder erstellt, jedoch noch nicht vom System der Händlers bestätigt.
  • Bestätigt
    Die Transaktion wurde erstellt und bestätitgt, jedoch wurde sie noch nicht verarbeitet.
  • Verarbeitend
    Die Transaktion ist in Verarbeitung.
  • Fehlgeschlagen
    Die Autorisierung der Transaktion schlug fehl.
  • Autorisiert
    Die Transaktion wurde autorisiert.
  • Abgeschlossen
    Die Transaktion ist vollständig.
  • Liefern
    Die Transaktion ist bereit zur Auslieferung.
  • Ablehnen
    Die Produkte oder Dienstleistungen sollen nicht geliefert werden.
  • Annulliert
    Die Autorisierung wird für ungültig erklärt, so dass kein Geld überwiesen wird.
Eigenschaften
  • Accept Header
    Der "Accept"-Kopf des Webbrowsers des Kunden.
  • Accept Language Header
    Die Kopfzeile "Sprache akzeptieren" des Webbrowsers des Kunden.
  • Allowed Payment Method Brands
    Die Zahlwegmarken, die zur Autorisierung der Transaktion verwendet werden können.
  • Angelegt durch
    Die ID des Benutzers, von dem die Transaktion erstellt wurde.
  • Artikel Positionen
    Die vom Kunden gekauften Einzelposten.
  • Auto-Bestätigung aktiv
    Ob die Transaktion automatisch bestätigt werden kann oder ob dies explizit über die API erfolgen muss. Standard ist true.
  • Autorisiert am
    Das Datum und die Uhrzeit, zu der die Transaktion genehmigt wurde.
  • Autorisierungsbetrag
    Die Summe aller Einzelpostenpreise einschließlich Steuern in der Währung der Transaktion.
  • Autorisierungstimeout
    Das Datum und die Uhrzeit, zu der die Transaktion genehmigt werden muss, andernfalls wird sie storniert.
  • Autorisierungsumgebung
    Die Umgebung, in der die Transaktion genehmigt wurde.
  • Benutzer-Fehlermeldung
    Die Nachricht, die dem Kunden angezeigt werden kann, um zu erklären, warum die Transaktion fehlgeschlagen ist, in der Sprache des Kunden.
  • Benutzerinterface-Typ
    Die Art der Benutzeroberfläche, die der Kunde zur Angabe der Zahlungsinformationen verwendet hat.
  • Bildschirm Breite
    Die Bildschirmbreite des Webbrowsers des Kunden.
  • Bildschirm Farbtiefe
    Die Bildschirmfarbtiefe des Webbrowsers des Kunden.
  • Bildschirm Höhe
    Die Bildschirmhöhe des Webbrowsers des Kunden.
  • Charge Retry Enabled
    Ob der Kunde weitere Zahlungsversuche unternehmen kann, wenn der erste fehlgeschlagen ist. Standard ist true.
  • Completion Timeout On
    Das Datum und die Uhrzeit, zu der die Transaktion automatisch abgeschlossen wird.
  • Confirmed By
    Die ID des Benutzers, von dem die Transaktion bestätigt wurde.
  • Confirmed On
    Das Datum und die Uhrzeit, zu der die Transaktion erstellt wurde.
  • Customers Presence
    Die Anwesenheit des Kunden gibt an, ob und in welcher Form der Kunde der Transaktion anwesend ist. Standardwert ist VIRTUAL_PRESENT.
  • Elternelement
    Die übergeordnete Transaktion, die (teilweise) durch diese Transaktion ersetzt wurde.
  • Emailversand Suspendiert
    Ob der E-Mail-Versand für die Transaktion deaktiviert ist. Standard ist false.
  • End Of Life
    Das Datum und die Uhrzeit, zu der die Transaktion das Ende der Laufzeit erreicht. Zu diesem Zeitpunkt können keine weiteren Aktionen mehr durchgeführt werden.
  • Erlaubte Zahlungsmethodenkonfigurationen
    Die Zahlwegkonfigurationen, die zur Autorisierung der Transaktion verwendet werden können.
  • Erzeugt am
    Das Datum und die Uhrzeit, zu der das Objekt erstellt wurde.
  • Failed Url
    Die URL, zu der der Kunde zurückgeleitet wird, nachdem er seine Zahlung storniert oder nicht authentifiziert hat.
  • Fehlerursache
    Der Grund für das Scheitern der Transaktion.
  • Fehlgeschlagen Am
    Das Datum und die Uhrzeit, zu der die Transaktion fehlgeschlagen ist.
  • Geplantes Löschdatum
    Das Datum und die Uhrzeit, zu der das Objekt endgültig entfernt werden soll. Wenn der Wert leer ist, wird das Objekt nicht entfernt.
  • Geräte-Session-Identifier
    Ermöglicht die Verknüpfung der Transaktion mit den vom Gerät des Kunden erfassten Daten.
  • Gruppe
    Die Gruppe, zu der die Transaktion gehört.
  • Gutgeschriebener Betrag
    Der Gesamtbetrag, der erstattet wurde, in der Währung der Transaktion.
  • Händlerreferenz
    Die Referenz des Händlers, die zur Identifizierung der Transaktion verwendet wird.
  • ID
    A unique identifier for the object.
  • Internet Protocol Address Country
    Das Land, das anhand der IP-Adresse des Geräts des Kunden ermittelt wird.
  • Internet-Protocol-(IP)-Adresse
    Die IP-Adresse des Geräts des Kunden.
  • Invoice Merchant Reference
    Die Referenz des Händlers, die zur Identifizierung der Rechnung verwendet wird.
  • Java Enabled
    Ob Java auf dem Webbrowser des Kunden aktiviert ist.
  • Konfiguration des Payment Connectorss
    Die Konfiguration des Zahlungskonnektors, der zur Autorisierung der Transaktion verwendet wurde.
  • Kunden ID
    Die eindeutige Kennung des Kunden im externen System.
  • Kunden-E-Mail-Adresse
    Die E-Mail Adresse des Kunden.
  • Lieferadresse
    Die Adresse, an die die Bestellung versandt werden soll.
  • Lieferentscheidungsdatum
    Das Datum und die Uhrzeit, zu der die Entscheidung getroffen wurde, ob der Auftrag versandt werden soll.
  • Liefermethode
    Der Name der Versandmethode, die für den Versand der Produkte verwendet wird.
  • Metadaten
    Ermöglicht die Speicherung zusätzlicher Informationen über das Objekt.
  • Processing On
    Das Datum und die Uhrzeit, zu der die Verarbeitung der Transaktion begonnen wurde.
  • Rechnungsadresse
    Die Adresse, die mit der Zahlungsmethode für die Rechnungsstellung und Transaktionsverarbeitung verbunden ist.
  • Referenzierte Space ID
    Die ID des Raums, zu dem dieses Objekt gehört.
  • Sprache
    The language that is linked to the object.
  • Status
    Der aktuelle Zustand des Objekts.
  • Success Url
    Die URL, zu der der Kunde nach erfolgreicher Authentifizierung seiner Zahlung zurückgeleitet wird.
  • Summe der Gebühren
    Der Gesamtbetrag aller erhobenen Gebühren in der Währung der Transaktion.
  • Summe des bezahlten Beträge
    Der Gesamtbetrag, der abgerechnet wurde, in der Währung der Transaktion.
  • Terminal
    Das Zahlungsterminal, über das die Zahlung abgewickelt wurde.
  • Token
    Das Zahlungs-Token, das für die Belastung des Kunden verwendet werden soll.
  • Tokenizationsmodus
    Der Tokenisierungsmodus gibt an, ob und wie die Tokenisierung von Zahlungsinformationen auf die Transaktion angewendet wird.
  • Transaktionsabschlussverhalten
    Das Verhalten, das steuert, wann die Transaktion abgeschlossen ist.
  • Umgebung
  • Umgebungsauswahlstrategy
    Die Strategie, mit der festgelegt wird, ob die Transaktion in der Test- oder Produktionsumgebung verarbeitet werden soll.
  • User Agent Header
    Der "User Agent"-Header des Webbrowsers des Kunden.
  • Verbucht am
    Das Datum und die Uhrzeit, zu der die Transaktion abgeschlossen wurde.
  • Verbuchter Betrag
    Der Gesamtbetrag, der abgeschlossen wurde, in der Währung der Transaktion.
  • Verkaufskanal
    Der Verkaufskanal, über den die Transaktion platziert wurde.
  • Version
    The version is used for optimistic locking and incremented whenever the object is updated.
  • Weltraumansicht ID
    Die ID der Raumansicht, mit der dieses Objekt verknüpft ist.
  • Window Height
    Die Fensterhöhe des Webbrowsers des Kunden.
  • Window Width
    Die Fensterbreite des Webbrowsers des Kunden.
  • Währung
    Der aus drei Buchstaben bestehende Code (Format ISO 4217) für die Währung der Transaktion.
  • Years To Keep
    Die Anzahl der Jahre, die die Transaktion nach ihrer Genehmigung aufbewahrt wird.
  • Zeitzone
    Die Zeitzone des Kunden, die sich darauf auswirkt, wie Daten und Zeiten bei der Kommunikation mit dem Kunden formatiert werden.