コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成サインイン
導入方法
決済管理
売上管理
プラットフォームとマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ
概要
Stripe Payments について
構築済みのシステムをアップグレード
決済分析
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する
Payment Links を使用する
事前構築済みの決済ページを使用する
Elements を使用したカスタム統合の構築
    概要
    Quickstart ガイド
    Stripe Elements
    Checkout Sessions と PaymentIntent の比較
    高度なシステムを設計
    デザインをカスタマイズする
    決済手段を管理
      Express Checkout Element で決済を受け付ける
      カスタムの決済手段を追加する
      支払い方法をカスタマイズする
      ダッシュボードに支払い方法を移行
    追加情報を収集する
    サブスクリプションの実装
    動的な更新
    割引を追加する
    支払いで税金を徴収
    クレジットを使って引き換える
    顧客が現地通貨で支払いできるようにする
    顧客の決済手段を保存および取得する
    領収書と支払い済みの請求書を送信する
    サーバーで支払いを手動で承認する
    支払いのオーソリとキャプチャーを分離する
    Elements with Checkout Sessions API ベータ版の変更ログ
アプリ内実装を構築
対面決済
Terminal
決済手段
決済手段を追加
決済手段を管理
Link による購入の迅速化
決済シナリオ
複数の通貨を扱う
カスタムの決済フロー
柔軟なアクワイアリング
オーケストレーション
決済以外の機能
会社を設立する
暗号資産
エージェント型コマース
Financial Connections
Climate
不正利用について
Radar の不正防止
不審請求の申請の管理
本人確認
アメリカ
日本語
ホーム決済管理Build a custom integration with ElementsManage payment methods

ダッシュボードに決済手段を移行

ダッシュボードで Checkout Session の決済手段を有効にする方法をご紹介します。

ダッシュボードから決済手段の設定を使用するように導入を更新できます。これにより、Stripe は、選択した通貨、所在地、決済手段の制限 (最大取引額など) に応じて、決済中に互換性のある決済手段をすべて顧客に表示できます。

決済ページには、顧客の所在地のコンバージョン率を高める決済手段が表示され、オーバーフローメニューにはその他の決済手段が非表示になります。顧客は、引き続きオーバーフローメニューの決済手段から選択できます。

導入を更新する

既存の Stripe Checkout の連携である場合、payment_method_types パラメーターを削除して、決済手段の設定をダッシュボードに移行する必要があります。連携からパラメーターを削除すると、カードやウォレットなどの一部の決済手段は自動的に有効になります。currency パラメーターにより、Checkout Session の際に顧客に提示する決済手段が制限されます。

警告

導入をアップグレードすると、デフォルト以外の決済手段 (銀行へのリダイレクトなど) は最初に無効になります。決済の導入に追加した決済手段は、ダッシュボードの決済手段の設定ページから有効にする必要があります。

server.rb
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Stripe::Checkout::Session.create({ line_items: [ { price_data: { currency: 'eur', product_data: {name: 'T-shirt'}, unit_amount: 2000, }, quantity: 1, }, ], mode: 'payment', # Remove the payment_method_types parameter to manage payment methods in the Dashboard payment_method_types: ['card'], return_url: 'https://example.com/return', ui_mode: 'custom', })

ダッシュボードで使用可能な決済手段を表示する

現在受け付けている決済手段は、ダッシュボードの 決済手段設定 から確認できます。リストには、カードなど、Stripe がデフォルトで有効にしている決済手段が含まれています。

Apple Pay や Google Pay などの個別決済手段も有効または無効にできます。Checkout Sessions API を使用すると、Stripe は通貨と制限を評価し、サポート対象の決済手段を顧客に動的に表示します。

たとえば、Apple Pay はデフォルトで有効になっており、Google Pay は無効になっています。これらの決済手段を有効にしても、Stripe が表示されない場合があります。配送先住所を収集せずに 税金の自動 計算を有効にしている場合、Stripe は Google Pay を表示しません。

Stripe が顧客に決済手段をどのように表示するかを確認するには、ダッシュボードで取引 ID を入力するか、注文金額と通貨を設定します。

導入で決済手段を追加または削除する

ダッシュボードの 決済手段設定 から導入の決済手段を有効にします。有効にする を選択して、一部の決済手段を有効にできます。追加の手順が必要な決済手段については、設定 または 規約のレビュー を選択します。

ビジネスに適した決済手段については、Stripe の 決済手段ガイド を参照してください。

(推奨) 通知遅延型の決済手段を処理する

導入した決済手段で決済確定が遅れる場合があります。注文の 自動フルフィルメント を実行するように 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 セッション) オブジェクトが含まれます。

イベントハンドラーを更新して、注文のフルフィルメントを実行します。

Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Set your secret key. Remember to switch to your live secret key in production. # See your keys here: https://dashboard.stripe.com/apikeys Stripe.api_key =
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'
# You can find your endpoint's secret in the output of the `stripe listen` # command you ran earlier endpoint_secret = 'whsec_...' post '/webhook' do event = nil # Verify webhook signature and extract the event # See https://stripe.com/docs/webhooks#verify-events for more information. begin sig_header = request.env['HTTP_STRIPE_SIGNATURE'] payload = request.body.read event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret) rescue JSON::ParserError => e # Invalid payload return status 400 rescue Stripe::SignatureVerificationError => e # Invalid signature return status 400 end case event['type'] if event['type'] == 'checkout.session.completed' checkout_session = event['data']['object'] fulfill_order(checkout_session) end when 'checkout.session.completed' checkout_session = event['data']['object'] # Save an order in your database, marked as 'awaiting payment' create_order(checkout_session) # Check if the order is already paid (for example, from a card payment) # # A delayed notification payment will have an `unpaid` status, as # you're still waiting for funds to be transferred from the customer's # account. if checkout_session.payment_status == 'paid' fulfill_order(checkout_session) end when 'checkout.session.async_payment_succeeded' checkout_session = event['data']['object'] # Fulfill the purchase... fulfill_order(checkout_session) when 'checkout.session.async_payment_failed' session = event['data']['object'] # Send an email to the customer asking them to retry their order email_customer_about_failed_payment(checkout_session) end status 200 end def fulfill_order(checkout_session) # TODO: fill in with your own logic puts "Fulfilling order for #{checkout_session.inspect}" end def create_order(checkout_session) # TODO: fill in with your own logic puts "Creating order for #{checkout_session.inspect}" end def email_customer_about_failed_payment(checkout_session) # TODO: fill in with your own logic puts "Emailing customer about payment failure for: #{checkout_session.inspect}" end

テスト

stripe listen の実行が続いていることを確認します。前のステップで行ったように、テストユーザーとして Checkout を実行します。イベントハンドラーが checkout.session.completed イベントを受信し、イベントが正常に処理されています。

これですべてのステップを完了しました。いつでも本番環境に移行する準備ができています。

導入をテストする

カード番号シナリオテスト方法
カード支払いは成功し、認証は必要とされません。クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
カード支払いには認証が必要です。クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
カードは、insufficient_funds などの拒否コードで拒否されます。クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。
UnionPay カードは、13 ~ 19 桁の可変長です。クレジットカード番号と、任意の有効期限、セキュリティコード、郵便番号を使用してクレジットカードフォームに入力します。

実装内容をテストするためのその他の情報については、テストをご覧ください。

このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM ですか?llms.txt を読んでください。
  • Powered by Markdoc