Home Allgemeine Informationen zum Abonnement und zum Lebenszyklus mit Aussetzungen.
Ihr Abonnement kann mehrere Status haben:
-
Pending: Ein Abonnement befindet sich im Status Pending, wenn das Abonnement und die Abonnementversion erstellt werden. -
Initializing: Sobald das Abonnement erstellt ist und keine aktive Token-Version vorhanden ist, wechselt das Abonnement in den Status Initializing, bis gültige Zahlungsinformationen bereitgestellt werden. -
Active: Sobald der Token belastet werden kann, wechselt das Abonnement in den aktiven Status. -
Terminating: Ein Abonnement, das gekündigt wurde, aber noch ausstehende Belastungen oder ausstehende Perioden hat, befindet sich im Status Terminating. -
Terminated: Sobald alle Belastungen durchgeführt wurden, wechselt das Abonnement in den Status Terminated. -
Failed: Wenn die Initialisierung des Abonnements fehlschlägt, geht das Abonnement automatisch in den Status Failed über. Dies kann auch passieren, wenn die initiale Transaktion das Timeout erreicht. Falls Sie die Payment Page oder die Iframe-Integration verwenden, um das Abonnement zu initialisieren, müssen Sie dies berücksichtigen. Falls Sie eine E-Mail senden möchten, mit welcher der Kunde die Transaktion initialisieren kann, empfiehlt es sich, auch für die initiale Transaktion Charge Flows zu verwenden.
Sobald ein Abonnement erstellt wurde, wird eine fehlgeschlagene Zahlung einer Rechnung zum wichtigsten Ereignis, das eintreten kann. Fehlschläge treten aus vielen Gründen auf:
-
Fehlen einer tatsächlichen Zahlungsquelle beim zugehörigen Kunden
-
Versuch, eine veraltete oder abgelaufene Zahlungsquelle zu verwenden
-
Eine tatsächliche Ablehnung einer ansonsten gültigen Zahlungsquelle
Sobald die Zahlung fehlschlägt, löst dies den standardmässigen Charge Flow aus, um gültige Zahlungsinformationen einzuholen.
In der Charge-Flow-Konfiguration können Sie über die Charge-Flow-Stufen festlegen, wie oft
die E-Mail zur Erfassung der Zahlungsinformationen versendet wird. Wenn die letzte Charge-Flow-Stufe erreicht ist und der Abonnent
keine gültigen Zugangsdaten bereitgestellt hat, wechselt das Abonnement in den Status suspended.
Aussetzungen können manuell entfernt werden, indem Sie das Abonnement öffnen und in den Aussetzungs-Tab wechseln. Der ausstehende Betrag wird mit dem nächsten Abrechnungszyklus belastet.
|
Note
|
Sie können eine fehlgeschlagene Zahlung einfach testen, indem Sie ein echtes Abonnement erstellen und dann den Token des Abonnements invalidieren. Dies löst automatisch den Prozess für fehlgeschlagene Zahlungen aus, um die Token-Version zu aktualisieren. |
Abonnements können ausgesetzt werden. Dies kann automatisch geschehen, wenn der ausstehende Betrag nicht belastet werden kann. Bevor dies geschieht, muss der zugehörige Charge Flow das Ende ohne erfolgreiche Zahlung erreichen.
Zusätzliche Aussetzungen können manuell hinzugefügt werden. Im Wesentlichen pausiert eine Aussetzung die Abrechnung und beendet die Dienstleistungen vorübergehend. Eine Aussetzung erfordert immer ein Enddatum. Das Enddatum gibt an, wann die Aussetzung beendet wird. Bei der Erstellung der Aussetzung kann das Verhalten nach dem Ende der Aussetzung festgelegt werden. Damit lässt sich definieren, ob das Abonnement beim Erreichen des Endes der Aussetzung gekündigt oder ob das Abonnement wieder aktiviert werden soll. Wenn der Charge Flow fehlschlägt, erstellen wir eine Aussetzung, die das Abonnement kündigt, nachdem die Aussetzung beendet ist. Das heisst, wir pausieren das Abonnement für die Dauer der Aussetzung, und wenn der Abonnent den Händler innerhalb dieser Zeit nicht kontaktiert, um das Abonnement zu reaktivieren, kündigen wir das Abonnement anschliessend, weil wir davon ausgehen, dass der Abonnent, wenn er nicht auf die versendeten Erinnerungs-E-Mails reagiert und auch das Pausieren der Dienstleistung keine Reaktion des Abonnenten auslöst, höchstwahrscheinlich nicht mehr an der Dienstleistung interessiert ist.
Aussetzungen können einem Abonnement über das Backend hinzugefügt werden. Dazu müssen Sie das Abonnement öffnen und in den Aussetzungs-Tab wechseln. Dort können Sie einem Abonnement Aussetzungen hinzufügen. Für die Dauer der Aussetzung werden keine Belastungen durchgeführt. Sobald das Abonnement die Aussetzung verlässt und nicht gekündigt ist, wird das Abonnement genau dort fortgesetzt, wo es ausgesetzt wurde.
Ein Abonnement kann auch automatisch ausgesetzt werden, falls die Belastung des ausstehenden Betrags fehlschlägt und die Zahlungsinformationen nicht über den Charge Flow eingeholt werden konnten. Wenn sich ein Abonnement in der Aussetzung befindet, sollten Sie die Erbringung der Dienstleistung Ihrerseits einstellen. Wird der ausstehende Betrag nicht innerhalb der auf dem Produkt über die Charge-Flow-Verknüpfung definierten Aussetzungsdauer bezahlt, wird das Abonnement automatisch gekündigt.
Falls sich Ihr Abonnement im Status termination befindet und Sie dem Abonnement eine Aussetzung hinzufügen, führt dies zu
einer Aussetzung des Abonnements, und das Datum, an dem das Abonnement terminated wird, wird
um die Dauer der Aussetzung verschoben.
Wenn eine Zahlung bei der Belastung fehlschlägt, löst dies einen Charge-Flow-Prozess basierend auf Ihren Konfigurationen aus. Der Abonnent erhält eine E-Mail, die den Abonnenten auffordert, seine Zahlungsinformationen zu aktualisieren. Falls Sie mehr Kontrolle über die Formatierung und den Versand der E-Mail benötigen, können Sie den Charge Flow so einrichten, dass Ihre Anwendung über eine neue zu versendende Charge-Flow-E-Mail benachrichtigt wird. Die Anwendung kann damit den Versand übernehmen. Die Charge-Flow-Dokumentation enthält weitere Details zur Einrichtung.
Falls der Abonnent die Zahlungsdetails innerhalb Ihrer Anwendung aktualisieren können soll, möchten Sie möglicherweise den API-Aufruf zur Token-Aktualisierung verwenden. Diese API-Operation erstellt eine Transaktion, die lediglich die Zahlungsdetails für den Token aktualisiert. Der Token ist auf dem Abonnementobjekt zu finden. Details dazu finden Sie in der API-Dokumentation unter Operation zur Token-Aktualisierung.
Dazu müssen Sie den Token wie folgt aktualisieren:
-
Verwenden Sie den Endpunkt Transaktion für Token-Aktualisierung erstellen. Sie geben im Aufruf den Token an, den Sie aktualisieren möchten.
-
Dies erstellt eine Transaktion im Status
pending. Verwenden Sie nun die Transaktion in Ihrer Anwendung, um die Payment Page aufzubauen oder um einen Iframe-Checkout zu erstellen