Vipps による支払い非公開プレビュー
ノルウェーで一般的な支払い方法である Vipps を受け付ける方法をご紹介します。
Vipps is a single-use card wallet payment method used in Norway. It allows your customer to authenticate and approve payments using the Vipps app.
When your customer pays with Vipps, Stripe performs a card transaction using the card data we receive from Vipps. The processing of the card transaction is invisible to your integration, and Stripe immediately notifies you whether the payment succeeded or failed.
注意
Stripe は、顧客の通貨、決済手段の制限、その他のパラメーターを評価して、決済手段オプションを自動的に提示します。決済を受け付けるの手順を使用して、Stripe ダッシュボードから決済手段を設定することをお勧めします。
引き続き、Checkout で顧客に提示する決済手段を手動で設定する場合は、このガイドを使用します。それ以外の場合は、ダッシュボードで決済手段を設定できるように、構築済みのシステムを更新してください。
Use this guide to enable Vipps on Checkout, our hosted checkout form, and learn the differences between accepting a card payment and a Vipps payment.
互換性を判定する
A Checkout Session must satisfy all of the following conditions to support Vipps payments:
- Prices for all line items must be expressed in Norwegian Krona (currency code
NOK
).
支払いを受け入れる
注
このガイドは、基本的な決済を受け付ける Checkout の実装を基盤にしています。
Enable Vipps as a payment method
新しい Checkout セッションを作成する際は、次のことを行う必要があります。
- Provide the
vipps_
preview header with your API version on requestspreview=v1 - Add
vipps
to the list ofpayment_
method_ types - Make sure all your
line_
use theitems nok
currency
注文のフルフィルメント
After accepting a payment, learn how to fulfill orders.
支払い後のイベントを処理する
支払いが完了すると、Stripe は payment_intent.succeeded イベントを送信します。ダッシュボード、カスタム Webhook、またはパートナーソリューションを使用してこれらのイベントを受信し、また、顧客への注文確認メールの送信、データベースでの売上の記録、配送ワークフローの開始などのアクションを実行します。
クライアントからのコールバックを待つのではなく、これらのイベントをリッスンします。クライアント側では、コールバックが実行される前に顧客がブラウザーのウィンドウを閉じたり、アプリを終了したりする可能性があります。また、悪意を持つクライアントがレスポンスを不正操作する恐れもあります。非同期型のイベントをリッスンするよう構築済みのシステムを設定することで、これ以降はより多くの決済手段を簡単に受け付けられるようになります。サポートされているすべての決済手段の違いをご確認ください。
手動
Stripe ダッシュボードは、すべての Stripe 支払いの確認、メールでの領収書の送信、入金処理、または失敗した支払いの再試行に使用できます。
カスタムコード
Webhook ハンドラを作成してイベントをリッスンし、カスタムの非同期決済フローを作成します。Stripe CLI を使用し、ローカルで Webhook 組み込みのテストとデバッグを行います。
事前構築のアプリ
オートメーションやマーケティングとセールスなどの一般的なビジネスイベントを、パートナーアプリケーションとの連携によって処理します。
組み込みをテストする
To test your integration in a testing environment, it redirects you to a test payment page where you can approve or decline the test payment.
In live mode, enter the phone number linked to Vipps to send a push notification to your Vipps mobile application. You can approve or decline the payment in the Vipps mobile application.
失敗した支払い
Vipps transactions can fail if the underlying card transaction is declined. Learn more about card declines. In this case, the PaymentMethod detaches and the PaymentIntent’s status automatically transitions to requires_
.
When the PaymentIntent’s status is requires_
, your customer must authenticate the payment within 5 minutes. If no action is taken after 5 minutes, the PaymentMethod detaches and the PaymentIntent’s status automatically transitions to requires_
.
返金と不審請求の申請
Stripe performs a card transaction using standard card rails as part of a Vipps transaction. Refunds and disputes are subject to the Visa and Mastercard network rules.