ダッシュボードに決済手段を移行
ダッシュボードで Checkout Session の決済手段を有効にする方法をご紹介します。
ダッシュボードから決済手段の設定を使用するように導入を更新できます。これにより、Stripe は、選択した通貨、所在地、決済手段の制限 (最大取引額など) に応じて、決済中に互換性のある決済手段をすべて顧客に表示できます。
決済ページには、顧客の所在地のコンバージョン率を高める決済手段が表示され、オーバーフローメニューにはその他の決済手段が非表示になります。顧客は、引き続きオーバーフローメニューの決済手段から選択できます。
導入を更新する
既存の Stripe Checkout の連携である場合、payment_ パラメーターを削除して、決済手段の設定をダッシュボードに移行する必要があります。連携からパラメーターを削除すると、カードやウォレットなどの一部の決済手段は自動的に有効になります。currency パラメーターにより、Checkout Session の際に顧客に提示する決済手段が制限されます。
警告
導入をアップグレードすると、デフォルト以外の決済手段 (銀行へのリダイレクトなど) は最初に無効になります。決済の導入に追加した決済手段は、ダッシュボードの決済手段の設定ページから有効にする必要があります。
ダッシュボードで使用可能な決済手段を表示する
現在受け付けている決済手段は、ダッシュボードの 決済手段設定 から確認できます。リストには、カードなど、Stripe がデフォルトで有効にしている決済手段が含まれています。
Apple Pay や Google Pay などの個別決済手段も有効または無効にできます。Checkout Sessions API を使用すると、Stripe は通貨と制限を評価し、サポート対象の決済手段を顧客に動的に表示します。
たとえば、Apple Pay はデフォルトで有効になっており、Google Pay は無効になっています。これらの決済手段を有効にしても、Stripe が表示されない場合があります。配送先住所を収集せずに 税金の自動 計算を有効にしている場合、Stripe は Google Pay を表示しません。
Stripe が顧客に決済手段をどのように表示するかを確認するには、ダッシュボードで取引 ID を入力するか、注文金額と通貨を設定します。
(推奨) 通知遅延型の決済手段を処理する
導入した決済手段で決済確定が遅れる場合があります。注文の 自動フルフィルメント を実行するように Webhook を設定している場合、通知が遅延する決済手段を初めて追加する際に、決済導入の更新が必要になることがあります。
注意
このステップは、Bacs ダイレクトデビット、銀行振込、Boleto、カナダのプレオーソリデビット、コンビニ決済、OXXO、Pay by Bank、SEPA ダイレクトデビット、ACH Direct Debit のいずれかの支払い方法を使用する場合にのみ必要です。
遅延通知型の支払い方法で支払いを受け取る場合、売上はすぐには利用可能になりません。売上の処理までに数日かかることがあるため、売上がアカウントで利用可能になるまで注文のフルフィルメントを保留する必要があります。支払いが成功すると、基本となる PaymentIntent のステータスが processing から succeeded に変わります。
以下の Checkout イベントを処理する必要があります。
| イベント名 | 説明 | 次のステップ |
|---|---|---|
| checkout.session.completed | 顧客が Checkout フォームを送信して、デビット支払いのオーソリを正常に完了しました。 | 支払いが成功するか、失敗するかの結果を待ちます。 |
| checkout.session.async_payment_succeeded | 顧客の支払いが成功しました。 | 顧客の購入商品またはサービスのフルフィルメントを行います。 |
| checkout.session.async_payment_failed | 何らかの理由により支払いが拒否されたか、失敗しました。 | 顧客にメールで連絡して、新たに注文を行うようリクエストします。 |
これらのイベントすべてに Checkout Session (Checkout セッション) オブジェクトが含まれます。
イベントハンドラーを更新して、注文のフルフィルメントを実行します。
テスト
stripe listen の実行が続いていることを確認します。前のステップで行ったように、テストユーザーとして Checkout を実行します。イベントハンドラーが checkout. イベントを受信し、イベントが正常に処理されています。
これですべてのステップを完了しました。いつでも本番環境に移行する準備ができています。