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

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

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

PaymentIntent (支払いインテント) は、顧客から支払いを回収する意図を表すオブジェクトであり、支払いプロセスのライフサイクルの各段階を追跡します。まず、サーバーで PaymentIntent を作成し、回収する金額と nok の通貨 (Vipps は nok にのみ対応しているため) を指定します。すでに Payment Intents API を使用した実装がある場合は、vipps を PaymentIntent の支払い方法タイプのリストに追加します。

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=1099 \
  -d "currency"="nok" \
  -d "payment_method_types[]"="vipps" \
  -d "payment_method_data[type]"="vipps" \
  -d "payment_method_options[vipps][reference]"="ORDER_123"

レスポンス

{
  "id": "pi_12345",
  "amount": 1099,
  "currency": "nok",
  "payment_method": "pm_12345",
  "payment_method_types": [
     "vipps"
  ],
  "payment_method_options": {
    "vipps": {
      "reference": "ORDER_123",
    },
  },
  "status": "requires_confirmation"
}

PaymentIntent を確定するには、ステップ 2 の PaymentIntent の id を使用します。これにより、指定された 支払い方法で顧客が支払うことを宣言します。PaymentIntent が確定されると、支払いが開始されます。return_url は、ユーザーが支払いを完了した後に Stripe がユーザーをリダイレクトする場所を示します。

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "return_url"="https://example.com/checkout/complete"

レスポンス

{
  "id": "pi_12345",
  "amount": 1099,
  "currency": "nok",
  "payment_method": "pm_12345",
  "next_action": {
    "redirect_to_url": {
      "return_url": "https://example.com/checkout/complete",
      "url": "https://pm-redirects.stripe.com/authorize/acct_123/pa_nonce_abc"
    },
    "type": "redirect_to_url"
  },
  "payment_method_types": [
     "vipps"
  ],
  "payment_method_options": {
    "vipps": {
      "reference": "ORDER_123",
    },
  },
  "status": "requires_action"
}

支払いを承認するには、next_action[redirect_to_url][url] フィールドの URL に顧客をリダイレクトします。

• デスクトップでは、URL によって Vipps ランディングページが開くため、顧客はここに Vipps アカウントである電話番号を入力できます。その後、顧客は Vipps スマートフォンアプリを使用して支払いの認証を進めることができます。

• モバイルデバイスでは、デスクトップでのプロセスと同様に、この URL を使用すると、Vipps アプリケーションが直接開くか (存在する場合)、Vipps ランディングページが開きます。

Webhook などの方法を使用して、注文のフルフィルメントを処理します。顧客が支払いを完了すると、PaymentIntent のステータスは succeeded に移行し、payment_intent.succeeded Webhook イベントを送信します。顧客が支払いを行わない場合、PaymentIntent は payment_intent.payment_failed Webhook イベントを送信し、ステータスを requires_payment_method に返します。