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

Supplementary purchase data adds context to a transaction to improve payment outcomes and customer support. Use it to send industry-specific details for verticals such as events, transportation, marketplaces, and insurance.

When to use supplementary purchase data

Use supplementary purchase data if you operate in a supported vertical and want to improve your payment outcomes with Klarna.

The supplementary data shared with Klarna supports these use cases:

• Post-purchase transparency: Provide detailed transaction breakdowns for your customers in the Klarna app, streamline disputes and returns, and reduce support requests.
• Higher acceptance rates: Historical data informs underwriting and can increase approvals for legitimate transactions.
• Enhanced fraud assessment: Detailed transaction insights support more effective fraud investigations, especially in high-risk segments.
• Risk exposure monitoring: Transaction data supports continuous monitoring and timely mitigation.
• Enhanced solution offerings: Based on historical behavior, Klarna can develop enhanced solutions for incentives and actions that benefit you and your customers.

Limitations

Keep these limits in mind:

• No fee changes: Passing supplementary purchase data doesn’t impact the fees you pay for Klarna transactions. Your pricing remains the same whether or not you provide this data.
• No validation feedback: Stripe and Klarna accept well-formed supplementary purchase data but don’t provide feedback on whether the specific data you send qualifies for improved outcomes.

Measure impact

Track your Klarna authorization rates over time in your payment analytics. After you implement supplementary purchase data, you might see more successful authorizations, though the impact varies based on your transaction patterns and the data you provide.

提供状況

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

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

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

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

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

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

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 を作成する

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

垂直データ形式

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

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 の作成

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 つのバウチャーに更新します。

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 件のみになりました。

既存のデータを保持する

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

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 から垂直方向が削除されます。

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 パラメーター全体を空の文字列に設定します。

curl https://api.stripe.com/v1/payment_intents/
{{PAYMENT_INTENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_method_options[klarna][supplementary_purchase_data]"=