Funktionsweise von SetupIntents
Erfahren Sie, wie SetupIntents innerhalb des Zahlungsablaufs funktionieren.
Asynchrone Zahlungsabläufe können kompliziert zu verwalten sein, da sie von Kundeninteraktionen abhängig sind, die außerhalb Ihrer Anwendung stattfinden. PaymentIntents und SetupIntents vereinfachen die Verwaltung, indem sie den Status des Ablaufs verfolgen.
Wenn der SetupIntent erstellt wird, hat er den Status requires_1, bis eine Zahlungsmethode angehängt wird.
Nachdem der/die Kund/in seine/ihre Zahlungsinformationen angegeben hat, kann der SetupIntent bestätigt werden.
In den meisten Integrationen wird dieser Status übersprungen, weil die Informationen zur Zahlungsmethode genau dann übermittelt werden, wenn die SetupIntent bestätigt wird.
Wenn für die Einrichtung zusätzliche Aktionen erforderlich sind, z. B. die Authentifizierung mit 3D Secure, hat der SetupIntent den Status requires_1.
Nachdem die erforderlichen Aktionen verarbeitet wurden, ändert sich der SetupIntent-Status in processing. Während die Verarbeitung für einige Zahlungsmethoden (beispielsweise Karten) in der Regel schnell geht, kann es für andere Zahlungsmethoden bis zu mehreren Tagen dauern.
Eine SetupIntent mit dem Status succeeded bedeutet, dass die Einrichtung erfolgreich war.
Sie können diese Zahlungsmethode jetzt an ein Kundenobjekt anhängen und sie für zukünftige Zahlungen verwenden.
Wenn die Einrichtung fehlschlägt, kehrt der Status des SetupIntent zu requires_ zurück.
Sie können eine SetupIntent jederzeit stornieren, bevor es sich im Status processing oder succeeded befindet.
1 Versionen der API vor dem 11.02.2019 zeigen requires_ anstelle von requires_ und requires_ anstelle von requires_ an.