コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する継続課金
対面決済
決済手段
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

Vipps による支払い非公開プレビュー

ノルウェーで一般的な支払い方法である Vipps を受け付ける方法をご紹介します。

Vipps は、ノルウェーで使用されている 1 回限りの使用のカードウォレット決済手段です。顧客は Vipps アプリを使用して、支払いを認証して承認できます。

顧客が Vipps で支払う場合、Stripe は Vipps から受け取ったカードデータを使用してカード取引を実行します。カード取引の処理は実装には表示されず、Stripe は支払いの成功または失敗を直ちに通知します。

注意

Stripe は、通貨、支払い方法の制限、その他のパラメーターを評価することで、適切な支払い方法を顧客に自動的に提示できます。

  • Follow the Accept a payment guide to build a Checkout integration that uses dynamic payment methods.
  • 動的な決済手段を使用しない場合は、チェックアウトの導入で、決済方法を手動で設定するために以下のステップに従ってください。

このガイドでは Stripe がホストする決済フォーム、Checkout で Vipps を有効にする方法をご案内しています。また動的な決済方法を使用した支払いの受け付けと手動で設定する決済方法との違いをご確認ください。

互換性を判定する

Vipps の支払いに対応するには、Checkout セッションが次の条件をすべて満たしている必要があります。

  • すべての項目の価格を、ノルウェークローネ (通貨コード NOK) で示す必要があります。

Stripe を設定する
サーバー側

まず、Stripe アカウントが必要です。今すぐ登録してください。

公式ライブラリを使用して、アプリケーションから Stripe API にアクセスします。

Command Line
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

支払いを受け入れる

メモ

このガイドは、基本的な決済を受け付ける Checkout の実装を基盤にしています。

決済手段として Vipps を有効にします

新しい Checkout セッションを作成する際は、次のことを行う必要があります。

  1. リクエストがあった場合には API バージョン と共に vipps_preview=v1 のプレビューヘッダーを提供します。
  2. vipps を payment_method_types の一覧に追加します。
  3. すべての line_items が nok を通貨として使用していることを確認してください。
Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; vipps_preview=v1" \
  -d "line_items[0][price_data][currency]"=nok \
  -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 "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=vipps \
  --data-urlencode success_url="https://example.com/success"

注文のフルフィルメント

決済受け付け後に、注文のフルフィルメントを実行する方法を説明します。

支払い後のイベントを処理する

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

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

  • ダッシュボードでイベントを手動で処理する

    ダッシュボードを使用して、テスト決済をダッシュボードで表示したり、メール領収書を送信したり、入金を処理したり、失敗した決済を再試行したりできます。

  • Custom Webhook を構築する

    Build a custom webhook handler to listen for events and build custom asynchronous payment flows. Test and debug your webhook integration locally with the Stripe CLI.

  • 構築済みアプリを導入する

    パートナーアプリケーションを統合することで、自動化やマーケティング/セールスなどの一般的なビジネスイベントを処理します。

組み込みをテストする

テスト環境で実装内容をテストする場合、テスト決済ページにリダイレクトされ、ここでテスト決済を承認または拒否できます。

本番環境で、Vipps に関連付けられている電話番号を入力すると、Vipps モバイルアプリにプッシュ通知が送信されます。Vipps モバイルアプリで支払いを承認または拒否できます。

決済をオーソリし、後でキャプチャ

Vipps は、7 日間の保持期間でオーソリとキャプチャーの分離に対応しています。7 日間の保持期間中に支払いがキャプチャーされない場合、Stripe は決済をキャンセルし、payment_intent.canceled イベントを送信します。

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

オーソリとキャプチャーの分離を指定するには、Checkout セッションの作成時に capture_method を manual に設定します。このパラメーターは、Vipps に関連付けられている顧客のカードの金額のみをオーソリするよう Stripe に指示します。

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; vipps_preview=v1" \
  -d "line_items[0][price_data][currency]"=nok \
  -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 "payment_intent_data[capture_method]"=manual \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=vipps \
  --data-urlencode success_url="https://example.com/success.html"

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

売上をキャプチャーする

オーソリが成功すると、PaymentIntent のステータスが requires_capture に移行し、オーソリされた売上をキャプチャーできるようになります。Stripe は全額の手動キャプチャーにのみ対応しています。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents/
{{PAYMENT_INTENT_ID}}
/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=2000

オプションキャンセル

Vipps 支払いに関連付けられている PaymentIntent をキャンセルすることにより、有効期限が切れる前の Vipps 支払いをキャンセルできます。

失敗した支払い

基になるカード取引が拒否されると、Vipps 取引が失敗する可能性があります。詳細については、カードの支払い拒否をご覧ください。この場合、PaymentMethod は解除され、PaymentIntent のステータスは自動的に requires_payment_method に移行します。

PaymentIntent のステータスが requires_action の場合、顧客は 5 分以内に支払いを認証する必要があります。5 分経過してもアクションが実行されない場合、PaymentMethod は解除され、PaymentIntent のステータスは自動的に requires_payment_method に移行します。

返金と不審請求の申請

Stripe は、Vipps 取引の一環として標準のカードネットワークを使用してカード取引を実行します。返金 と不審請求の申し立てには、Visa と Mastercard のネットワーク規則が適用されます。

参照情報