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 unerlässlich: 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 einschließlich der Zustandsübergänge

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

Zustand	Bedeutung	Endzustand
Pending	Transaktion angelegt und noch bearbeitbar	Nein
Confirmed	Transaktion gesperrt, bereit zur Verarbeitung	Nein
Processing	Zahlung wird bearbeitet	Nein
Failed	Zahlung konnte nicht autorisiert werden	Ja
Authorized	Geldbetrag ist reserviert	Nein
Voided	Autorisierung vor Abschluss storniert	Ja
Completed	Die Überweisung hat begonnen	Nein
Fulfill	Auftrag kann ausgeführt werden	Ja
Decline	Auftrag darf nicht ausgeführt werden	Ja

info

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

In den folgenden Abschnitten werden die einzelnen Zustände, ihre Bedeutung und der Zeitpunkt ihrer Anwendung im Zahlungsprozess ausführlich beschrieben.

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 wechselt.

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

Bestätigt

Sobald eine Transaktion den Status Confirmed erreicht hat, 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 zu unserem 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 lang im Status Processing verbleiben.

Fehlgeschlagen

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

Failed ist ein Endzustand – der Zustand 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 PostFinance Checkout 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 mehr erforderlich sind, schließen Sie die Transaktion über die Webservice-API oder im Portal ab.

warnung

Einige Zahlungsmethoden unterstützen keine Reservierung von Beträgen. Bei diesen Transaktionen wird der Status Authorized übersprungen und direkt zum Status Completed übergegangen.

Ungültig

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

Voided ist ein Endzustand – der Zustand 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 Vorauszahlungen.

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 das Geld eingegangen ist oder von einem Dritten garantiert wurde, müssen Sie manuell überprüfen, ob die Zahlung eingegangen ist, und die Transaktion anschließend 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 Zustand 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 Betrugsschutz-Einstellungen gemeldet wurden.

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

info

Sobald dieser Status erreicht ist, kann eine automatische Rückerstattung ausgelöst werden, wodurch eine korrekte Abrechnung und eine umgehende Rückerstattung gewährleistet werden. Setzen Sie diese Funktion mit Bedacht ein. Um sie zu aktivieren, navigieren Sie in Ihrem PostFinance Checkout zu den Transaktionseinstellungen Ihres Space.

Aktionen zu einer Transaktion

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

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

Verwandte Themen

• Autorisierungsantwort – wie das Autorisierungsergebnis übermittelt wird, einschließlich 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.