リダイレクトの動作をカスタマイズする

支払い完了後に Stripe が顧客をリダイレクトするかどうかとその方法をカスタマイズできます。Stripe で常に顧客をリダイレクトするか、一部の決済手段の場合のみリダイレクトするように設定できます。

リダイレクトを設定するには、戻りページを指定します。

• サーバーで Checkout セッションを作成するときは return_url で。
• クライアントで Checkout セッションを確定するときは returnUrl で。

または、決済手段で必要な場合にのみ顧客をリダイレクトすることもできます (口座引き落としによる決済手段での銀行認証ページなど)。

顧客を戻り先ページにリダイレクトする

Checkout セッションを作成する際に、return_urlに戻りページの URL を指定します。return_url に {CHECKOUT_SESSION_ID} テンプレート変数を追加して、完了した Checkout セッションの ID を含めることができます。これはリテラル文字列であり、ここに示されているように正確に追加する必要があります。これを Checkout Session ID に置き換えてはいけません。置き換えは、顧客が支払いを終えて、成功ページにリダイレクトされた後に自動的に行われます。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/return?session_id={CHECKOUT_SESSION_ID}"

リダイレクトベースの支払い方法

決済の進行中、決済手段によっては、発行会社/銀行のオーソリページなどの中間ページに顧客がリダイレクトされる場合があります。そのページでの操作を完了した顧客は、Stripe によって戻り先ページにリダイレクトされます。

中間ページにリダイレクトされた場合にのみ顧客を戻りページにリダイレクトするには、Checkout セッションを確定するときに redirect: 'if_required' を設定します。