Migrer de l'intégration de base vers le composant Mobile Payment Element

Mettez à jour l'intégration de votre ancien SDK mobile avant que nous ne le supprimions du SDK.

À compter du 4 novembre 2024, le SDK iOS, le SDK Android et le SDK React Native de Stripe ne prennent plus en charge notre ancienne intégration de base pour la collecte des paiements par carte de crédit et par portefeuille.

Pour utiliser les versions du SDK publiées après le 4 novembre 2024, vous devez supprimer les références du code d’intégration de base dans votre application et effectuer la mise à niveau vers le composant Payment Element pour mobile.
Vous pouvez toujours traiter les paiements avec les anciennes versions du SDK, mais vous risquez de ne pas obtenir les améliorations de sécurité essentielles et les nouvelles fonctionnalités.

La mise à niveau vers le composant Payment Element pour mobile vous donne accès à :

Plus de 100 moyens de paiement internationaux, y compris Link, le système de paiement accéléré de Stripe
La possibilité d’afficher les moyens de paiement enregistrés des acheteurs lors de leurs futurs achats
L’API Appearance, qui vous permet d’adapter l’apparence à celle de votre application

Exemple d'avantages obtenus lors de la migration de l'intégration de base vers Payment Element

Dans iOS, l’intégration de base comprend les éléments suivants :

STPCustomerContext
STPPaymentContext
STPPaymentOptionsViewController
STPAddCardViewController
STPShippingAddressViewController

Dans Android, l’intégration de base comprend les éléments suivants :

CustomerSession
PaymentSession
PaymentMethodsActivity
AddPaymentMethodActivity
PaymentFlowActivity

Migration vers le composant Payment Element pour mobile

L’intégration de base est généralement utilisée de deux manières :

Page de paiement : les utilisateurs saisissent leur carte bancaire, puis cliquent sur un bouton dans votre application pour finaliser leur achat.
Portefeuille : les utilisateurs ajoutent une carte bancaire à votre application, puis utilisent cette carte bancaire pour payer plus tard dans un autre flux.

Sélectionnez l’onglet ci-dessous correspondant à votre cas d’usage, soit la page de paiement, soit un portefeuille :

Utilisez les guides d’intégration suivants pour mettre en œuvre le composant Payment Element pour mobile sur la page de paiement dans vos applications :

Les guides d’intégration mentionnés ci-dessus diffèrent du guide d’intégration du composant Mobile Payment Element par défaut sur quelques points importants.

Contrôleur de flux

Le composant Mobile Payment Element possède une variante appelée « Flow Controller » (importée du SDK sous le nom PaymentSheet.FlowController). Comme l’intégration de base, le contrôleur de flux vous permet de collecter les informations du paiement dans le formulaire, puis de traiter le paiement lorsque l’utilisateur appuie sur un bouton de paiement final sur votre page de paiement.

Heure de création de l’Intent

Lors de la migration de l’intégration de base vers le composant Mobile Payment Element, créez l’Intent après avoir affiché le Mobile Payment Element en fournissant un objet PaymentSheet.IntentConfiguration à PaymentSheet. Définissez la propriété mode dans votre objet PaymentSheet.IntentConfiguration sur payment, puis indiquez le montant et la devise de la transaction.

Configuration pour une utilisation ultérieure

L’intégration de base permet aux utilisateurs d’ajouter des cartes bancaires à leur compte dans votre application mobile. Pour obtenir le même comportement à partir de PaymentSheet.FlowController, définissez le paramètre setupFutureUsage de votre objet PaymentSheet.IntentConfiguration sur onSession.

Vérifier la présence d'autres dépendances héritées

La mise à niveau vers le composant Payment Element pour mobile nécessite la mise à jour d’autres dépendances au sein de votre intégration mobile. Consultez les sections suivantes pour vous assurer que votre migration est complète.

Migration depuis l’API Charges

Si votre intégration utilise encore l’API Charges avec des tokens, vous devez migrer vers l’API Intents. Le guide d’intégration du composant Payment Element pour mobile dont le lien figure ci-dessus explique en détail comment utiliser les Intents. Vous pouvez également consulter la rubrique Migration vers l’API Payment Intents pour plus de détails.

Convertir votre configuration

L’intégration de base utilise un objet Configuration pour personnaliser votre intégration (STPPaymentConfiguration pour iOS, et PaymentSessionConfig pour Android). Convertissez votre configuration d’intégration de base en un PaymentSheet.Configuration pour personnaliser le composant Mobile Payment Element.