Transaktionszustände

Jede Transaktion in Wallee durchläuft eine festgelegte Abfolge von Zuständen, von der Erstellung bis zum Endzustand. Das Verständnis dieser Zustände ist für die Nachverfolgung und Verwaltung von Zahlungen von entscheidender Bedeutung: Sie geben Aufschluss über den aktuellen Status einer Zahlung, ermöglichen es Ihrem System, auf jeden Schritt des Zahlungsprozesses zu reagieren, und helfen Ihnen, Probleme umgehend zu beheben.

Überblick über die Bundesländer

Eine Transaktion durchläuft verschiedene Zustände. Abbildung 1 zeigt die möglichen Zustände und die zulässigen Übergänge zwischen ihnen.

Abbildung 1: Die Transaktionszustände einschliesslich der Zustandsübergänge

Wir garantieren, dass bei jeder Transaktion diese Phasen durchlaufen werden, unabhängig von der Zahlungsmethode oder dem Verarbeiter. Es kann jedoch vorkommen, dass einige Phasen übersprungen werden, und der zeitliche Ablauf kann je nach der jeweiligen Zahlungsmethode und der Art der Transaktionsabwicklung variieren.

Status	Bedeutung	Endstatus
Pending	Transaktion angelegt und noch bearbeitbar	Nein
Confirmed	Transaktion gesperrt, bereit zur Verarbeitung	Nein
Processing	Die Zahlung wird gerade verarbeitet	Nein
Failed	Die Zahlung konnte nicht autorisiert werden	Ja
Authorized	Der Betrag ist reserviert	Nein
Voided	Die Autorisierung wurde vor Abschluss storniert	Ja
Completed	Die Überweisung des Geldbetrags hat begonnen	Nein
Fulfill	Der Auftrag kann ausgeführt werden	Ja
Decline	Der Auftrag darf nicht ausgeführt werden	Ja

info

Wir empfehlen Ihnen, alle diese Status sowie deren zeitliche Abfolge in Ihre Anwendung zu integrieren. Dadurch wird sichergestellt, dass Ihre Integration alle Zahlungsmethoden unterstützt. Um benachrichtigt zu werden, sobald sich der Status einer Transaktion ändert, abonnieren Sie bitte Webhooks, anstatt die API abzufragen.

In den folgenden Abschnitten werden die einzelnen Status im Einzelnen beschrieben, einschliesslich ihrer Bedeutung und des Zeitpunkts, zu dem sie im Zahlungsprozess zum Tragen kommen.

Ausstehend

Wenn ein Händler eine Transaktion anlegt, wechselt diese in den Status Pending. In diesem Status können die meisten Eigenschaften noch geändert werden, und der Betrag kann erhöht oder verringert werden, bis die Transaktion in den Status Confirmed übergeht.

Wie lange eine Transaktion im Status Pending verbleibt, wird von Ihrer Anwendung gesteuert. Der Übergang in den Status Confirmed kann über die Webservice-API ausgelöst werden.

Bestätigt

Sobald sich eine Transaktion im Status Confirmed befindet, kann sie nicht mehr geändert werden – die Transaktionsverarbeitung kann beginnen. Eine Transaktion kann im Status Confirmed verbleiben, ohne in den Status Processing überzugehen, solange der Kunde noch nicht auf unseren Dienst weitergeleitet wurde.

info

Wie lange eine Transaktion in diesem Status verbleibt, wird von Ihrer Anwendung festgelegt. Der Status wechselt zu Processing, sobald der Kunde auf unsere Plattform weitergeleitet wird.

Verarbeitung

Der Status Processing ist aktiv, solange die Transaktionsverarbeitung begonnen hat, aber noch nicht abgeschlossen ist. Eine Transaktion kann je nach Zahlungsmethode, Prozessablauf, verwendetem Abrechnungsfluss und Art der Transaktionsverarbeitung einige Sekunden oder mehrere Wochen im Status Processing verbleiben.

Fehlgeschlagen

Die Transaktion wechselt in den Status Failed, wenn die Zahlung nicht autorisiert werden kann. Dies kann geschehen, wenn der Kunde den Autorisierungsvorgang abbricht oder wenn der Verarbeiter die Autorisierung ablehnt. Detaillierte Gründe für den Fehlschlag finden Sie in den mit der Transaktion verknüpften Belastungsversuchen. Kunden können den Vorgang mehrmals wiederholen, wobei jedes Mal ein anderer Grund für den Fehlschlag vorliegen kann.

Failed ist ein Endzustand – der Status der Transaktion wird sich nicht mehr ändern.

info

Um detaillierte Informationen darüber anzuzeigen, warum die Transaktion fehlgeschlagen ist, öffnen Sie die Transaktion, indem Sie in Ihrem Wallee Portal zu Space > Transaktion navigieren.

Autorisiert

Eine Transaktion gilt als Authorized, wenn der Kunde der Transaktion zugestimmt hat und das System seine Zahlungsfähigkeit für den angegebenen Betrag bestätigt hat. Authorized bedeutet, dass die Mittel reserviert sind – sie wurden noch nicht vom Konto des Kunden auf das Konto des Händlers überwiesen.

Im Status Authorized können Sie den Transaktionsbetrag weiterhin anpassen, indem Sie die Einzelposten ändern – entweder über die API oder im Portal. Wie lange eine Transaktion in diesem Status verbleibt, legen Sie selbst fest. Sobald keine weiteren Änderungen erforderlich sind, schliessen Sie die Transaktion über die Webservice-API oder im Portal ab.

warnung

Einige Zahlungsmethoden unterstützen keine Mittelreservierung. Diese Transaktionen überspringen den Status Authorized und gehen direkt in den Status Completed über.

Für nichtig erklärt

Eine Transaktion erreicht den Status Voided, wenn eine Authorized-Transaktion vor ihrem Abschluss storniert wird und nicht weiter bearbeitet wird. Transaktionen können im Portal oder über die Webservice-API storniert werden.

Voided ist ein Endzustand – der Status der Transaktion wird sich nicht mehr ändern.

Abgeschlossen

Wenn eine Transaktion den Status Completed erreicht, hat die Überweisung des Geldbetrags vom Konto des Kunden auf das Konto des Händlers begonnen. Der Betrag kann nicht mehr geändert werden. Completed bedeutet jedoch nicht, dass Waren oder Dienstleistungen sofort geliefert werden können: Je nach Zahlungsmethode muss der Betrag möglicherweise vollständig überwiesen sein, bevor die Lieferung erfolgen kann – beispielsweise bei Vorauszahlungsszenarien.

info

Beispiel: Wenn Sie in Ihrem Shop Online-Banking als Zahlungsmethode anbieten, erreicht die Transaktion den Status Completed, sobald der Kunde die Zahlung abgeschlossen hat. Je nach Zahlungsmethode kann es bis zu einem Tag dauern, bis der Anbieter bestätigt, dass der Betrag auf Ihrem Konto eingegangen ist. Die Transaktion verbleibt im Status Completed, bis diese Bestätigung eingeht.

Falls es keinen automatischen Prozess gibt, der uns benachrichtigt, sobald die Gelder eingegangen sind oder von einem Dritten garantiert wurden, müssen Sie manuell überprüfen, ob die Zahlung eingegangen ist, und die Transaktion anschliessend entweder in den Status Fulfill oder Decline versetzen.

Erfüllen

Sobald die Transaktion den Status Fulfill erreicht, können Sie mit der Bearbeitung der Bestellung beginnen. Bei physischen Waren bedeutet dies, den Lieferprozess einzuleiten.

Fulfill ist ein Endzustand – der Status der Transaktion wird sich nicht mehr ändern.

Rückgang

Wenn eine Transaktion in den Status Decline wechselt, dürfen Sie die Bestellung nicht ausführen. Eine Transaktion wird in der Regel abgelehnt, wenn der Kunde die Zahlung verweigert oder wenn ein hohes Risiko eines Chargebacks besteht, häufig aufgrund verdächtiger Aktivitäten, die von Ihren Einstellungen zur Betrugsprävention gemeldet wurden.

Decline ist ein Endzustand – der Status der Transaktion wird sich nicht mehr ändern.

info

Sobald dieser Status erreicht ist, kann eine automatische Rückerstattung ausgelöst werden, wodurch eine korrekte Buchführung und eine umgehende Rückerstattung gewährleistet werden. Bitte nutzen Sie diese Funktion mit Bedacht. Um sie zu aktivieren, navigieren Sie in Ihrem Wallee Portal zu den Transaktionseinstellungen Ihres Space.

Aktionen für eine Transaktion

Neben den Zustandsübergängen selbst beeinflussen drei Aktionen den Verbleib des Geldes. Welche davon verfügbar ist, hängt vom aktuellen Zustand der Transaktion ab:

Aktion	Im Status möglich	Wirkung
Abschluss	Authorized	Schliesst die Zahlung ab und leitet die Überweisung des Geldbetrags ein. Pro Transaktion ist nur ein Abschluss möglich; die Einzelposten können bis zu diesem Zeitpunkt geändert werden.
Stornierung	Authorized	Storniert die Autorisierung und gibt die reservierten Beträge frei. Die Transaktion erhält den Status Voided.
Rückerstattung	Completed oder Fulfill	Erstattet dem Kunden Geld zurück, nachdem die Zahlung abgewickelt wurde. Siehe Rückerstattungen.

Verwandte Themen

• Autorisierungsantwort – wie das Autorisierungsergebnis übermittelt wird, einschliesslich aller Antwortcodes.
• Lieferhinweise – Entscheidung darüber, ob eine Bestellung ausgeführt werden kann.
• Rückerstattungen – Rückerstattung des Geldes an den Kunden nach einer Transaktion.
• PCI DSS – Wie Kartendaten während des gesamten Prozesses geschützt werden.