Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
ÜbersichtZahlung annehmenAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenVerwenden Sie Managed PaymentsWiederkehrende Zahlungen
Präsenzzahlungen
Zahlungsmethoden
Zahlungsvorgänge
Salden und AbwicklungsdauerZahlungsbelegeRückerstattungen und Stornierungen
Erweiterte Integrationen
Mehr als Zahlungen

Zusätzliche Kaufdaten von KlarnaÖffentliche Vorschau

Erfahren Sie, wie Sie Klarna-spezifische Zusatzdaten für verschiedene Branchen bereitstellen können.

Verfügbar mit Vorschau-Header

Sie können diese Funktion zur öffentlichen Vorschau nutzen, indem Sie den Versions-Header 2025-11-17.preview oder einen späteren Vorschau-Version-Header in Ihre API-Anfrage aufnehmen.

Ergänzende Einkaufsdaten fügen einer Transaktion Kontext hinzu, um Zahlungsergebnisse und den Kundensupport zu verbessern. Verwenden Sie sie, um branchenspezifische Details für vertikale Bereiche wie Events, Transport, Marktplätze und Versicherungen zu übermitteln.

Wann Sie ergänzende Einkaufsdaten verwenden sollten

Verwenden Sie ergänzende Einkaufsdaten, wenn Sie in einer unterstützten Branche tätig sind und Ihre Zahlungsergebnisse mit Klarna verbessern möchten.

Die mit Klarna geteilten ergänzenden Daten unterstützen folgende Use Cases:

  • Transparenz nach dem Kauf: Stellen Sie Ihren Kundinnen und Kunden in der Klarna-App eine detaillierte Aufschlüsselung der Transaktion bereit, vereinfachen Sie Streitfälle und Rücksendungen und reduzieren Sie Supportanfragen.
  • Höhere Akzeptanzquoten: Historische Daten unterstützen das Underwriting und können die Genehmigungen für legitime Transaktionen erhöhen.
  • Verbesserte Betrugsbewertung: Detaillierte Transaktionsinformationen ermöglichen effektivere Betrugsermittlungen, insbesondere in risikoreichen Segmenten.
  • Überwachung des Risikopotenzials: Transaktionsdaten unterstützen die kontinuierliche Überwachung und rechtzeitige Risikominderung.
  • Verbesserte Lösungsangebote: Basierend auf historischem Verhalten kann Klarna erweiterte Lösungen für Anreize und Maßnahmen entwickeln, die Ihnen und Ihren Kundinnen und Kunden zugutekommen.

Beschränkungen

Beachten Sie diese Einschränkungen:

  • Keine Gebührenänderungen: Die Übermittlung ergänzender Einkaufsdaten hat keine Auswirkungen auf die Gebühren, die Sie für Klarna-Transaktionen zahlen. Ihre Preise bleiben gleich – unabhängig davon, ob Sie diese Daten bereitstellen.
  • Kein Validierungsfeedback: Stripe und Klarna akzeptieren korrekt formatierte ergänzende Einkaufsdaten, geben jedoch kein Feedback dazu, ob die von Ihnen übermittelten spezifischen Daten zu besseren Ergebnissen führen.

Auswirkungen messen

Verfolgen Sie Ihre Klarna-Autorisierungsraten im Zeitverlauf in Ihren Zahlungsanalysen. Nach der Implementierung ergänzender Einkaufsdaten sehen Sie möglicherweise mehr erfolgreiche Autorisierungen, auch wenn die Auswirkungen je nach Ihren Transaktionsmustern und den bereitgestellten Daten variieren.

Verfügbarkeit

Ergänzende Kaufdaten sind ausschließlich für Klarna-Zahlungen verfügbar und unterstützen die folgenden Branchen:

  • Veranstaltungen (Konzerte, Festivals, Sportveranstaltungen, Konferenzen)
  • Versicherung (Einzelversicherungen)
  • Gutscheine (Geschenkkarten, Rabattcodes)
  • Beförderung mit dem Zug
  • Beförderung mit dem Bus
  • Beförderung mit der Fähre
  • Organisierte Reisen und Touren
  • Marktplatzverkäufer/innen

Vertikale Märkte für Reisen und Unterhaltung

Informationen zu Unterkünften, Mietwagen und Flugreisen mit Klarna-Zahlungen finden Sie in der Dokumentation zu Metadaten für die Reise- und Unterhaltungsbranche. Diese Branchen werden mit Kartenzahlungen geteilt, während die Branchen auf dieser Seite exklusiv für Klarna gelten.

Zusätzliche Kaufdaten senden

Sie übermitteln Klarna-spezifische ergänzende Kaufdaten über den Parameter payment_method_options.klarna.supplementary_purchase_data, wenn Sie eine PaymentIntent erstellen, aktualisieren oder bestätigen.

Der Hash supplementary_purchase_data enthält ein Array von Hashes für jede Vertikale. Klarna verarbeitet alle Einträge in diesen Arrays für die Risikobewertung. Sie können mehrere Vertikalen in einer einzelnen Anfrage senden.

Beispiel: PaymentIntent mit Gutscheindaten erstellen

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"

Beispiel: Einen PaymentIntent mit mehreren Vertikalen erstellen

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

Vertikale Datenformate

Die folgenden Registerkarten beschreiben die Hashes für die unterstützten Branchen:

Versicherungsdaten werden über den Parameter payment_method_options.klarna.supplementary_purchase_data.insurances gesendet. Jedes Element im Array stellt eine einzelne Versicherungspolice dar, die als Hauptprodukt (nicht als Add-on zu einer anderen Dienstleistung) abgeschlossen wurde.

Die vollständige Liste der Felder und deren Formate finden Sie in der API-Dokumentation (verfügbar mit dem Header der Preview-Version 2025-11-17.preview oder später).

Beispiel: eine PaymentIntent mit Versicherungsdaten erstellen
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

Zusätzliche Kaufdaten aktualisieren und entfernen

Verwenden Sie die Methode zum Aktualisieren oder Bestätigen, um zusätzliche Kaufdaten zu ändern oder zu entfernen.

Vollständiger Austausch von Vertikalen

Wenn Sie das Array einer Vertikalen aktualisieren, ersetzen die neuen Daten die vorhandenen Daten für diese Vertikale vollständig. Wenn beispielsweise ein PaymentIntent zwei Gutscheine enthält und Sie eine Aktualisierung mit einem Gutschein senden, ist das Ergebnis ein Gutschein (nicht drei).

Einen PaymentIntent mit 2 Gutscheinen erstellen:

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"

Aktualisieren Sie den PaymentIntent durch einen Gutschein, um die bestehenden zwei Gutscheine zu ersetzen:

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"

Der PaymentIntent enthält jetzt nur noch einen Gutschein.

Bestehende Daten erhalten

Vertikale, die in einer Aktualisierungsanfrage ausgeschlossen sind, bleiben unverändert. Sie können beispielsweise Zugdaten hinzufügen, ohne bestehende Gutscheine oder Versicherungen zu beeinträchtigen:

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

Der PaymentIntent behält bestehende Gutscheine und Versicherungen und fügt die Zugreservierung hinzu.

Eine bestimmte Vertikale aufheben

Um alle Daten für eine bestimmte Vertikale zu löschen und andere Vertikalen zu behalten, setzen Sie die Vertikale auf eine leere Zeichenfolge. Dadurch wird die Vertikale aus dem PaymentIntent entfernt.

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]"=

Alle zusätzlichen Kaufdaten entfernen

Um alle ergänzenden Kaufdaten aus einem PaymentIntent zu entfernen, setzen Sie den gesamten Parameter supplementary_purchase_data auf einen leeren String:

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]"=

Testen

Testen Sie, ob Ihre Integration für Ihre Kundinnen und Kunden korrekt funktioniert. Simulieren Sie API-Aufrufe in einer Stripe-Sandbox mit einem Sandbox-Schlüssel. Fügen Sie vor der Bestätigung mit der Update-Methode eine Zahlungsmethode hinzu. Weitere Informationen finden Sie unter Testing.