基本的な実装からモバイル Payment Element に移行する

レガシーのモバイル SDK 実装を SDK から削除される前にアップグレードします。

2024 年 11 月 4 日より、Stripe の iOS SDK、Android SDK、React Native SDK では、クレジットカードとウォレットの支払いを回収するためのレガシーの基本的な実装はサポートされなくなります。

2024 年 11 月 4 日以降に公開された SDK バージョンを使用するには、アプリ内の基本的な実装のコード参照を削除し、モバイル Payment Element にアップグレードする必要があります。
旧バージョンの SDK でも決済を処理できますが、重要なセキュリティの拡張機能や新機能を利用できないリスクがあります。

モバイル Payment Element にアップグレードすると、以下にアクセスできるようになります。

Stripe のスピーディーな決済である Link など、100 を超えるグローバルな決済手段に対応
買い手が将来の購入に備えて保存した決済手段を表示する機能
Appearance API では、アプリのデザインに合わせて外観をカスタマイズできます

iOS の場合、基本的な実装には以下が含まれます。

STPCustomerContext
STPPaymentContext
STPPaymentOptionsViewController
STPAddCardViewController
STPShippingAddressViewController

Android の場合、基本的な実装には以下が含まれます。

CustomerSession
PaymentSession
PaymentMethodsActivity
AddPaymentMethodActivity
PaymentFlowActivity

モバイル Payment Element に移行する

基本的な実装は通常、次の 2 つのいずれかの方法で使用されます。

決済ページ: ユーザーはクレジットカードを入力し、アプリのボタンをクリックして購入を完了します。
ウォレット: ユーザーはアプリにクレジットカードを追加し、そのクレジットカードを使用して後から別のフローで支払いを行います。

決済ページまたはウォレットの中から、ユースケースに一致するタブを以下から選択します。

次の実装ガイドを使用して、アプリの決済ページにモバイル Payment Element を実装します。

上記のリンクに記載されている導入ガイドは、いくつかの重要な点において、デフォルトの Mobile Payment Element の導入ガイドとは異なります。

Flow Controller

モバイル Payment Element には、「Flow Controller」 (SDK から PaymentSheet.FlowController としてインポート) というバリアントがあります。基本的な実装と同様に、Flow Controller を使用すると、支払いの詳細を画面で収集して、ユーザーが決済で最終的な支払うボタンをタップしたときに、支払いを処理することができます。

インテントの作成時間

基本的な実装からモバイル Payment Element に移行する際、モバイル Payment Element をレンダリングした後に、PaymentSheet.IntentConfiguration オブジェクトを PaymentSheet に指定することによってインテントを作成します。PaymentSheet.IntentConfiguration オブジェクトの mode プロパティを payment に設定して、取引の金額と通貨を指定します。

将来使用するための設定

基本的な実装では、ユーザーは、モバイルアプリケーションでアカウントにカードを追加できます。PaymentSheet.FlowController で同じ動作を得るには、PaymentSheet.IntentConfiguration オブジェクトの setupFutureUsage パラメーターを onSession に設定します。

その他のレガシーの依存関係を確認する

モバイル Payment Element にアップグレードするには、モバイル実装内の他の依存関係を更新する必要があります。以降のセクションを確認して、移行が包括的なものであることを確認してください。

Charges API から移行する

トークン付きの Charges API をシステムで引き続き使用している場合は、Intents API に移行する必要があります。上記のリンクのモバイル Payment Element の導入ガイドでは、Intents の使用法を説明しています。また、詳細を Payment Intents API への移行で確認できます。

設定を変換する

基本的な実装では、設定オブジェクトを使用して、実装 (iOS では STPPaymentConfiguration、Android では PaymentSessionConfig) をカスタマイズします。モバイル Payment Element をカスタマイズするには、基本的な実装の設定を PaymentSheet.Configuration に変換します。