コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
決済にとどまらない機能

注

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

将来の Klarna の支払いを設定する

Klarna の詳細を保存し、後で顧客に請求する方法は以下のとおりです。

Klarna を顧客の支払い方法として保存し、将来の支払いに対して請求して以下をサポートできます。

  • 無料トライアルを利用しているか利用していないかにかかわらず、サブスクリプションの自動支払い。
  • Klarna をウォレットに保存すると、顧客の再認証を必要とせずに、将来のオンデマンド購入を効率化できます。

以下の特定の支払いオプション、サブスクリプション期間、および購入者の国では、Klarna の継続支払いがサポートされています。

支払いオプションサポートされるユースケース対応可能な買い手の国
全額支払う
  • 短期サブスクリプション (週額または月額)
  • 長期サブスクリプション (月額よりも長い)
  • 混合カート (1 回限りの購入とサブスクリプション)
  • オンデマンド支払い
AT、 BE、CA、CH、 DE、DK、 ES、FI、FR、 IE、IT、GR、NL、NO、PL、PT、SE、UK、US
後払い
  • 短期サブスクリプション (週額または月額)
  • 長期サブスクリプション (月額よりも長い)
  • オンデマンド支払い
DE、SE、US
3 回または 4 回で支払う
  • 長期サブスクリプション (月額よりも長い) のみ
AT、CA、CH、DE、DK、ES、FI、FR、IE、IT、GR、NL、NO、PL、PT、UK、US

以下の決済連携タイプから Klarna を選択し、決済手段として保存します。Stripe Billing を使用している場合は、サブスクリプションでの Klarna を参照してください。

Stripe Checkout を使用して、事前に Klarna 支払いの詳細を収集し、後から最終的な金額や支払い日を決定します。この機能の用途を紹介します。

Stripe を設定する
サーバー側

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

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

Command Line
# Available as a gem
sudo gem install stripe
Gemfile
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

設定前に Customer を作成または取得する
サーバー側

今後の支払いに Klarna 支払い方法を再利用するには、これを Customer に関連付ける必要があります。

お客様のビジネスで顧客がアカウントを作成するときに、Customer オブジェクトを作成します。Customer オブジェクトの ID を、独自の内部的な顧客の表記に関連付けることにより、保存された支払い方法の詳細を後で取得して使用できます。顧客がアカウントを作成していない場合でも、すぐに Customer オブジェクトを作成し、後でこのオブジェクトを顧客のアカウントの内部表記に関連付けることができます。

Command Line
curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Checkout セッションを作成する
クライアント側
サーバー側

Klarna 支払いを受け付ける前に、顧客は、お客様が Stripe Checkout を通じて今後の支払いに Klarna アカウントを使用することを承認する必要があります。

サーバー側のエンドポイントを呼び出す決済ボタンをウェブサイトに追加して Checkout セッションを作成します。

index.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Checkout</button>
    </form>
  </body>
</html>

Checkout を使用してサブスクリプションを設定する場合は、サブスクリプションの詳細を渡すことをお勧めします。これにより、オーソリ率が最適化され、顧客は利用可能な Klarna の支払いオプションにアクセスできるようになります。

使用するサブスクリプションの reference は顧客には表示されず、任意の識別子として選択できます。保存した決済手段に請求する際にも、同じ参照先を使用します。

以下の例は、年間サブスクリプションの詳細を渡す方法を示しています。これらのフィールドの詳細については、Klarna のサブスクリプションの決済手段をご確認ください。

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=setup \
  -d customer={{CUSTOMER_ID}} \
  --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "payment_method_options[klarna][subscriptions][0][reference]"=EXAMPLE_REFERENCE \
  -d "payment_method_options[klarna][subscriptions][0][name]"="Customer-facing name for subscription" \
  -d "payment_method_options[klarna][subscriptions][0][interval]"=year \
  -d "payment_method_options[klarna][subscriptions][0][next_billing][amount]"=10000 \
  -d "payment_method_options[klarna][subscriptions][0][next_billing][date]"=2026-01-01

Checkout セッションを作成したら、レスポンスで返された URL に顧客をリダイレクトします。

Checkout からのリダイレクトを処理する
クライアント側
サーバー側

顧客が決済手段の詳細を入力すると、success_url (支払いが成功したことを顧客に通知するウェブページ) にリダイレクトされます。上記の例のように、success_url にテンプレート変数である {CHECKOUT_SESSION_ID} を含めることで、成功ページでセッション ID が使用できるようになります。

顧客が支払い方法の詳細を提供せずに Checkout セッションでお客様のロゴをクリックすると、Checkout は、cancel_url に移動して、顧客をお客様の Web サイトにリダイレクトします。このページは通常、顧客が Stripe Checkout にリダイレクトされる前に表示していた Web サイトのページです。

注意

次に挙げる理由により、支払い開始の検出時には、success_url へのリダイレクトのみに依存しないでください。

  • 悪意を持つユーザが、支払いをせずに success_url に直接アクセスし、商品やサービスにアクセスできるようになる可能性があります。
  • 顧客が支払いの成功後に success_url に到達するとは限りません。リダイレクトが発生する前に、顧客がブラウザタブを閉じることがあります。

支払い方法を取得する
サーバー側

顧客が支払いの詳細を送信した後に、PaymentMethod (決済手段) オブジェクトを取得します。PaymentMethod は、顧客のKlarna account情報を保存して今後の支払いに利用できるようにします。PaymentMethod は、success_url を使用して同期的に取得することも、Webhook を使用して非同期的に取得することもできます。

顧客が支払いの成功後に必ず success_url に到達するとは限らないため (たとえば、リダイレクトが行われる前に顧客がブラウザータブを閉じることもあります)、PaymentMethod を同期的に取得するか非同期的に取得するかは、ドロップオフの許容度によって異なります。Webhook を使用すると、組み込みでこの種のドロップオフを防止できます。

Session オブジェクトを含む checkout.session.completed Webhook を処理します。詳細については、Webhook を設定するをご覧ください。以下は、checkout.session.completed レスポンスの例です。

{
  "id": "evt_1Ep24XHssDVaQm2PpwS19Yt0",
  "object": "event",
  "api_version": "2019-03-14",
  "created": 1561420781,
  "data": {
    "object": {
      "id": "cs_test_MlZAaTXUMHjWZ7DcXjusJnDU4MxPalbtL5eYrmS2GKxqscDtpJq8QM0k",
      "object": "checkout.session",
      "billing_address_collection": null,
      "cancel_url": "https://example.com/cancel",
      "client_reference_id": null,
      "customer": null,
      "customer_email": null,
      "display_items": [],
      "mode": "setup",
      "setup_intent": "seti_1EzVO3HssDVaQm2PJjXHmLlM",
      "submit_type": null,
      "subscription": null,
      "success_url": "https://example.com/success"
    }
  },
  "livemode": false,
  "pending_webhooks": 1,
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "type": "checkout.session.completed"
}

Checkout セッションで作成された SetupIntent の ID である setup_intent キーの値を書き留めます。SetupIntent は、今後の支払いに利用できるように顧客のKlarna account情報を設定するために使用されるオブジェクトです。この ID を使用して SetupIntent オブジェクトを取得します。

Command Line
curl https://api.stripe.com/v1/setup_intents/seti_1EzVO3HssDVaQm2PJjXHmLlM \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

設定後のイベントを処理する
サーバー側

Webhook などの方法で、顧客が請求契約を承認したことを確認します。顧客が支払いステータスページに戻ることに依存しないようにしてください。

顧客が請求契約の承認を正常に完了すると、Stripe は payment_intent.succeeded または setup_intent.succeeded Webhook イベントを送信し、インテントのステータスは succeeded に移行します。生成された payment_method ID を保存し、保存した PaymentMethod を使用して後で支払いを行います。

顧客が請求契約の承認を正常に行えなかった場合、Stripe は payment_intent.payment_failed または setup_intent.setup_failed Webhook イベントを送信し、インテントのステータスは requires_payment_method に戻ります。

支払い方法を将来の支払いに使用する
サーバー側

オフセッションで顧客に請求する準備ができたら、Customer ID と PaymentMethod ID を使用して、PaymentIntent (支払いインテント) を作成します。その他いくつかのパラメーターを設定して、オフセッションの支払いを行います。

  • off_session を true に設定して、支払いの実行時に顧客が決済フローに存在しないことを示します。これにより、認証が必要な場合は PaymentIntent からエラーが返されます。
  • PaymentIntent の confirm プロパティの値を true に設定します。これにより、PaymentIntent が作成されると直ちに確定されます。
  • payment_method を PaymentMethod の ID に設定し、customer を Customer の ID に設定します。
  • Specify a return_url to indicate where Stripe needs to redirect the customer after they return from Klarna’s website.

更新のたびにサブスクリプションの詳細と項目を送信します。決済手段を設定したときと同じ reference をサブスクリプションに使用します。決済手段の保存後にサブスクリプションの詳細が変更された場合は、同じ reference を指定して新しい情報を送信します。

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=5000 \
  -d currency=usd \
  -d confirm=true \
  -d customer={{CUSTOMER_ID}} \
  -d payment_method={{PAYMENT_METHOD_ID}} \
  -d off_session=true \
  --data-urlencode return_url="https://example.com/setup/complete" \
  -d "amount_details[line_items][0][product_name]"="Annual subscription renewal" \
  -d "amount_details[line_items][0][quantity]"=1 \
  -d "amount_details[line_items][0][unit_cost]"=5000 \
  -d "amount_details[line_items][0][payment_method_options][klarna][subscription_reference]"=EXAMPLE_REFERENCE \
  -d "payment_method_options[klarna][subscriptions][0][reference]"=EXAMPLE_REFERENCE \
  -d "payment_method_options[klarna][subscriptions][0][interval]"=year

導入をテストする

Checkout の実装状態をテストする際は、決済手段として Klarna を選択し、保存 ボタンをクリックします。テスト環境では、Klarna のリダイレクト内でさまざまな結果をシミュレートできます。

下記では、現在対応している顧客の国のテストデータを特別に選択しています。サンドボックスでは、Klarna は指定されたメールアドレスに基づいて取引を承認または拒否します。

承認拒否
生年月日1970/10/0703-05-1994
名テストJohn
姓Person-ausnow
町名・番地Wharf StSilverwater Rd
番地等41-5
郵便番号48772128
市区町村Port DouglasSilverwater
地域QLDNSW
電話番号+61473752244+61473763254
メールアドレスcustomer@email.aucustomer+denied@email.au

2 段階認証

6 桁の数字であれば、2 段階認証コードとして有効です。999999 を使用すると、認証は失敗します。

返済方法

Klarna のフロー内では、以下のテスト値を使用し、さまざまな返済方法を試すことができます。

タイプ値
口座引き落としDE11520513735120710131
銀行振込デモの銀行
クレジットカード
  • 番号: 4111 1111 1111 1111
  • CVV: 123
  • 有効期限: 任意の将来日付
デビットカード
  • カード番号:4012 8888 8888 1881
  • CVV: 123
  • 有効期限: 任意の将来日付
このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか？llms.txt を読んでください。
Powered by Markdoc