PayPal による支払いを受け付ける

支払いが完了すると、Stripe は payment_intent.succeeded イベントを送信します。ダッシュボード、カスタム Webhook、またはパートナーソリューションを使用してこれらのイベントを受信し、また、顧客への注文確認メールの送信、データベースでの売上の記録、配送ワークフローの開始などのアクションを実行します。

クライアントからのコールバックを待つのではなく、これらのイベントをリッスンします。クライアント側では、コールバックが実行される前に顧客がブラウザーのウィンドウを閉じたり、アプリを終了したりする可能性があります。また、悪意を持つクライアントがレスポンスを不正操作する恐れもあります。非同期型のイベントをリッスンするよう構築済みのシステムを設定することで、これ以降はより多くの決済手段を簡単に受け付けられるようになります。サポートされているすべての決済手段の違いをご確認ください。

イベントを受信し、ビジネスアクションを実行する

ビジネスアクションを受信して実行するためのいくつかのオプションがあります。

手動

Stripe ダッシュボードは、すべての Stripe での支払いの確認、メール領収書の送信、入金処理、または失敗した支払いの再試行に使用できます。

• ダッシュボードでテスト支払いを確認する

カスタムコード

Webhook ハンドラを作成してイベントをリッスンし、非同期型のカスタムの支払いフローを作成します。Stripe CLI を使用して、ローカルで Webhook 組み込みのテストとデバッグを行います。

• カスタム Webhook を作成する

事前構築のアプリ

オートメーションやマーケティングとセールスなどの一般的なビジネスイベントを、パートナーアプリケーションとの連携によって処理します。

Stripe.js を使用すると、実装を他の支払い方法に拡張することができます。ただし、お客様のサーバーに顧客を手動でリダイレクトすることもできます。

1. タイプが paypal の PaymentIntent を作成し、確定します。payment_method_data を指定すると、PaymentMethod が作成され、PaymentIntent ですぐに使用されます。

また、顧客が支払いを完了した後にリダイレクトされる先の URL を return_url フィールドに指定する必要があります。独自のクエリパラメータをこの URL に指定することもできます。これらのパラメータは、リダイレクトフロー完了時の最終的な URL に含められます。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  --data-urlencode return_url="https://example.com/checkout/complete" \
  -d confirm=true

1. PaymentIntent のステータスが requires_action であることと、next_action のタイプが redirect_to_url であることを確認します。

{
  "status": "requires_action",
  "next_action": {
    "type": "redirect_to_url",
    "redirect_to_url": {
      "url": "https://hooks.stripe.com/...",
      "return_url": "https://example.com/checkout/complete"
    }
  },
  "id": "pi_1G1sgdKi6xqXeNtkldRRE6HT",
  "object": "payment_intent",
  ...
}

1. next_action.redirect_to_url.url プロパティで指定された URL に顧客をリダイレクトします。ここでのコード例はおおまかなものであり、リダイレクト方法は、お客様のウェブフレームワークによって異なることがあります。

if payment_intent.status == 'requires_action' && payment_intent.next_action.type == 'redirect_to_url'
  url = payment_intent.next_action.redirect_to_url.url
  redirect(url)
end

支払いプロセスが完了すると、顧客は return_url にリダイレクトされます。payment_intent および payment_intent_client_secret URL クエリパラメーターは、お客様独自のクエリパラメーターと併せて含まれています。支払いのステータスをプログラムで確認するために、Webhook エンドポイントを設定することをお勧めします。

PayPal は、オーソリとキャプチャーの分離に対応しています。Stripe での売上処理を選択した場合オーソリは 10 日間有効です。Stripe は自動的に支払いを再度オーソリして、オーソリ期間をさらに 10 日間延長します。これにより有効期限は合計 20 日間になります。再オーソリが機能しない場合、Stripe は支払いを 10 日後すぐに期限切れにします。オーソリ期間の終了を把握するには、charge.expired Webhook をリッスンします。

PayPal での売上処理を選択した場合、オーソリは 3 日間有効なままになります。Stripe はオーソリ期間をさらに 3 日間延長します。最大 10 日間の延長されたオーソリの保証期間 (PayPal では「引受期間」と呼ばれます) については、PayPal サポートにお問い合わせください。

オーソリのみ行うように Stripe に指示する

オーソリとキャプチャーの分離を指定するには、PaymentIntent の作成時に capture_method を manual に設定します。このパラメーターは、顧客の PayPal アカウントの金額のみをオーソリするように Stripe に指示します。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d capture_method=manual \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  -d confirm=true \
  --data-urlencode return_url="http://example.com"

オーソリが成功すると、Stripe は payment_intent.amount_capturable_updated イベントを送信します。詳細については、イベントガイドをご確認ください。

売上をキャプチャする

オーソリが完了すると、PaymentIntent のステータス は requires_capture に移行します。オーソリ済みの売上をキャプチャーするには、PaymentIntent のキャプチャーリクエストを作成します。デフォルトではオーソリ済みの総額がキャプチャーされます。これを超える金額をキャプチャーすることはできませんが、これより少ない金額をキャプチャーすることは可能です。

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=750

任意オーソリをキャンセルする

オーソリをキャンセルする必要がある場合は、PaymentIntent をキャンセルしてください。

デフォルトでは、Stripe は PayPal を使用した同期型の決済手段のみ許可します。これにより、各支払いの成功または失敗に関する即時通知を確実に受け取ることができます。非同期型の決済手段を許可すると、一部の支払いで通知の遅延が発生することがあります。このような支払いの成功または失敗に関する通知を受け取るには、Webhook エンドポイントを使用します。

PayPal で非同期型の支払いを有効にするには、Stripe サポートにお問い合わせください。

これらは、PayPal を導入する際の一般的なエラーコードと対応する詳細です。PayPal API リクエストがエラーを返す場合、エラーにはリクエストの PayPal 問題コードとデバッグ ID が含まれます。サポートが必要な場合は、デバッグ ID を使用して PayPal サポートにお問い合わせいただけます。

PayPal の導入で支払いの成功をテストするには、テスト API キーを使用して、リダイレクトページを表示します。このページには、テストシナリオとしてユーザー認証のオーソリまたは失敗のオプションが表示されます。Authorize test payment (テスト支払いをオーソリする) を選択すると、PaymentIntent は requires_action から succeeded に移行します。

ユーザーが認証に失敗するケースをテストするには、テスト API キーを使用してリダイレクトページを表示します。リダイレクトページで Fail test payment (テスト支払い失敗) をクリックします。PaymentIntent が、requires_action から requires_payment_method に変化します。

PayPal 支払いで最も一般的な導入と失敗シナリオをシミュレーションするには、PaymentIntent の作成時に、請求詳細の一部として、テストシナリオで説明されているパターンと一致する email 値を渡します。たとえば、サーバー側で PaymentIntent を確定する際に、PayPal によって拒否される取引をシミュレーションするリクエストは以下のようになります。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  --data-urlencode "payment_method_data[billing_details][email]"="transaction_refused@example.com"

テストシナリオ