Umstieg von der Basisintegration auf das Mobile Payment Element

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 Mobile Payment Element 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 ein Upgrade auf das Mobile Payment Element haben Sie Zugriff auf:

Ü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 Element

In iOS umfasst die Basisintegration:

STPCustomerContext
STPPaymentContext
STPPaymentOptionsViewController
STPAddCardViewController
STPShippingAddressViewController

In Android umfasst die Basisintegration:

CustomerSession
PaymentSession
PaymentMethodsActivity
AddPaymentMethodActivity
PaymentFlowActivity

Umstieg auf das Mobile Payment Element

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 Mobile Payment Element auf einer Bezahlseite in Ihren Apps zu implementieren:

Die oben verknüpften Integrationsleitfäden unterscheiden sich in einigen wichtigen Punkten vom standardmäßigen Integrationsleitfaden für das Mobile Payment Element.

Flow Controller

Das Mobile Payment Element 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 verarbeiten, wenn Ihre Nutzer/innen auf eine Schaltfläche für die endgültige Zahlung in Ihrem Bezahlvorgang tippt.

Intent-Erstellungszeit

Erstellen Sie bei der Umstellung von der Basisintegration auf das Mobile Payment Element den Intent, nachdem Sie das Mobile Payment Element gerendert haben, indem Sie ein PaymentSheet.IntentConfiguration-Objekt für PaymentSheet bereitstellen. Legen Sie die Eigenschaft mode in Ihrem PaymentSheet.IntentConfiguration-Objekt auf payment fest und geben Sie den Betrag und die Währung 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 Mobile Payment Element 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 umstellen. Der oben verlinkte Integrationsleitfaden für das Mobile Payment Element enthält Details zur Verwendung von Intents. Weitere Informationen finden Sie auch unter Auf die Payment Intents API umstellen.

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 Mobile Payment Element anzupassen.