Branchen-MetadatenÖffentliche Vorschau

Erfahren Sie, wie Sie spezifische Daten für Reise- und Unterhaltungseinkäufe bereitstellen.

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.

Verwenden Sie Branchenmetadaten in der Payment Intents API, um die erforderlichen branchenspezifischen Daten für Transaktionen in unterstützten Reise- und Unterhaltungsbranchen bereitzustellen.

Die Angabe branchenspezifischer Daten ist für bestimmte Händlerkategoriecodes erforderlich, um die Anforderungen des Kartennetzwerks zu erfüllen, und kann die Autorisierungsraten und die Risikobewertung bei Klarna-Transaktionen verbessern.

Implementieren Sie Branchenmetadaten für Kartenzahlungen, wenn Ihr Unternehmen unter bestimmten Merchant Category Codes (MCCs) für Reisen und Unterhaltung tätig ist, wie z. B. Mietwagen, Unterkünfte, Reisebüros oder Fluggesellschaften, die unter Verfügbarkeit aufgeführt sind.

Verfügbarkeit

Die Bereitstellung branchenspezischer Daten ist nur für Nutzer/innen von PaymentIntents verfügbar und auf die folgenden Händlerkategoriecodes (MCCs) beschränkt.

Autovermietung: 3351-3441, 7512, 7513, 7519
Unterkunft: 3501-3999, 7011
Reisebüro: 4722
Flug: 4511

Sie können Branchen-Metadaten für Zahlungen mit bestimmten Karten (Visa, Mastercard, Amex und Discover) und Klarna einsenden.

Klarna-spezifische Branchen

Neben Autovermietungen, Unterkünften und Flügen unterstützt Klarna weitere branchenspezifische Bereiche, in denen Kartenzahlungen nicht möglich sind, darunter:

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

Weitere Informationen zu diesen exklusiven Branchen von Klarna finden Sie in der Dokumentation zu den zusätzlichen Kaufdaten von Klarna.

Private Vorschau für Karten

Branchenmetadaten befinden sich für Kartentransaktionen in einer privaten Vorschau und für Klarna in einer öffentlichen Vorschau. Außerdem unterstützen Kartentransaktionen keine Übermittlung von Kreuzfahrtdaten.

Branchenspezifische Daten senden

Sie senden branchenspezifische Daten über den Parameter payment_details, wenn Sie einen PaymentIntent erstellen, aktualisieren oder bestätigen.

Der Hash payment_details enthält ein Array von Hashes für jede Branche (Branche): car_rental_data, lodging_data und flight_data.

Jeder Hash in diesen Arrays steht für eine Einzelperson, die ein Auto mietet, eine Unterkunft bucht oder ein Flugticket kauft.

Unter Einen PaymentIntent erstellen erfahren Sie mehr über die Übergabe von Daten.

Array-Verarbeitungsverhalten

Zahlungsmethoden verarbeiten mehrere Buchungen unterschiedlich:

Karten: Nur der erste Eintrag in jedem Array (car_rental_data[0], lodging_data[0], flight_data[0]) wird an Kartennetzwerke gesendet. Zusätzliche Einträge werden ignoriert und nicht zur Compliance von Kartennetzwerken verwendet.
Klarna: Alle Einträge in jedem Array werden verarbeitet und bei Klarnas Entscheidungen zur Risikobewertung und Autorisierung verwendet.

Erstellen Sie für Karten-Transaktionen mit mehreren Buchungen (z. B. mehrere Hotelaufenthalte oder Autovermietungen) separate PaymentIntents für jede Buchung, um sicherzustellen, dass alle Transaktionsdaten ordnungsgemäß an Kartennetzwerke gesendet werden.

Dieser Abschnitt ist in drei Eigenschaftskategorien für jede Vertikale unterteilt:

Allgemein unterstützte Eigenschaften: Grundfelder, die alle Zahlungsmethoden unterstützen. Diese Felder definieren die Kernstruktur der API.
Zusätzliche unterstützte Eigenschaften für Karten: Zusätzliche Felder, die Kartennetzwerke zusätzlich zu allgemeinen Eigenschaften verwenden. Verwenden Sie bei der Verarbeitung von Kartenzahlungen Felder aus der Kategorie „Allgemein“ und „Karten“.
Zusätzliche unterstützte Eigenschaften für Klarna: Zusätzliche Felder, die Klarna zusätzlich zu den allgemeinen Eigenschaften verwendet. Verwenden Sie bei der Verarbeitung von Klarna-Zahlungen Felder aus den Abschnitten „Allgemein“ und „Klarna“.

Karten und Klarna verwenden unterschiedliche Eigenschaften und Validierungsregeln. Eigenschaften, die an eine Zahlungsmethode gesendet werden und nicht unterstützt werden, werden ignoriert.

Auf den folgenden Registerkarten werden die Hashes car_rental_data, lodging_data und flight_data beschrieben:

Allgemeine unterstützte Eigenschaften

Die Stripe API unterstützt die folgenden Eigenschaften, die von allen Karten- und Klarna-Transaktionen verwendet werden.

Hinweis

Die unten aufgeführten Felder sind unter payment_details.car_rental_data verschachtelt. Im vollständigen Codebeispiel erfahren Sie, wie Sie Ihre API-Anfrage strukturieren.

Pflichtfelder für Mietwagen

Nachfolgend finden Sie die Pflichtfelder für alle Autovermietungs-Transaktionen:

pickup.address.line1
pickup.address.city
pickup.address.postal_code
pickup.address.country
pickup.time
drop_off.address.line1
drop_off.address.city
drop_off.address.postal_code
drop_off.address.country
drop_off.time
total.amount

Dies sind zusätzliche Felder, die für Karten-Transaktionen erforderlich sind:

pickup.address.state (falls für das Land zutreffend)
drop_off.address.state (falls für das Land zutreffend)
booking_number
days_rented
customer_service_phone_number
renter_name
vehicle.type
vehicle.make
vehicle.model

Eigenschaftsname	Typ	Beschreibung	Format
`pickup.address.line1`	Zeichenfolge	Erste Zeile der Fahrzeug-Abholadresse (Straße, Postfach oder Unternehmensname)	Erforderliche Eigenschaft Alphanumerisch Maximale Länge: 99 Zeichen
`pickup.address.postal_code`	Zeichenfolge	Postleitzahl der Autoabholadresse	Erforderliche Eigenschaft Alphanumerisch Maximale Länge: 10 Zeichen
`pickup.address.city`	Zeichenfolge	Stadt, Bezirk, Vorort, Stadt oder Dorf der Fahrzeug-Abholadresse	Erforderliche Eigenschaft Alphanumerisch Maximale Länge: 99 Zeichen
`pickup.address.country`	Zeichenfolge	Ländercode der Autoabholadresse	Erforderliche Eigenschaft Muss ein gültiger ISO 3166-1 Alpha-2-Ländercode sein
`pickup.time`	Zeitstempel	Autoabholzeit	Erforderliche Eigenschaft Sekunden seit der Unix-Epoche Muss zwischen 2 Jahren in der Vergangenheit und 2 Jahren in der Zukunft liegen
`drop_off.address.line1`	Zeichenfolge	Erste Zeile der Fahrzeugrückgabe-Adresse (Straße, Postfach oder Unternehmensname)	Erforderliche Eigenschaft Alphanumerisch Maximale Länge: 99 Zeichen
`drop_off.address.postal_code`	Zeichenfolge	Postleitzahl der Fahrzeugrückgabe-Adresse	Erforderliche Eigenschaft Alphanumerisch Maximale Länge: 10 Zeichen
`drop_off.address.city`	Zeichenfolge	Stadt, Bezirk, Vorort, Stadt oder Dorf der Fahrzeug-Rückgabeadresse	Erforderliche Eigenschaft Alphanumerisch Maximale Länge: 99 Zeichen
`drop_off.address.country`	Zeichenfolge	Ländercode der Fahrzeugrückgabe-Adresse	Erforderliche Eigenschaft Muss ein gültiger ISO 3166-1 Alpha-2-Ländercode sein
`drop_off.time`	Zeitstempel	Rückgabezeit des Autos	Erforderliche Eigenschaft Sekunden seit der Unix-Epoche Muss zwischen 2 Jahren in der Vergangenheit und 2 Jahren in der Zukunft liegen
`total.amount`	Ganzzahl	Preis der gesamten Autovermietung in der kleinsten Währungseinheit	Erforderliche Eigenschaft Minimum: 0
`pickup.address.state`	Zeichenfolge	Bundesstaat, Landkreis, Provinz oder Region der Wagen-Abholadresse	Erforderlich für Karten Bedingte Validierung¹ Alphanumerisch Maximale Länge: 99 Zeichen
`drop_off.address.state`	Zeichenfolge	Bundesstaat, Landkreis, Provinz oder Region der Fahrzeug-Rückgabeadresse	Erforderlich für Karten Bedingte Validierung² Alphanumerisch Maximale Länge: 99 Zeichen
`pickup.address.line2`	Zeichenfolge	Zweite Zeile der Fahrzeug-Abholadresse (Straße, Postfach oder Unternehmensname)	Alphanumerisch Maximale Länge: 99 Zeichen
`drop_off.address.line2`	Zeichenfolge	Zweite Zeile der Fahrzeug-Rückgabeadresse (Straße, Postfach oder Unternehmensname)	Alphanumerisch Maximale Länge: 99 Zeichen
`carrier_name`	Zeichenfolge	Name der Autovermietung	Alphanumerisch Maximale Länge: 255 Zeichen
`vehicle.vehicle_class`	Zeichenfolge	Stufe des Mietfahrzeugs	Eine der folgenden Klassen auswählen: `economy`, `premium_economy`, `business` oder `first_class`
`affiliate.name`	Zeichenfolge	Name der Tochtergesellschaft, die den Kauf initiiert hat	Alphanumerisch Maximale Länge: 255 Zeichen

¹ pickup.address.state muss ein gültiger Staat in pickup.address.country für Transaktionen mit Karten sein

² drop_off.address.state muss ein gültiger Staat in drop_off.address.country für Transaktionen mit Karten sein

Zusätzliche unterstützte Eigenschaften für Karten

Karten unterstützen die allgemeinen unterstützten Eigenschaften und verwenden auch die folgenden Eigenschaften. Klarna sieht diese Eigenschaften nicht und sie verbessern auch nicht die Autorisierungsraten oder Risikobewertung für Klarna-Transaktionen.

Eigenschaftsname	Typ	Beschreibung	Format
`booking_number`	Zeichenfolge	Buchungsbestätigungsnummer für die Autovermietung	Erforderlich für Karten Alphanumerisch Maximale Länge: 255 Zeichen
`days_rented`	Ganzzahl	Anzahl der Tage, an denen das Auto gemietet wurde	Erforderlich für Karten Minimum: 1 Maximal: 999
`customer_service_phone_number`	Zeichenfolge	Telefonnummer des Kundendienstes der Autovermietung	Erforderlich für Karten Muss eine gültige Telefonnummer sein (nur Zahlen), kann auch im Test-Modus nur aus Nullen bestehen (`0000000000`) Telefonnummern außerhalb der USA müssen mit einem Pluszeichen (`+`) beginnen
`renter_name`	Zeichenfolge	Name der Person, die das Fahrzeug mietet	Erforderlich für Karten Maximale Länge: 198 Zeichen
`vehicle.type`	Zeichenfolge	Code zur Angabe der Fahrzeugklasse	Erforderlich für Karten Wählen Sie eine Option aus `mini`, `subcompact`, `economy`, `compact`, `midsize`, `intermediate`, `standard`, `full_size`, `luxury`, `premium`, `minivan`, `twelve_passenger_van`, `moving_van`, `fifteen_passenger_van`, `cargo_van`, `twelve_foot_truck`, `twenty_foot_truck`, `twenty_four_foot_truck`, `twenty_six_foot_truck`, `moped`, `stretch`, `regular`, `unique`, `exotic`, `small_medium_truck`, `large_truck`, `small_suv`, `medium_suv`, `large_suv`, `exotic_suv`, `four_wheel_drive`, `special`, `taxi` oder `miscellaneous`
`vehicle.make`	Zeichenfolge	Marke des gemieteten Autos	Erforderlich für Karten Alphanumerisch Maximale Länge: 40 Zeichen
`vehicle.model`	Zeichenfolge	Modell des gemieteten Autos	Erforderlich für Karten Alphanumerisch Maximale Länge: 40 Zeichen
`distance.amount`	Ganzzahl	Während des Zeitraums der Autovermietung zurückgelegte Strecke	Bedingt erforderliche Eigenschaft ¹ Minimum: 0
`distance.unit`	Zeichenfolge	Entfernungseinheit für die zurückgelegte Strecke	Bedingt erforderliche Eigenschaft ¹ Entweder `miles` oder `kilometers`
`no_show_indicator`	Boolesch	Gibt an, dass die Kundin / der Kunde ihre/seine Buchung nicht wahrgenommen hat	`true` oder `false`
`pickup.location_name`	Zeichenfolge	Standort, an dem der Mietwagen abgeholt wurde	Alphanumerisch Maximale Länge: 38 Zeichen
`drop_off.location_name`	Zeichenfolge	Standort, an dem der Mietwagen abgegeben wurde	Alphanumerisch Maximale Länge: 38 Zeichen
`drivers[].driver_identification_number`	Zeichenfolge	Führerschein oder Ausweisnummer des autorisierten Fahrers im Mietwagenvertrag	Alphanumerisch Maximale Länge: 20 Zeichen Diese persönlich identifizierbaren Eigenschaften sind nicht erforderlich
`drivers[].driver_tax_number`	Zeichenfolge	Steuer-Identifikationsnummer des autorisierten Fahrers im Mietwagenvertrag	Alphanumerisch Maximale Länge: 20 Zeichen Diese persönlich identifizierbaren Eigenschaften sind nicht erforderlich
`total.rate_per_unit`	Ganzzahl	Tarif, der für jede zurückgelegte Weg- oder Zeiteinheit berechnet wird	Minimum: 0
`total.rate_unit`	Zeichenfolge	Einheit, die zur Berechnung des Tarifs pro gefahrener Einheit verwendet wird	Eine der folgenden Optionen auswählen: `miles`, `kilometers`, `days`, `weeks` oder `months`
`total.tax.tax_exempt_indicator`	Boolesch	Gibt an, ob die Autovermietung steuerbefreit ist oder keine Steuern erhoben wurde	`true` oder `false`
`total.tax.taxes[].rate`	Ganzzahl	Prozentsatz, der zur Berechnung dieses Steuer verwendet wird	Minimum: 0
`total.tax.taxes[].amount`	Ganzzahl	Betrag dieser für die Autovermietung erhobenen Steuer	Minimum: 0
`total.tax.taxes[].type`	Zeichenfolge	Art der auf die Autovermietung erhobenen Steuer	Alphanumerisch Maximale Länge: 40 Zeichen
`total.extra_charges[].amount`	Ganzzahl	Beträge von zusätzlichen Zahlungen, die während der Autovermietung angefallen sind	Minimum: 0
`total.extra_charges[].type`	Zeichenfolge	Arten von zusätzlichen Gebühren, die während der Autovermietung angefallen sind	Eine der folgenden Optionen auswählen: `one_way_drop_off`, `regular_mileage`, `extra_mileage`, `late_charge`, `parking`, `towing`, `gps`, `phone`, `gas` oder `other`
`total.discounts.maximum_free_miles_or_kilometers`	Ganzzahl	Anzahl der während der Autovermietung erlaubten kostenlosen Meilen oder Kilometer	Minimum: 0 Maximal: 9.999
`total.discounts.corporate_client_code`	Zeichenfolge	Einem Unternehmen zugewiesener Code für Unternehmenstarife oder -rabatte	Alphanumerisch Maximale Länge: 20 Zeichen
`total.discounts.coupon`	Zeichenfolge	Gutscheincode für Rabatt auf den Tarif des Mietwagenvertrags	Maximale Länge: 25 Zeichen
`vehicle.vehicle_identification_number`	Zeichenfolge	Registrierungsnummer des Mietfahrzeugs	Alphanumerisch Maximale Länge: 20 Zeichen
`vehicle.odometer`	Ganzzahl	Kilometerstandsanzeige bei der Erstvermietung des Wagens	Minimum: 0
`affiliate.code`	Zeichenfolge	Code der Tochtergesellschaft, die den Kauf initiiert hat	Alphanumerisch Maximale Länge: 20 Zeichen

¹ Die Eigenschaft distance ist optional. distance.amount und distance.unit sind erforderlich, wenn distance angegeben wird.

Weitere von Klarna unterstützte Eigenschaften

Klarna unterstützt die allgemeinen unterstützten Eigenschaften und verwendet auch die folgenden Eigenschaften. Die Kartennetzwerke sehen diese Eigenschaften nicht und sie wirken sich nicht auf die Compliance mit den Anforderungen der Kartennetzwerke für Kartentransaktionen aus.

Eigenschaftsname	Typ	Beschreibung	Format
`drivers[].name`	Zeichenfolge	Vollständiger Name des autorisierten Fahrers im Mietwagenvertrag	Bedingt erforderlich¹ Alphanumerisch Maximale Länge: 198 Zeichen
`drivers[].date_of_birth.day`	Ganzzahl	Geburtsdatum des autorisierten Fahrers im Mietwagenvertrag	Bedingt erforderlich² Minimum: 1 Maximal: 31 % `date_of_birth` muss ein gültiges Datum in der Vergangenheit sein
`drivers[].date_of_birth.month`	Ganzzahl	Geburtsdatum des autorisierten Fahrers im Mietwagenvertrag	Bedingt erforderlich² Minimum: 1 Maximal: 12 % `date_of_birth` muss ein gültiges Datum in der Vergangenheit sein
`drivers[].date_of_birth.year`	Ganzzahl	Geburtsdatum des autorisierten Fahrers im Mietwagenvertrag	Bedingt erforderlich² Minimum: 1901 `date_of_birth` muss ein gültiges Datum in der Vergangenheit sein
`carrier_name`	Zeichenfolge	Name der Autovermietung	Alphanumerisch Maximale Länge: 255 Zeichen
`total.currency`	Zeichenfolge	Währung des Preises der gesamten Autovermietung	Muss ein gültiger ISO 4217 3-Buchstaben-Code sein
`insurances[].insurance_type`	Zeichenfolge	Versicherungsschutz für die Autovermietung	Bedingt erforderlich³ Eine der folgenden Optionen auswählen: `liability_supplement`, `loss_damage_waiver`, `partial_damage_waiver`, `personal_accident`, `personal_effects` oder `other`
`insurances[].amount`	Ganzzahl	Preis der für die Autovermietung abgeschlossenen Versicherung in der kleinsten Währungen	Bedingt erforderlich³ Minimum: 0
`insurances[].currency`	Zeichenfolge	Währung der für die Autovermietung abgeschlossenen Versicherung	Muss ein gültiger ISO 4217 3-Buchstaben-Code sein
`insurances[].insurance_company_name`	Zeichenfolge	Name des Unternehmens, das die Autovermietung versichert	Maximale Länge: 255 Zeichen

¹ Das Array drivers ist optional. Die Angabe drivers[].name ist für jeden angegebenen Fahrer erforderlich.

² Die Eigenschaft drivers[].date_of_birth ist optional. drivers[].date_of_birth.day, drivers[].date_of_birth.month, und drivers[].date_of_birth.year sind alle erforderlich, wenn drivers[].date_of_birth angegeben wird.

³ Das Array insurances ist optional. insurances[].insurance_type und insurances[].amount sind für jede angegebene Versicherung erforderlich.

Hinweis

Bei bestimmten Eigenschaften können die Längen gekürzt werden, um verschiedenen Anforderungen an Zahlungsmethoden zu entsprechen, die unterschiedliche Eigenschaftsgrößen akzeptieren.

PaymentIntents verwenden

Fügen Sie Daten zu payment_details hinzu, wenn Sie einen PaymentIntent erstellen, aktualisieren, bestätigen oder erfassen.

Nachfolgend werden die Schritte zur manuellen Bestätigung und Erfassung erläutert, so wird verdeutlicht, wie payment_details während des Lebensyzklus des PaymentIntent aktualisiert werden. Sie können payment_details für Anwendungsfälle zur automatischen Bestätigung oder Erfassung angeben.

Erstellen Sie ein PaymentIntent

Erstellen Sie einen unbestätigten und nicht erfassten PaymentIntent mit payment_details. Verwenden Sie die Methode Update, um payment_details zu aktualisieren, bevor Sie den PaymentIntent bestätigen. Alle payment_details-Aktualisierungen sind eine vollständige Hash-Ersetzung und müssen für Ihre Zahlung gültig sein.

Command Line
Sprache auswählencURL
 No results
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=200 \
  -d currency=usd \
  -d "payment_method_types[0]"=card \
  -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \
  -d "payment_details[car_rental_data][0][days_rented]"=3 \
  --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \
  -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \
  -d "payment_details[car_rental_data][0][no_show_indicator]"=false \
  -d "payment_details[car_rental_data][0][distance][amount]"=150 \
  -d "payment_details[car_rental_data][0][distance][unit]"=miles \
  -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \
  -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \
  -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \
  -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \
  -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \
  -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \
  -d "payment_details[car_rental_data][0][pickup][address][country]"=US \
  -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \
  -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \
  -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \
  -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \
  -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \
  -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \
  -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \
  -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \
  -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \
  -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \
  -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \
  -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \
  -d "payment_details[car_rental_data][0][total][amount]"=30000 \
  -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \
  -d "payment_details[car_rental_data][0][total][rate_unit]"=days \
  -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \
  -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \
  -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \
  -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \
  -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \
  -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \
  -d "payment_details[car_rental_data][0][vehicle][type]"=compact \
  -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \
  -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \
  -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \
  -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \
  -d "payment_details[car_rental_data][0][affiliate][code]"=TP001

PaymentIntent bestätigen

Sie können payment_details aktualisieren, wenn Sie den PaymentIntent bestätigen. Alle payment_details-Aktualisierungen sind eine vollständige Hash-Ersetzung und müssen für Ihre Zahlungsmethode gültig sein. Unter Senden von branchenspezifischen Daten finden Sie weitere Informationen darüber, was die einzelnen Eigenschaften bedeuten.

Command Line
Sprache auswählencURL
 No results
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \
  -d "payment_details[car_rental_data][0][days_rented]"=3 \
  --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \
  -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \
  -d "payment_details[car_rental_data][0][no_show_indicator]"=false \
  -d "payment_details[car_rental_data][0][distance][amount]"=150 \
  -d "payment_details[car_rental_data][0][distance][unit]"=miles \
  -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \
  -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \
  -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \
  -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \
  -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \
  -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \
  -d "payment_details[car_rental_data][0][pickup][address][country]"=US \
  -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \
  -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \
  -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \
  -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \
  -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \
  -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \
  -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \
  -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \
  -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \
  -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \
  -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \
  -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \
  -d "payment_details[car_rental_data][0][total][amount]"=30000 \
  -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \
  -d "payment_details[car_rental_data][0][total][rate_unit]"=days \
  -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \
  -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \
  -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \
  -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \
  -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \
  -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \
  -d "payment_details[car_rental_data][0][vehicle][type]"=compact \
  -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \
  -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \
  -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \
  -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \
  -d "payment_details[car_rental_data][0][affiliate][code]"=TP001

PaymentIntent erfassen

Sie können payment_details bei der Erfassung des PaymentIntent einfügen und aktualisieren. Achten Sie darauf, dass die von Ihnen angegebenen Daten vollständig sind, da payment_details nach der Erfassung eines PaymentIntent nicht mehr geändert werden kann. Unter Senden von branchenspezifischen Daten finden Sie weitere Informationen darüber, was die einzelnen Eigenschaften bedeuten.

Command Line
Sprache auswählencURL
 No results
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \
  -d "payment_details[car_rental_data][0][days_rented]"=3 \
  --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \
  -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \
  -d "payment_details[car_rental_data][0][no_show_indicator]"=false \
  -d "payment_details[car_rental_data][0][distance][amount]"=150 \
  -d "payment_details[car_rental_data][0][distance][unit]"=miles \
  -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \
  -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \
  -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \
  -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \
  -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \
  -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \
  -d "payment_details[car_rental_data][0][pickup][address][country]"=US \
  -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \
  -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \
  -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \
  -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \
  -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \
  -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \
  -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \
  -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \
  -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \
  -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \
  -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \
  -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \
  -d "payment_details[car_rental_data][0][total][amount]"=30000 \
  -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \
  -d "payment_details[car_rental_data][0][total][rate_unit]"=days \
  -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \
  -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \
  -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \
  -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \
  -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \
  -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \
  -d "payment_details[car_rental_data][0][vehicle][type]"=compact \
  -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \
  -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \
  -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \
  -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \
  -d "payment_details[car_rental_data][0][affiliate][code]"=TP001

Mehrere Reisemethoden

Sie können auch mehrere Arten von Branchendaten zu einem einzigen payment_details-Objekt hinzufügen, um Informationen über Transaktionen mit mehreren Reisestrecken zu erhalten. Siehe Senden von branchenspezifischen Daten für weitere Informationen darüber, was die einzelnen Eigenschaften bedeuten.

Command Line
Sprache auswählencURL
 No results
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=200 \
  -d currency=usd \
  -d "payment_method_types[0]"=card \
  -d "payment_details[car_rental_data][0][booking_number]"=BOOK123456 \
  -d "payment_details[car_rental_data][0][days_rented]"=3 \
  --data-urlencode "payment_details[car_rental_data][0][customer_service_phone_number]"="+18005551234" \
  -d "payment_details[car_rental_data][0][renter_name]"="John Doe" \
  -d "payment_details[car_rental_data][0][no_show_indicator]"=false \
  -d "payment_details[car_rental_data][0][distance][amount]"=150 \
  -d "payment_details[car_rental_data][0][distance][unit]"=miles \
  -d "payment_details[car_rental_data][0][drivers][0][name]"="Jane Driver" \
  -d "payment_details[car_rental_data][0][drivers][0][driver_identification_number]"=D12345678 \
  -d "payment_details[car_rental_data][0][drivers][0][driver_tax_number]"=TN123456789 \
  -d "payment_details[car_rental_data][0][pickup][address][line1]"="123 Main St" \
  -d "payment_details[car_rental_data][0][pickup][address][postal_code]"=10001 \
  -d "payment_details[car_rental_data][0][pickup][address][city]"="New York" \
  -d "payment_details[car_rental_data][0][pickup][address][country]"=US \
  -d "payment_details[car_rental_data][0][pickup][address][state]"=NY \
  -d "payment_details[car_rental_data][0][pickup][address][line2]"="Apt 4B" \
  -d "payment_details[car_rental_data][0][pickup][time]"=1768500000 \
  -d "payment_details[car_rental_data][0][pickup][location_name]"="Downtown Garage" \
  -d "payment_details[car_rental_data][0][drop_off][address][line1]"="456 Elm St" \
  -d "payment_details[car_rental_data][0][drop_off][address][postal_code]"=02101 \
  -d "payment_details[car_rental_data][0][drop_off][address][city]"=Boston \
  -d "payment_details[car_rental_data][0][drop_off][address][country]"=US \
  -d "payment_details[car_rental_data][0][drop_off][address][state]"=MA \
  -d "payment_details[car_rental_data][0][drop_off][address][line2]"="Suite 101" \
  -d "payment_details[car_rental_data][0][drop_off][time]"=1768777200 \
  -d "payment_details[car_rental_data][0][drop_off][location_name]"="Airport Terminal" \
  -d "payment_details[car_rental_data][0][total][amount]"=30000 \
  -d "payment_details[car_rental_data][0][total][rate_per_unit]"=1500 \
  -d "payment_details[car_rental_data][0][total][rate_unit]"=days \
  -d "payment_details[car_rental_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][amount]"=3000 \
  -d "payment_details[car_rental_data][0][total][tax][taxes][0][type]"="Sales Tax" \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][amount]"=2000 \
  -d "payment_details[car_rental_data][0][total][extra_charges][0][type]"=gps \
  -d "payment_details[car_rental_data][0][total][discounts][maximum_free_miles_or_kilometers]"=100 \
  -d "payment_details[car_rental_data][0][total][discounts][corporate_client_code]"=CORP123 \
  -d "payment_details[car_rental_data][0][total][discounts][coupon]"=SAVE20 \
  -d "payment_details[car_rental_data][0][insurances][0][insurance_type]"=liability_supplement \
  -d "payment_details[car_rental_data][0][insurances][0][amount]"=1500 \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_class]"=premium_economy \
  -d "payment_details[car_rental_data][0][vehicle][type]"=compact \
  -d "payment_details[car_rental_data][0][vehicle][make]"=Toyota \
  -d "payment_details[car_rental_data][0][vehicle][model]"=Camry \
  -d "payment_details[car_rental_data][0][vehicle][vehicle_identification_number]"=1HGBH41JXMN109186 \
  -d "payment_details[car_rental_data][0][vehicle][odometer]"=25000 \
  -d "payment_details[car_rental_data][0][affiliate][name]"="Travel Partner" \
  -d "payment_details[car_rental_data][0][affiliate][code]"=TP001 \
  -d "payment_details[lodging_data][0][checkin_at]"=1771624800 \
  -d "payment_details[lodging_data][0][checkout_at]"=1771869600 \
  -d "payment_details[lodging_data][0][booking_number]"=HOTEL345678 \
  -d "payment_details[lodging_data][0][fire_safety_act_compliance_indicator]"=true \
  --data-urlencode "payment_details[lodging_data][0][customer_service_phone_number]"="+12025551234" \
  -d "payment_details[lodging_data][0][renter_name]"="Jane Smith" \
  -d "payment_details[lodging_data][0][renter_id_number]"=ID123456789 \
  -d "payment_details[lodging_data][0][no_show_indicator]"=false \
  --data-urlencode "payment_details[lodging_data][0][host][property_phone_number]"="+18005556789" \
  -d "payment_details[lodging_data][0][total][amount]"=50000 \
  -d "payment_details[lodging_data][0][total][prepaid_amount]"=25000 \
  -d "payment_details[lodging_data][0][total][cash_advances]"=10000 \
  -d "payment_details[lodging_data][0][total][tax][tax_exempt_indicator]"=false \
  -d "payment_details[lodging_data][0][total][tax][taxes][0][rate]"=10 \
  -d "payment_details[lodging_data][0][total][tax][taxes][0][amount]"=5000 \
  -d "payment_details[lodging_data][0][total][tax][taxes][0][type]"="City Tax" \
  -d "payment_details[lodging_data][0][total][extra_charges][0][amount]"=3000 \
  -d "payment_details[lodging_data][0][total][extra_charges][0][type]"=mini_bar \
  -d "payment_details[lodging_data][0][total][discounts][corporate_client_code]"=CORP456 \
  -d "payment_details[lodging_data][0][total][discounts][coupon]"=WINTER10 \
  -d "payment_details[lodging_data][0][accommodation][accommodation_type]"=suite \
  -d "payment_details[lodging_data][0][accommodation][nights]"=3 \
  -d "payment_details[lodging_data][0][accommodation][daily_rate_amount]"=15000 \
  -d "payment_details[lodging_data][0][accommodation][rate_type]"=Standard \
  -d "payment_details[lodging_data][0][accommodation][smoking_indicator]"=false \
  -d "payment_details[lodging_data][0][accommodation][bed_type]"=King \
  -d "payment_details[lodging_data][0][affiliate][name]"="Travel Network" \
  -d "payment_details[lodging_data][0][affiliate][code]"=TN987

Testen

Testen Sie, ob Ihre Integration für Ihre Kundinnen und Kunden korrekt funktioniert. Sie können API-Aufrufe in einer Stripe-Sandbox mithilfe eines Sandbox-Schlüssels simulieren. Weitere Informationen finden Sie unter Testen.

Während des Tests können Sie Folgendes verifizieren:

Ihre Branchenmetadaten sind korrekt formatiert und werden von der API akzeptiert.
Für Ihre Zahlungsmethode (Karten oder Klarna) sind Pflichtfelder vorhanden.
Der PaymentIntent wird erfolgreich mit Ihren Metadaten verarbeitet

Sandbox-Tests überprüfen, ob Ihre Integration technisch korrekt ist, simulieren jedoch nicht die Qualifizierungsentscheidungen des Kartennetzwerks oder die Autorisierungsraten und Risikobewertungsergebnisse von Klarna.