Eine Transaktion hat verschiedene Status. Abbildung 1 zeigt die möglichen Status einschliesslich der Übergänge, die zwischen diesen Status erlaubt sind.
Figure 1. Die Transaktionsstatus einschliesslich der Statusübergänge
Die folgenden Abschnitte erklären, was diese Status bedeuten und wann sie gesetzt werden. Es wird empfohlen, diese Status in die Anwendung des Händlers einzubauen, um alle Zahlarten zu unterstützen. Ebenso wird empfohlen, den zeitlichen Ablauf dieser Status in der Anwendung des Händlers korrekt zu berücksichtigen.
Wir garantieren, dass alle Transaktionen diese Status unabhängig von der Zahlart und dem Prozessor verwenden. Allerdings können einige Status übersprungen werden und der zeitliche Ablauf kann sich je nach Zahlart unterscheiden.
Wenn die Transaktion vom Händler erstellt wird, wird der Status Pending gesetzt. Die meisten Eigenschaften können
geändert werden, bis die Transaktion in den Status Confirmed überführt wird. Solange sich die Transaktion im
Status Pending befindet, kann der Betrag erhöht oder verringert werden.
Es ist möglich, bereits in diesem Status die möglichen Zahlarten für diese bestimmte Transaktion abzurufen.
Wenn die Transaktion Confirmed ist, kann die Transaktion nicht mehr geändert werden. Dieser
Status zeigt an, dass die Verarbeitung der Transaktion beginnen kann. Der Grund, warum Transaktionen im
Status Confirmed verbleiben können und nicht zu Processing wechseln, ist typischerweise, dass der Kunde nicht zu
unserem Dienst weitergeleitet wurde und die Verarbeitung daher noch nicht gestartet wurde.
|
Note
|
Wie lange die Transaktion in diesem Status verbleibt, wird von der Anwendung des Händlers gesteuert. Sobald der Kunde
auf unsere Plattform weitergeleitet wird, wird der Status Processing gesetzt.
|
Sie können Zahlungen über unsere iFrame-Integration akzeptieren. Ausführlichere Informationen finden Sie im Leitfaden zur iFrame-Integration.
Der Status Processing wird gesetzt, wenn die Verarbeitung der Transaktion begonnen hat, aber noch nicht abgeschlossen ist. Eine Transaktion kann
Sekunden oder sogar Wochen im Status Processing verbleiben. Der zeitliche Ablauf hängt von den Zahlarten, dem Prozess, dem
verwendeten Charge Flow usw. sowie davon ab, wie die Transaktion verarbeitet wird. Charge Flows können den Wechsel in den nächsten Status beispielsweise um Wochen verzögern, weil
die Transaktion so lange in Processing bleiben kann, bis alle Charge-Flow-Stufen verarbeitet wurden.
|
Note
|
Der zeitliche Ablauf der verschiedenen Stufen kann in der Konfiguration der Charge-Flow-Stufen festgelegt werden. Weitere Informationen finden Sie im Abschnitt zu den Charge Flows. |
Die Transaktion wird als Failed markiert, wenn die Zahlung nicht autorisiert werden konnte. Typischerweise bricht entweder der Kunde
den Autorisierungsprozess ab oder die Autorisierung wurde vom Prozessor abgelehnt. Die Details zum Grund, warum die Transaktion fehlgeschlagen ist,
finden sich in den mit der Transaktion verknüpften Zahlungsversuchen. Unter Umständen versucht es der Kunde mehrmals,
jedes Mal mit einem anderen Fehlergrund.
|
Important
|
Dieser Status ist ein Endstatus. Die Transaktion wird ihren Status nicht mehr ändern. |
|
Note
|
Weitere Informationen dazu, warum die Transaktion in den Status Failed überführt wurde, finden Sie, wenn Sie die Transaktion öffnen und den Prozess-Tab prüfen: Space > Zahlung > Transaktion. |
Die Transaktion ist Authorized, wenn der Kunde die Transaktion akzeptiert hat und der Prozess verifiziert hat, dass
der Kunde in der Lage ist, den Betrag zu bezahlen. Authorized bedeutet, dass eine Reservierung besteht, die Gelder jedoch nicht
vom Konto des Kunden auf das Konto des Händlers übertragen wurden. In diesem Status kann der Händler den
Betrag der Transaktion ändern, indem er die Positionen der Transaktion anpasst. Diese Änderungen können entweder
über die Webservice-API oder über die Benutzeroberfläche unserer Anwendung vorgenommen werden. Wenn keine weiteren Änderungen mehr an der
Transaktion vorgenommen werden sollen, muss sie abgeschlossen werden (siehe Abschlüsse).
|
Important
|
Nicht alle Zahlarten unterstützen eine Reservierung auf dem Konto des Kunden. Daher überspringen einige Zahlarten diesen Status und
wechseln direkt zu Completed.
|
Wie lange die Transaktion in diesem Status verbleibt, kann der Händler steuern. Der Händler kann den Abschluss der Transaktion über die Webservice-Schnittstelle auslösen.
Transaktionen können über das Backoffice oder über die Webservice-API abgeschlossen werden. Beispielanfragen und ausführlichere Informationen finden Sie im Leitfaden zum Abschluss.
Die Transaktion wird als voided markiert, wenn eine autorisierte, aber nicht abgeschlossene Transaktion nicht mehr verarbeitet
werden soll und daher storniert wird.
|
Important
|
Dieser Status ist ein Endstatus. Die Transaktion wird ihren Status nicht mehr ändern. |
Transaktionen können über das Backoffice oder über die Webservice-API storniert werden. Beispielanfragen und ausführlichere Informationen finden Sie im Leitfaden zur Stornierung.
Wenn sich die Transaktion im Status Completed befindet, wurde die Übertragung des Geldes vom Konto des Kunden auf das Konto des Händlers
eingeleitet. Der Betrag kann nicht mehr geändert werden. Completed bedeutet nicht, dass die Waren oder Dienstleistungen an den
Kunden geliefert werden können. Je nach Zahlart müssen die Gelder erst übertragen werden, bevor die Lieferung
erfolgen kann (z. B. bei Vorauszahlung).
Für jede Transaktion geben wir an, ob die Waren jetzt geliefert werden können oder ob der Download für Ihren Händler freigegeben werden soll.
Dies wird durch die Status Fulfill und Decline angezeigt. Der Händler sollte warten, bis einer der Endstatus erreicht ist.
Wie lange die Transaktion in diesem Status verbleibt, hängt von der Zahlart und dem Prozessor ab. Dies können nur wenige Sekunden oder Wochen sein.
Einige Zahlarten erfordern möglicherweise eine manuelle Entscheidung. Dieser manuelle Entscheidungsprozess wird über das Konzept der Lieferentscheidung abgewickelt,
das in Lieferentscheidungen erklärt wird.
Beispiel
Angenommen, Sie bieten Online-Banking als Zahlart in Ihrem Shop an. Die Transaktion wechselt in den Status Completed,
sobald die Transaktion abgeschlossen ist. Je nach Zahlart kann es jedoch bis zu einem Tag dauern, bis der Anbieter uns
mitteilen kann, ob das Geld auf Ihrem Konto eingegangen ist. Die Transaktion bleibt im Status Completed, bis wir
diese Bestätigung erhalten haben.
Falls es keinen automatischen Prozess gibt, über den wir benachrichtigt werden, dass das Geld eingegangen ist oder von einer dritten Partei garantiert wird,
müssen Sie manuell prüfen, ob die Zahlung eingegangen ist, und die Transaktionen manuell in den
Status Fulfill oder Decline überführen.
Wenn die Transaktion in Fulfill überführt wird, kann der Händler mit der Erfüllung der Transaktion beginnen. Bei physischen Waren sollte der
Lieferprozess gestartet werden.
|
Important
|
Dies ist ein Endstatus. |
Wenn die Transaktion in den Status Decline überführt wird, sollte der Händler die Transaktion ablehnen und sie nicht erfüllen.
Dieser Status wird typischerweise gesetzt, wenn der Kunde nicht zahlungswillig ist oder die Wahrscheinlichkeit hoch ist, dass der Kunde eine
Rückbuchung veranlasst (verdächtige Transaktionen aufgrund Ihrer Betrugseinstellungen). Weitere Informationen dazu, warum die Transaktion in den Status Decline überführt wurde, finden Sie
auf dem Objekt Lieferentscheidungen.
|
Important
|
Dies ist ein Endstatus. |
|
Note
|
Innerhalb des Space gibt es eine Einstellung, um automatisch eine Rückerstattung auszulösen, wenn dieser Status erreicht wird. Dies erlaubt es, die Buchhaltung automatisch zu korrigieren und die Transaktionen automatisch zurückzuerstatten. Verwenden Sie diese Funktion mit Vorsicht. |
Wenn sich die Transaktion im Status Authorized befindet, kann der Händler die Transaktion ändern. Diese Änderungen werden nur in unserer
Anwendung gespeichert und nicht an den Prozessor übermittelt. Sobald keine weiteren Änderungen mehr an der Transaktion vorgenommen werden müssen,
muss der Händler die Transaktion abschliessen. Die Änderungen sowie der Abschluss können über die
Webservice-Schnittstelle und über die Benutzeroberfläche
unserer Anwendung ausgelöst werden. Der Abschluss einer Transaktion wird auch als capture oder activate bezeichnet.
Transaktionen können über das Backoffice oder über die Webservice-API abgeschlossen werden. Beispielanfragen und ausführlichere Informationen finden Sie im Leitfaden zum Abschluss.
Wir erlauben nur einen einzigen Abschluss pro Transaktion, um den Transaktionsprozess zu vereinfachen und zu straffen.
Sie können uns jedoch mehrere Änderungen der Transaktion übermitteln. Wir speichern sie alle und senden sie an den Prozessor, sobald Sie die Transaktion bestätigen.
|
Note
|
Falls Sie die Transaktion nicht bestätigen, wird sie vom System basierend auf Ihrer Timeout-Einstellung bestätigt. Diese kann festgelegt werden in → describe. |
Nicht alle Zahlarten unterstützen das Konzept von Abschlüssen. Daher können Änderungen nicht in allen Fällen angewendet werden. Aus diesem Grund muss der Prozess auf Händlerseite möglicherweise pro Zahlart angepasst werden.
Um eine solche Spezialisierung des Prozesses auf Händlerseite zu vermeiden, empfehlen wir, keine Abschlüsse zu verwenden. Alle Zahlarten können
so konfiguriert werden, dass sie direkt zu Completed wechseln. Der Händler kann nachträgliche Änderungen vornehmen, indem er Rückerstattungen erstellt. Dies vereinheitlicht
den Prozess für den Händler, da nur ein einziger Prozess umgesetzt werden muss.
|
Note
|
Das Verhalten bezüglich des direkten Abschlusses kann in der Connector-Konfiguration festgelegt werden: Space > Zahlung > Konfiguration > Connectors. Wie oben beschrieben, kann es sein, dass dies nicht festgelegt werden kann, weil die Zahlart das Konzept von Abschlüssen nicht kennt und direkt erfasst wird. |
Lieferentscheidungen sind ein sehr wichtiger Schritt im Transaktionsprozess, da sie Ihnen eine klare Aussage darüber geben, ob wir Ihnen empfehlen, die Waren auf Basis der Eigenschaften der Zahlart zu versenden. Wir haben den Prozess und die Garantien jeder von uns angebotenen Zahlart untersucht und können Ihnen daher klar sagen, ob die Zahlung höchstwahrscheinlich erfüllt wird oder in manchen Fällen sogar besser durch den Anbieter garantiert ist.
Ihre Anwendung sollte den Versand einer physischen Ware auslösen oder den Download freischalten, sobald die Lieferentscheidung in Fulfill überführt wird.
Sie können die Lieferentscheidung wie folgt abrufen. Falls Sie die Webhooks korrekt eingerichtet haben, benachrichtigen wir Sie, sobald es eine Aktualisierung der Transaktion gibt, und Sie sollten die Lieferentscheidungen von unserem Dienst abrufen.