カスタムの決済手段を追加する公開プレビュー
Payment Element にカスタムの決済手段を追加します。
In-app Payments を使用すると、ユーザーは一度の導入で多くの 支払い方法 で支払うことができます。Stripe で処理されない追加の支払い方法を表示する必要がある場合は、カスタムの支払い方法を使用します。カスタムの支払い方法を使用する場合は、Stripe 以外で処理された購入をオプションで Stripe アカウントに記録して、レポートを作成することもできます。
カスタム支払い方法を設定するには、Stripe ダッシュボードで支払い方法を作成し、In-app Payments でも表示する表示名とアイコンを指定します。Stripe ダッシュボードでは、50 種類を超える事前設定されたカスタム支払い方法にアクセスすることもできます。支払い方法を作成したら、以下のガイドに従って In-app Payments を設定します。カスタム支払い方法の取引は Stripe の外部で処理され確定されるため、In-app Payments を設定するには、追加の設定作業が必要になります。
注
サードパーティーの決済代行業者と連携する場合、PSP との取り決めや適用法など、法的要件に準拠する責任を負います。
はじめに
- Stripe アカウントを作成するか、サインインしてください。
- アプリ内決済受け付けガイドに従って、決済システムの構築を完了します。
設定 > Payments > Custom の決済手段に移動して、カスタムの決済手段のページにアクセスします。新しいカスタムの決済手段を作成し、Payment Element が表示する表示名とロゴを指定します。
適切なロゴを選択
- 透明な背景のロゴを提供する場合は、ページの Payment Element の背景色を考慮して、ロゴがはっきりと表示されることを確認してください。
- 背景色が入ったロゴを指定する場合、丸い角は提供されないため、ファイルに含めるようにしてください。
- 16 ピクセル× 16 ピクセルに拡大縮小できるロゴのバリアントを選択します。多くの場合、これはブランドのスタンドアロンのロゴマークです。
カスタムの決済手段を作成すると、ステップ 2 で必要なカスタムの決済手段の ID (cpmt_ で始まる) がダッシュボードに表示されます。
EmbeddedPaymentElement. オブジェクトを作成して EmbeddedPaymentElement を初期化するときに、Payment Element に追加するカスタム決済手段と、決済を完了するためのハンドラを指定します。
EmbeddedPaymentElement インスタンスで confirm を呼び出し、顧客がカスタムの決済手段を選択すると、カスタムの決済手段を持つハンドラが呼び出され、シートで収集された請求情報が使用されます。
システムが (たとえば、カスタム決済手段のプロバイダーの SDK を使用して) 支払いを完了すると、支払いの結果 (completed、canceled、failure(error:)) を関数から返します。
カスタムの決済手段に関する情報がないため、Stripe のスマート注文ロジックは決済手段をランク付けできません。デフォルトでは、Stripe がサポートしている決済手段の後に表示されます。Mobile Payment Element にカスタムの決済手段を配置するには、EmbeddedPaymentElement. を設定します。そのカスタム決済手段の後に続く Stripe がサポートしている決済手段は、引き続きインテリジェントにランク付けされます。
請求詳細は、Payment Element 設定で billingDetailsCollectionConfiguration を使用して収集することができます。ただし、カスタム決済手段はデフォルトでは請求詳細を収集しません。請求詳細の収集を有効にするには、CustomPaymentMethod で disableBillingDetailCollection を false に設定します。