Migration von der Basisintegration auf das Payment Sheet

Führen Sie ein Upgrade Ihrer älteren mobilen SDK-Integration durch, bevor wir sie aus dem SDK entfernen.

Mit Wirkung zum 4. November 2024 unterstützen das iOS SDK, das Android SDK und das React Native SDK von Stripe die ältere Basisintegration nicht mehr zur Erfassung von Kreditkarten- und Wallet-Zahlungen.

Um SDK-Versionen zu verwenden, die nach dem 4. November 2024 veröffentlicht wurden, müssen Sie die Verweise auf den Code der Basisintegration in Ihrer App entfernen und ein Upgrade auf das Payment Sheet durchführen.
Sie können Zahlungen immer noch über ältere Versionen des SDK abwickeln, aber Sie riskieren, wichtige Sicherheitsverbesserungen und neue Funktionen zu verpassen.

Durch das Upgrade auf das Payment Sheet haben Sie Zugriff auf Folgendes:

Über 100 globale Zahlungsmethoden, darunter Link, der beschleunigte Bezahlvorgang von Stripe
Die Möglichkeit, Käufern und Käuferinnen gespeicherte Zahlungsmethoden für zukünftige Einkäufe anzuzeigen
Die Appearance API, mit der Sie das Erscheinungsbild an Ihre App anpassen können

Beispiel für Vorteile bei der Migration von der Basisintegration zu Payment Sheet

In iOS umfasst die Basisintegration:

STPCustomerContext
STPPaymentContext
STPPaymentOptionsViewController
STPAddCardViewController
STPShippingAddressViewController

In Android umfasst die Basisintegration:

CustomerSession
PaymentSession
PaymentMethodsActivity
AddPaymentMethodActivity
PaymentFlowActivity

Zum Payment Sheet migrieren

Die Basisintegration wird im Allgemeinen auf zwei Arten verwendet:

Bezahlseite: Nutzer/innen geben ihre Kreditkartendaten ein und klicken dann auf eine Schaltfläche in Ihrer App, um ihren Kauf abzuschließen.
Wallet: Nutzer/innen fügen eine Kreditkarte zu Ihrer App hinzu und verwenden diese dann, um zu einem späteren Zeitpunkt Zahlungen zu tätigen.

Wählen Sie unten die Registerkarte aus, die Ihrem Use case entspricht, entweder auf der Bezahlseite oder in einer Wallet:

Verwenden Sie die folgenden Integrationsleitfäden, um das Payment Sheet auf einer Bezahlvorgangsseite in Ihren Apps zu implementieren:

Die oben verlinkten Integrationsleitfäden unterscheiden sich in einigen wichtigen Punkten vom Standard-Integrationsleitfaden für Payment Sheet.

Flow Controller

Das Payment Sheet hat eine Variante namens „Flow Controller“ (aus dem SDK als PaymentSheet.FlowController importiert). Wie bei der Basisintegration können Sie mit dem Flow Controller Zahlungsdaten im Formular erfassen und die Zahlung dann abwickeln, wenn Ihre Nutzerinnen und Nutzer auf eine Schaltfläche für die endgültige Zahlung in Ihrem Bezahlvorgang tippen.

Intent-Erstellungszeit

Erstellen Sie bei der Migration von der Basisintegration auf das Payment Sheet den Intent, nachdem Sie das Payment Sheet gerendert haben, indem Sie ein PaymentSheet.IntentConfiguration-Objekt für das PaymentSheet bereitstellen. Legen Sie die Eigenschaft Modus in Ihrem PaymentSheet.IntentConfiguration-Objekt auf Zahlung fest und geben Sie den Betrag und die Währungen für die Transaktion an.

Einrichtung für die spätere Nutzung

Bei der Basisintegration können Nutzer/innen ihrem Konto in Ihrer mobilen Anwendung Karten hinzufügen. Um dasselbe Verhalten von PaymentSheet.FlowController zu erhalten, legen Sie den Parameter setupFutureUsage in Ihrem Objekt PaymentSheet.IntentConfiguration auf onSession fest.

Auf andere Legacy-Abhängigkeiten hin prüfen

Für ein Upgrade auf das Payment Sheet müssen Sie andere Abhängigkeiten innerhalb Ihrer mobilen Integration aktualisieren. Lesen Sie die folgenden Abschnitte, um sicherzustellen, dass Ihre Migration umfassend ist.

Umstieg von der Charges API

Wenn Ihre Integration immer noch die Charges API mit Token verwendet, müssen Sie auf die Intents API migrieren. Der oben verlinkte Integrationsleitfaden für das Payment Sheet enthält Details zur Verwendung von Intents. Weitere Informationen finden Sie auch unter Migration zur Payment Intents API.

Ihre Konfiguration umwandeln

Die Basisintegration verwendet ein Konfigurationsobjekt, um Ihre Integration anzupassen (STPPaymentConfiguration für iOS und PaymentSessionConfig für Android). Wandeln Sie Ihre Basisintegration in eine PaymentSheet.Configuration um, um das Payment Sheet anzupassen.