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

Klarna 補足購入データ公開プレビュー

さまざまな業種の Klarna 固有の補足データを提供する方法をご紹介します。

プレビューヘッダーで利用可能

API リクエストにバージョンヘッダー 2025-11-17.preview またはそれ以降のプレビューバージョンヘッダーを含めることで、このパブリックプレビュー機能を使用できます。

補足購入データは取引に付加情報を与えることで支払い結果の改善や顧客サポートの向上に役立ちます。イベント、交通、マーケットプレイス、保険などの業種に特化した詳細情報を送信するために使用します。

補足購入データを使用するタイミング

サポート対象の業種で事業を行っていて Klarna での支払い結果を改善したい場合は、補足購入データを使用します。

Klarna と共有される補足データは以下のユースケースに対応しています。

  • 購入後の透明性: Klarna アプリで顧客に取引明細を提供し、不審請求の申し立てや返品を効率化し、サポートへの問い合わせを減らします。
  • 承認率の向上: 履歴データはリスク評価に情報を提供し、正当な取引の承認率を高められます。
  • 不正利用評価の強化: 詳細な取引インサイトにより、特にリスクの高いセグメントにおいて効果の高い不正利用調査をサポートします。
  • リスクエクスポージャーの監視: 取引データにより継続的な監視と迅速なリスク軽減をサポートします。
  • 強化されたソリューションの提供: Klarna は過去の取引データや利用状況に基づき、貴社と顧客にとって有益なインセンティブやアクションのためのより高度なソリューションを提供できます。

制限事項

次の制限があることに留意してください。

  • 手数料の変更なし: 補足購入データを渡しても、Klarna 取引に対して支払う手数料には影響しません。このデータを提供してもしなくても料金体系に変更はありません。
  • 検証フィードバックなし: Stripe および Klarna は形式が正しい補足購入データを受け付けます。ただし送信した特定のデータが取引の結果を改善する条件に該当するかどうかについては、フィードバックを提供しません。

効果の測定

支払い分析で Klarna のオーソリ率を時間を追って追跡します。補足購入データを実装すると、オーソリ成功率が高くなる可能性がありますが、その影響は取引パターンと貴社が提供するデータに左右されます。

提供状況

補足の購入データは Klarna 決済専用で、次の業種に対応しています。

  • イベント (コンサート、フェスティバル、スポーツ、会議)
  • 保険 (単独の保険契約)
  • バウチャー (ギフトカード、割引コード)
  • 鉄道輸送
  • バス輸送
  • フェリー輸送
  • 企画旅行とツアー
  • マーケットプレイスの売り手

旅行およびエンターテインメント業界

Klarna 決済による宿泊、レンタカー、航空輸送については、旅行およびエンターテインメント業種のメタデータドキュメント をご覧ください。これらの業種はカード決済と共有され、このページの業種は Klarna 専用です。

追加の購入データを送信する

PaymentIntent を 作成、更新、または 確定する ときに、payment_method_options.klarna.supplementary_purchase_data パラメーターを使用して Klarna 固有の追加の購入データを送信します。

supplementary_purchase_data ハッシュには、各業種のハッシュの配列が含まれます。Klarna は、リスク評価のためにこれらの配列のすべてのエントリーを処理します。1 回のリクエストで複数の業種を送信できます。

例: バウチャーデータを使用して PaymentIntent を作成する

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=10000 \
  -d currency=eur \
  -d "payment_method_types[0]"=klarna \
  -d "payment_method_options[klarna][supplementary_purchase_data][vouchers][0][voucher_name]"="Holiday Gift Card"

例: 複数の業種を指定して PaymentIntent を作成する

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=15000 \
  -d currency=eur \
  -d "payment_method_types[0]"=klarna \
  -d "payment_method_options[klarna][supplementary_purchase_data][vouchers][0][voucher_name]"="Gift Card" \
  -d "payment_method_options[klarna][supplementary_purchase_data][insurances][0][insurance_type]"=cancelation \
  -d "payment_method_options[klarna][supplementary_purchase_data][insurances][0][price]"=2000 \
  -d "payment_method_options[klarna][supplementary_purchase_data][insurances][0][currency]"=EUR

垂直データ形式

以下のタブでは、サポートされている業種のハッシュについて説明します。

保険データは、payment_method_options.klarna.supplementary_purchase_data.insurances パラメーターを介して送信されます。配列の各要素は、(別のサービスのアドオンとしてではなく) 主要商品として購入された個々の保険契約を表します。

フィールドとそのフォーマットの完全な一覧は、API リファレンス (2025-11-17.preview 以降のプレビューバージョンのヘッダーで利用可能) をご覧ください。

例: 保険データを使用して PaymentIntent を作成する
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=5000 \
  -d currency=usd \
  -d "payment_method_types[0]"=klarna \
  -d "payment_method_options[klarna][supplementary_purchase_data][insurances][0][insurance_type]"=medical \
  -d "payment_method_options[klarna][supplementary_purchase_data][insurances][0][insurance_company_name]"="Global Medical Insurance" \
  -d "payment_method_options[klarna][supplementary_purchase_data][insurances][0][price]"=5000 \
  -d "payment_method_options[klarna][supplementary_purchase_data][insurances][0][currency]"=USD

追加の購入データを更新および削除する

更新または確認メソッドを使用して、追加の購入データを変更または削除します。

分野の完全な置き換え

業種の配列を更新すると、その業種の既存のデータは完全に新しいデータに置き換えられます。たとえば、PaymentIntent に 2 つのバウチャーがあり、1 つのバウチャーで更新を送信すると、結果は 3 店舗ではなく 1 つのバウチャーになります。

2 つのバウチャーを持つ PaymentIntent の作成

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=10000 \
  -d currency=eur \
  -d "payment_method_types[0]"=klarna \
  -d "payment_method_options[klarna][supplementary_purchase_data][vouchers][0][voucher_name]"="First Voucher" \
  -d "payment_method_options[klarna][supplementary_purchase_data][vouchers][1][voucher_name]"="Second Voucher"

PaymentIntent を、既存の 2 つのバウチャーを置き換え、1 つのバウチャーに更新します。

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}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_options[klarna][supplementary_purchase_data][vouchers][0][voucher_name]"="Replacement Voucher"

PaymentIntent のバウチャーは 1 件のみになりました。

既存のデータを保持する

更新リクエストで除外された業種は変更されません。たとえば、既存のバウチャーや保険に影響を与えることなく、トレインデータを追加できます。

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}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_options[klarna][supplementary_purchase_data][train_reservation_details][0][carrier_name]"=Eurotrains \
  -d "payment_method_options[klarna][supplementary_purchase_data][train_reservation_details][0][ticket_class]"=business \
  -d "payment_method_options[klarna][supplementary_purchase_data][train_reservation_details][0][price]"=8500 \
  -d "payment_method_options[klarna][supplementary_purchase_data][train_reservation_details][0][currency]"=EUR

PaymentIntent は既存のバウチャーと保険を保持し、列車予約を追加します。

特定の業種の設定を解除

特定の垂直方向のすべてのデータの設定を解除し、他の垂直方向を維持するには、垂直方向を空の文字列に設定します。これにより、PaymentIntent から垂直方向が削除されます。

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}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_options[klarna][supplementary_purchase_data][insurances]"=

補足購入データの設定をすべて解除する

paymentintent からすべての追加購入データの設定を解除するには、supplementary_purchase_data パラメーター全体を空の文字列に設定します。

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}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_options[klarna][supplementary_purchase_data]"=

テスト

貴社の連携機能が顧客向けに正常に動作するかをテストします。Stripe Sandbox 環境でサンドボックスキーを使って API コールをシミュレーションしてください。確定する前に update メソッドを使用して決済方法をアタッチします。さらに詳しい情報は Testing をご覧ください。