Migrate payment methods to the Dashboard
Learn how to turn on payment methods for your Checkout Session in the Dashboard.
You can update your integration to use your payment method preferences from the Dashboard. This allows Stripe to display all compatible payment methods to your customers during checkout, depending on the chosen currency, location, or any payment method restrictions, such as maximum transaction amounts.
The checkout page shows payment methods known to increase conversion for your customer’s location, and hides other payment methods in an overflow menu. Customers can still choose from the payment methods in the overflow menu.
Update your integration
For existing Stripe Checkout integrations, you must remove the payment_
parameter to migrate payment methods preferences to the Dashboard. Doing so allows some payment methods to turn on automatically, including cards and wallets. The currency
parameter restricts the payment methods your customers see in the Checkout Session.
警告
When you upgrade your integration, non-default payment methods (such as bank redirects) are initially disabled. You must enable any payment methods you added to your Checkout integration from the payment methods settings page in the Dashboard.
View available payment methods in the Dashboard
You can view the payment methods that you currently accept from the payment methods settings in the Dashboard. The list includes payment methods that Stripe enables by default, such as cards.
You can also enable or disable individual payment methods, such as Apple Pay or Google Pay. With the Checkout Sessions API, Stripe evaluates the currency and any restrictions, then dynamically presents the supported payment methods to the customer.
For example, Apple Pay is enabled and Google Pay is disabled, by default. In some cases, Stripe might not show these payment methods, even if you enabled them. Stripe doesn’t show Google Pay if you enable automatic tax without collecting a shipping address.
To see how Stripe displays your payment methods to customers, enter a transaction ID or set an order amount and currency in the Dashboard.
Add or remove payment methods in your integration
Enable payment methods for your integration from the payment methods settings in the Dashboard. You can select Turn on to enable some payment methods. For payment methods that require additional steps, select Set up or Review terms.
Learn about which payment methods are right for your business from our payment methods guide.
(Recommended) Handle delayed notification payment methods
The payment method you integrate might have a delayed payment confirmation. If you set up webhooks to automatically fulfill orders, you might need to update your Checkout integration when you add your first payment method that has delayed notifications.
注意
このステップは、Bacs Direct Debit、銀行振込、Boleto、カナダのプレオーソリデビット、コンビニ決済、OXXO、Pay by Bank、SEPA Direct Debit、SOFORT、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.
イベントを受信し、イベントが正常に処理されています。
これですべてのステップを完了しました。いつでも本番環境に移行する準備ができています。
Test your integration
実装内容をテストするためのその他の情報については、テストをご覧ください。