コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
AI に質問する
アカウントを作成
サインイン
始める
支払い
売上
プラットフォームおよびマーケットプレイス
資金管理
開発者向けリソース

Klarna によるサブスクリプションを設定する

Klarna を使用したサブスクリプションの作成と請求の方法をご紹介します。

このガイドを使用して、支払い方法として Klarna を使用するサブスクリプションを設定します。

利用可能なKlarna決済オプションはユースケースと買い手の国によって異なります

導入を開始する前に、顧客が利用できる決済オプション を確認してください。

Stripe Checkoutを使用して、Klarna を支払い方法として保存することをお勧めします。

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

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

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'

商品と価格を作成する
ダッシュボード

Products (商品) は、販売しているアイテムまたはサービスを表します。Prices (価格) は、商品の価格と請求頻度を定義します。これには、商品の価格、受け付ける通貨、および 1 回限りの支払いか継続支払いかが含まれます。商品と価格が数個のみの場合は、ダッシュボードでそれらを作成および管理します。

このガイドでは、例としてストックフォトサービスを使用し、15 USD の月次サブスクリプションを顧客に請求します。これをモデル化するには、次のようにします。

  1. 商品ページに移動し、商品を作成をクリックします。
  2. 商品の名前を入力します。オプションで説明を追加して、商品の画像をアップロードできます。
  3. 商品税コードを選択します。商品税コードの詳細をご確認ください。
  4. 継続を選択します。次に、価格に**15を入力し、通貨として**を選択します。
  5. 価格に税金を含めるかどうかを選択します。税金設定のデフォルト値を使用するか、値を手動で設定できます。この例では、自動を選択します。
  6. 請求期間で月次を選択します。
  7. その他の料金体系オプションをクリックします。次に、この例の料金体系モデルとして定額を選択します。定額料金とその他の料金体系モデルの詳細をご確認ください。
  8. 将来的に特定の価格を整理、クエリ、更新するために、内部価格の説明と検索キー 追加します。
  9. 次へをクリックします。次に、商品を追加をクリックします。

商品と価格を作成したら、価格 ID を記録しておき、後続のステップで使用できるようにします。ID は料金体系ページで price_G0FvDp6vZvdwRZ のように表示されます。

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

サーバー側のエンドポイントを呼び出して 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>

既存の Price の ID を使用して Checkout セッションを作成します。モードを subscription に設定し、1 つ以上の継続価格を渡します。継続価格に加えて、1 回限りの価格を追加できます。Checkout セッションを作成したら、レスポンスで返された URL に顧客をリダイレクトします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price]"={{PRICE_ID}} \ -d "line_items[0][quantity]"=1 \ -d mode=subscription \ --data-urlencode success_url="https://example.com/success?session_id={CHECKOUT_SESSION_ID}" \ --data-urlencode cancel_url="https://example.com/cancel"

顧客が支払いを正常に完了すると、Stripe は顧客を success_url にリダイレクトします。これはお客様のウェブサイト上にあり、支払いの成功を顧客に知らせるページです。上記の例のように success_url に {CHECKOUT_SESSION_ID} テンプレート変数を含めて、成功ページでセッション ID を使用できるようにします。

顧客が支払いを完了せずに Checkout セッションでお客様のロゴをクリックすると、Checkout は、cancel_url に顧客を誘導して、ウェブサイトにリダイレクトします。これは通常、顧客が Checkout にリダイレクトされる前に表示していたウェブサイトのページです。

Checkout セッションは作成後 24 時間で期限が切れます。

注意

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

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

トライアルを設定する

subscription_data パラメーターを使用して、期間、終了日、その他のトライアル設定に関する情報を指定し、Checkout セッションで無料トライアルを作成できます。

決済手段の指定がないまま無料トライアルが終了した場合に、無料トライアルをキャンセルまたは一時停止するように設定する方法をご紹介します。

サブスクリプションを取得する
サーバー側

顧客が支払いの詳細を送信すると、Stripe は自動的にサブスクリプションを作成します。サブスクリプションは、success_url を使用して同期的に取得することも、Webhook を使用して非同期で取得することもできます。

顧客が支払いの成功後に必ず success_url に到達するとは限らないため (たとえば、リダイレクトが行われる前に顧客がブラウザータブを閉じることもあります)、サブスクリプションを同期的に取得するか非同期的に取得するかは、ドロップオフの許容度によって異なります。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_a1h2mO4eLbjemY0JWW9rCz5dcglwr3M5ldjLOvpGxWD37i1Oi5SeFhSup1", "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", "subscription": "sub_1Op9VFCvDOElLqwO6fs7Na4P", "submit_type": null, "success_url": "https://example.com/success" } }, "livemode": false, "pending_webhooks": 1, "request": { "id": null, "idempotency_key": null }, "type": "checkout.session.completed" }

subscription キーの値の記録を残しておいてください。これは、Checkout セッションから作成された、Subscription (サブスクリプション) の ID です。

実装内容をテストする

下記では、現在対応している顧客の国のテストデータを特別に選択しています。サンドボックスでは、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