Card Element の Link
Card Element で Link を使用した購入を有効にします。
注意
Stripe は、現在では Card Element の導入に支払いリクエストボタンを使用することを推奨していません。Link を導入するには、推奨される Elements (Link Authentication Element、Express Checkout Element、Payment Element) のいずれかを使用します。
Card Element の Link を使用すると、顧客の支払い情報を保存して自動入力できます。これにより、顧客が支払いの詳細を手動で入力する必要がなくなります。
Card Element では 2 種類のフォームとして、単一行の Card Element、または分割 Element (Card Number、Expiry、CVC など) を使用できます。Card Element の説明において、以下の情報はどちらのフォームにも適用されます。
Link のフロー
Link の有効化
Link は、アクセスが許可されているすべての企業 (詳細は下記の注を参照) に対して Card Element でグローバルにサポートされており、追加料金もコード変更も必要ありません。Link は、カード決済の他の機能と完全な互換性があります。
Stripeは、Card Element で Link を自動的に有効にします。支払い方法の設定で、Card Element のすべてのインスタンスに対して Link を無効化できます。Link セクションで、Link 行の横にあるオーバーフローメニュー () をクリックし、Link in Card Element を無効にします。この設定は、Card Element の両方の形式に適用されます。また、disableLink パラメーターを true に設定して、Card Element の Link を無効にすることもできます。Card Element の Link を非表示にするために使用すべきコントロールは、これらのうち 1 つのみです。
次の場合、Link は Card Element で表示「されません」。
Link ボタンを表示するには、Card Element がマウントされている親コンテナーの高さまたは幅が不足しています。通常、幅は 350px、高さは 28px 以上でなければなりません。ただし、フォントサイズ、ロケール、プレースホルダーテキスト、カードアイコンの表示などの他の要素も、これらの要件に影響する場合があります。
Card Element が、ポップアップに対応していないブラウザー (アプリ内のブラウザーを含む) に表示されている。サポート対象のブラウザーに関する情報を表示してください。
Cross-Origin-Opener-Policy が
same-originに設定されている。Link ポップアップはそれを開いたページと通信する必要があるため、Card Element の Link はこの通信をブロックする設定と互換性がありません。
注
Card Element の Link は段階的にリリースされています。単一行の Card Element の Link は 2023 年にリリースされ、分割 Elements の Link は 2023 年後半と 2024 年前半にリリースされました。アクセスが許可されているアカウントにのみ支払い方法の設定で Card Element の Link が表示され、本番環境やテスト環境で Link を使用することができます。Link は現在、インドを拠点とする Stripe アカウントに対応していません。
Card Element と支払いリクエストボタンを使用する
Link は支払いリクエストボタンでも利用できます。Card Element の Link は、支払いリクエストボタンの Link に依存することなく動作します。支払いリクエストボタンと Card Element の両方を使用している場合、Link は購入時に両方で表示されることがあります。支払いリクエストボタンで Link が表示される場合について詳しくは、支払いリクエストボタンの Link をご覧ください。
Link と Connect プラットフォーム
Connect プラットフォーム経由で Card Element にアクセスする連結アカウントは、自動的に Card Element で Link を利用できます。プラットフォームの導入状況によっては、プラットフォームは利用者 (連結アカウント) にダッシュボードで Link 設定をカスタマイズする機能を提供できる場合があります。
連結されたプラットフォームの対象要件
プラットフォームが次の条件をすべて満たす場合、連結アカウントはダッシュボードで直接、Link 設定を管理できます。
ダイレクト支払いを使用します。
連結アカウントの支払い方法を作成して請求します。
連結アカウントは Stripe ダッシュボードの全機能を利用できます。
プラットフォーム上のすべての連結アカウントに対してデフォルト状態を設定するには、以下の手順を実行します。
支払い方法の設定画面で、連結アカウントの設定の編集をクリックします。
Link セクションの Card Element での Link に移動します。
対象外の連結されたプラットフォーム
次の場合、Link はプラットフォームアカウントの設定で管理されるため、連結アカウントは、プラットフォームを通じて処理される支払いの Link 設定をカスタマイズできません。
プラットフォームで支払い方法を作成し、連結アカウントに支払い方法を複製する
デスティネーション支払いまたは支払いと送金別方式を使用する。
連結アカウントは Stripe ダッシュボードの一部の機能を利用できない。
プラットフォームのアカウント設定を管理するには、以下の手順を実行します。
支払い方法の設定画面で、お客様のアカウントの設定の編集をクリックします。
Link セクションの Card Element の Link に移動します。特定の連結アカウントのみで Link を無効にするには、disableLink パラメーターを使用します。
連結アカウントの支払い処理
プラットフォームが連結アカウントに対して、プラットフォームでの支払いに Link 設定をカスタマイズできる機能を提供している場合は、支払い方法の設定でページ上部にあるドロップダウンメニューからプラットフォームを選択すると、「Card Element の Link」設定を管理できます。
利用しているプラットフォームが設定のカスタマイズ機能を提供できない場合、プラットフォームは自身のプラットフォームで処理するすべての取引に対して Link を使用できるようにするかどうかを決定します。ダッシュボードには、連結アカウントがプラットフォームでの支払いを管理する設定はありません。
プラットフォームを利用せずに処理する支払いの場合は、支払いの設定でページ上部にあるドロップダウンメニューから「プラットフォームなし」を選択することで、Link を管理できます。
Card Element で Link をテストする
注意
テスト環境の Link アカウントには実際のユーザーデータを保存しないでください。テストアカウントは公開可能キーに関連付けられているため、公開可能なものとして扱ってください。
Link は次のブラウザーに対応しています。
Chrome、Chromeモバイル、Microsoft Edge。
デスクトップおよび iOS の Safari (最新の 3 つのメジャーバージョン)。
Link は、本番環境とテスト環境の両方で利用できます。有効なメールアドレスを使用してテスト環境の Link アカウントを作成できます。次の表に記載されているのは、Link のテスト環境のアカウント認証に使用できる、固定値のワンタイムパスコードです。
| 値 | 結果 |
|---|---|
| 以下に記載されていない任意の 6 桁の数字 | 成功 |
| 000001 | エラー: コードが無効です |
| 000002 | エラー: コードの有効期限が切れています |
| 000003 | エラー: 最大試行回数を超えました |
テスト環境で Link を有効にすると、有効化の要件を満たすテスト環境のすべての Card Element のセッションで Link が表示されます。本番環境では、決済フローの各セッションでの Link の購入完了率を最大化するために、Link を表示するかどうかが変わることがあります。