Migrate from Basic Integration to the Mobile Payment Element
Upgrade your legacy mobile SDK integration before we remove it from the SDK.
Effective November 4, 2024, Stripe’s iOS SDK, Android SDK, and React Native SDK no longer support our legacy Basic Integration for collecting credit card and wallet payments.
- To use SDK versions published after November 4, 2024, you must remove the Basic Integration code references in your app and upgrade to the Mobile Payment Element.
- You can still process payments through older versions of the SDK, but you risk missing critical security enhancements and new features.
Upgrading to the Mobile Payment Element gives you access to:
- Over 100 global payment methods including Link, Stripe’s accelerated checkout
- The ability to display saved payment methods to buyers for future purchases
- The Appearance API, which allows you to customize the look and feel to match your app
Migrate to the Mobile Payment Element
Basic Integration is often used in one of two ways:
- Checkout page: Users enter their credit card, then click a button in your app to complete their purchase.
- Wallet: Users add a credit card to your app, then use that credit card to pay later in a different flow.
Select the tab below that matches your use case, either Checkout page or a wallet:
Check for other legacy dependencies
Upgrading to the Mobile Payment Element requires you to update other dependencies within your mobile integration. Review the following sections to make sure your migration is comprehensive.
Migrate from the Charges API
If your integration still uses the Charges API with tokens, you must migrate to the Intents API. The Mobile Payment Element integration guide linked above includes details on how to use Intents. You can also review Migrating to the Payment Intents API for more details.
Convert your configuration
Basic Integration uses a configuration object to customize your integration (STPPaymentConfiguration
for iOS, and PaymentSessionConfig
for Android). Convert your Basic Integration configuration to a PaymentSheet.
to customize Mobile Payment Element.