PayPal による支払いを受け付ける
PayPal は再利用可能な、即時通知型の決済手段であり、利用者は支払いの認証を求められます。PayPal を使用して支払う場合、利用者はプラットフォームのウェブサイトから PayPal にリダイレクトされ、そこで資金供給元 (PayPal ウォレット、関連付けられたカード、または PayPal が提供する後払いなど) を選択し、支払いを認証します。認証プロセスが完了すると、再度ウェブサイトにリダイレクトされます。
Stripe Checkout と Express Checkout Element はどちらも、スタンドアロンの PayPal ボタンに対応しています。このボタンを使用すると、購入者は以前 PayPal に保存した配送先および請求先情報を再利用できるため、購入時に再入力する必要がありません。また、このボタンをクリックする場合、利用者はポップアップ (?window/modal/redirected/embedded) から支払いを承認できるため、購入プロセス全体を通じてお客様のウェブサイトにとどまることができます。Stripe は、このボタンでは 1 回限りの (継続支払いではない) PayPal 支払いにのみ対応しています。
注意
Stripe は、顧客の通貨、決済手段の制限、その他のパラメーターを評価して、決済手段オプションを自動的に提示します。決済を受け付けるの手順を使用して、Stripe ダッシュボードから決済手段を設定することをお勧めします。
引き続き、Checkout で顧客に提示する決済手段を手動で設定する必要がある場合は、こちらのガイド (たとえば、_「サブスクリプション」_モードでの決済の受け付け) を使用します。それ以外の場合は、ダッシュボードに移行します。
Stripe Checkout では、どちらのオプションがコンバージョン率を向上する可能性が高いかに応じて、PayPal を標準の決済手段または独立したボタンとして表示します。
互換性を判断する
PayPal の支払いに対応するには、Checkout セッションが次の条件をすべて満たしている必要があります。
- すべてのラインアイテムの価格が、同じ通貨である必要があります。異なる通貨のラインアイテムが存在する場合は、通貨ごとに別の Checkout セッションを作成します。
支払いを受け付ける
注
このガイドを使用する前に、まず Checkout で決済を受け付ける実装を構築します。
このガイドでは、PayPal を有効にする方法を紹介し、カード支払いを受け付ける場合と、PayPal を使用する場合の違いについて説明します。
支払い方法として PayPal を有効にする
新しい Checkout セッションを作成する際は、次のようにします。
paypal
をpayment_method_types
のリストに追加します。- すべての
line_items
が同じ通貨を使用していることを確認します。
注文のフルフィルメント
支払いの受け取り後に、注文のフルフィルメントを実行する方法を説明します。
組み込みをテストする
実装をテストするために PayPal のビジネスアカウントを関連付ける必要はありません。ただし、本番環境での決済を有効にする準備が整ったときには、PayPal と Stripe のアカウントを関連付けてください。
Checkout の実装をテストする際は、決済手段として PayPal を選択し、支払うをクリックします。
To simulate the most common integration and failure scenarios for PayPal payments, pass email
values that match the patterns described in these test scenarios.
テストシナリオ
メールアドレスのパターン | シナリオ | 説明 |
---|---|---|
.*payee_account_restricted@.* | 制限対象の加盟店アカウント | 加盟店アカウントが PayPal によって制限されている場合、支払いのキャプチャーまたはオーソリは、payment_method_unexpected_state エラーで失敗します。オーソリ時にこのパターンに一致するメールアドレスを指定して、オーソリを失敗させます。 |
.*transaction_refused@.* | 拒否された取引 | 取引が PayPal によって拒否された場合、支払いのキャプチャーは、payment_method_provider_decline エラーで失敗します。 |
.*instrument_declined@.* | 拒否された決済手段 | 指定された決済手段が代行業者または銀行によって拒否されたか、この支払いには使用できない場合、支払いのキャプチャーは、payment_method_provider_decline エラーで失敗します。 |
.*lost_dispute@.* | 主張が認められなかった不審請求の申請 | キャプチャー時には、不審請求の申請のみを目的として、支払いインテントが最初は成功します。作成された不審請求の申請は、すでに主張が認められない結果になっているため、加盟店は Stripe ダッシュボードで反証資料を提出することはできません。 |
.*authorization_expired@.* | オーソリ済みの支払いを手動でキャプチャーする | オーソリがすでに期限切れになっている場合、オーソリ済みの支払いのキャプチャーは、capture_charge_authorization_expired エラーで失敗します。 |