ZahlungspostenPrivate Vorschau

Senden Sie zusätzliche Transaktionsmetadaten über unterstützte Zahlungsmethodentypen hinweg, um Kosteneinsparungen zu erzielen, den Zahlungsabgleich zu vereinfachen und die Autorisierungsraten zu verbessern.

Contact to enable

Contact your sales representative or support to enable this private preview feature.

„Zahlungsposten“ ist eine Funktion der Payment Intents API, die Vorteile für die Verarbeitung von Karten und lokalen Zahlungsmethoden bietet.

Cost savings for eligible commercial cards for IC+ users: By passing Payment Line Items, you can participate in the Level 2/Level 3 (L2/L3) program that major card networks administer. For eligible commercial cards, passing line item data can provide interchange fee savings.
Abgleich erleichtern: In Fällen, in denen keine Kosteneinsparungen erzielt werden, kann die Übermittlung von Postendaten den Abgleich für Ihre Kundinnen/Kunden erleichtern. Wenn Sie beispielsweise hauptsächlich Regierungskunden betreuen, können die Kundinnen/Kunden so ihren Einkauf besser mit den auf ihren Abrechnungen angezeigten Daten abgleichen.
Verbesserte Autorisierungsquoten: Zahlungsmethoden wie PayPal und Klarna verwenden Postendaten in ihren Versicherungsmodellen, sodass sie bei der Übergabe von Postendaten potenziell mehr Zahlungen genehmigen können.

Einschränkungen der Funktion

Für Zahlungsposten gelten die folgenden Einschränkungen in Bezug auf alle unterstützten Zahlungsmethodentypen:

	L2/L3-Kartenprogramm	Klarna	PayPal
Geografische Verfügbarkeit	Nur für US-Inlandstransaktionen unterstützt (US-Nutzer/innen akzeptieren in den USA ausgestellte Karten, ausgenommen US-Territorien)	Unterstützt für alle Zahlungen, unabhängig von Ihrem Unternehmens- oder Kundenstandort	Unterstützt für alle Zahlungen, unabhängig von Ihrem Unternehmens- oder Kundenstandort
Kartennetzwerke	Nur unterstützt für Visa, Mastercard und American Express (Kosteneinsparungen erfordern eine direkte Vereinbarung mit American Express)	Nicht zutreffend	Nicht zutreffend
Anzahl der Einzelposten	Unterstützt derzeit 100 Posten (maximal 4 Posten bei American Express)	Wie bei Karten	Wie bei Karten
Feature compatibility	Only auto and separate authorization and capture modes work with Payment Line Items. You can’t currently use flexible payment scenarios or decremental authorization for transactions where you’re passing in Payment Line Items.	Wie bei Karten	Wie bei Karten
Branchenspezifische Metadaten	You can’t send line items alongside industry specific metadata (such as car rental/lodging, and airlines).	Wie bei Karten. Klarna unterstützt branchenspezifische Metadaten mit zusätzlichen Händlerdaten.	Wie bei Karten
Surfaces	Only available for payments made through the PaymentIntents API.	Wie bei Karten	Wie bei Karten

Anspruch auf L2-/L3-Raten

Unter Branchen-/MCC-Codes erfahren Sie, unter welchen MCC Ihr Unternehmen fallen könnte.

Die Stripe API lehnt Einzelposten, die die Netzwerk-MCC- oder Steueranforderungen nicht erfüllen, nicht ab. Diese Transaktionen qualifizieren sich jedoch nicht für die entsprechenden Einsparungen der Stufe 2 und 3.

Anspruch auf L2-/L3-Raten	Level 2	Level 3
Kartentypen	Nur Geschäfts-, Einkaufs- und Firmenkarten sind berechtigt	Nur Einkaufs- und Firmenkarten sind berechtigt
MCCs	Nutzer/innen mit den folgenden MCCs sind nicht für Stufe II berechtigt: Für Mastercard: 5812, 3501-3999, 7011, 3351-3500, 7512, 7513, 7519, 3000-3299, 4511, 4112, 8398, 4468, 5541, 5542, 5499, 5983 Für Visa: 5812, 5814, 3501-4010, 3351-3500, 7512, 7513, 3000-3299, 4511, 4411, 4112, 4722, 5962, 5966, and 5967	Nutzer/innen mit den folgenden MCCs sind nicht für Stufe III berechtigt: Für Mastercard: 5812, 3501-3999, 7011, 3351-3500, 7512, 7513, 7519, 3000-3299, 4511, 4112 Für Visa: 5812, 5814, 3501-4010, 3351-3500, 7512, 7513, 3000-3299, 4511, 4411, 4112, 4722, 5962, 5966, and 5967
Anforderungen für die Verkaufssteuer	Für Visa: Umsatzsteuer muss zwischen 0,1 % und 22 % liegen, es sei denn, das Unternehmen hat einen der folgenden MCCs: 4468, 5499, 5541, 5542 und 5983 Für Mastercard muss die Umsatzsteuer zwischen 0,1 % und 30 % liegen, es sei denn, das Unternehmen hat einen der folgenden MCCs: 4468, 5541, 5542, 5499, 5983, 7511, 9752, 4111, 4131, 4215, 4784, 8211, 8220, 8398, 8661, 9211, 9222, 9311, 9399, 9402	Nicht zutreffend

Feldanforderungen

All the fields mentioned below are passed inside amount_details. Refer to Sample request (Level II data) to learn about passing data.

Unterstützte Felder für Karten

Private Vorschau

Two more fields [Commodity Code] and [Unit of Measure] aren’t yet available in private preview, but will become required for the Visa CEDP program (refer to Network Cost Updates for Feb 20, 2025).

Feldname	Typ	Werte/Einschränkungen	Beschreibung	Erforderlich für L2/L3	Erforderliche API-Felder
payment_details[customer_reference]	Zeichenfolge	Dieses Feld ist für Zahlungen ohne Karte nicht verfügbar.	Einige Kundinnen/Kunden werden möglicherweise von ihrem Unternehmen oder ihrer Organisation dazu aufgefordert, diese Informationen zur Verfügung zu stellen. Geben Sie in diesem Fall diesen Wert ein. Andernfalls können Sie dieses Feld ignorieren.
payment_details[order_reference]	Zeichenfolge	Dieses Feld ist für Zahlungen ohne Karte nicht verfügbar. If automatic_payment_methods.enabled is set to `true`, you must set this field as Card is a default Payment Method.	Ein einmaliger Wert, der vom Unternehmen zugewiesen wurde, um die Transaktion zu identifizieren.	✅ L2/L3
discount_amount	Zahl	Der Wert muss > 0 betragen	Der auf die Transaktion angewendete Gesamtrabatt.
shipping[to_postal_code]	Zeichenfolge	Maximale Länge 10 Zeichen. Der Wert muss aus alphanumerischen Zeichen bestehen	Wenn eine physische Ware versendet wird, die Postleitzahl des Ortes, an den sie versendet wird.
shipping[from_postal_code]	Zeichenfolge	Maximale Länge 10 Zeichen. Der Wert muss aus alphanumerischen Zeichen bestehen	Wenn eine physische Ware versendet wird, die Postleitzahl, von der aus sie versendet wird.
shipping[amount]	Zahl	Der Wert muss >= 0 sein	Wenn eine physische Ware versendet wird, die Versandkosten.
tax[total_tax_amount]	Zahl	Der Wert muss >= 0 sein	Der Gesamtsteuerbetrag der Transaktion.	✅ L2
line_items[Steuer][total_tax_amount]	Zahl	Der Wert muss >= 0 sein	Der Gesamtsteuerbetrag für einen einzelnen Posten.	✅ L3
line_items[product_name]	Zeichenfolge	Maximale Länge: 100 Zeichen	Der Produktname des Postens.	✅ L3	✓
line_items[product_code]	Zeichenfolge	Maximale Länge: 12 Zeichen	Der Produktcode des Postens, beispielsweise einer SKU.	✅ L3
line_items[unit_cost]	Zahl	Der Wert muss >= 0 sein	Die Stückkosten des Postens.	✅ L3	✓
line_items[Menge]	Zahl	Der Wert muss > 0 betragen	Die Menge der Artikel.	✅ L3	✓
line_items[discount_amount]	Zahl	Der Wert muss > 0 betragen	Der auf diesen Posten angewendete Rabatt.

Notiz

Die folgenden Felder schließen sich gegenseitig aus, Sie können nur eines davon in einer Anfrage angeben:

Entweder tax[total_tax_amount] oder line_items[tax][total_tax_amount]
Entweder discount_amount oder line_items[discount_amount]

Zusätzliche von Klarna unterstützte Felder

Klarna unterstützt die oben genannten Felder für Karten sowie zusätzlich:

Feldname	Typ	Werte und Einschränkungen	Beschreibung	Erforderlich
line_items[PMO][Klarna][product_url]	Zeichenfolge	Maximal 1024 Zeichen. Grober Regex: `https?:\/\/[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,64}\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)`	Gültige HTTP- oder HTTPS-URL des Produkts
line_items[PMO][Klarna][image_url]	Zeichenfolge	Maximal 1024 Zeichen. Grober Regex: `https?:\/\/[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,64}\b([-a-zA-Z0-9()!@:%_\+.~#?&\/\/=]*)`	Gültige HTTP- oder HTTPS-URL des Bildes

Notiz

Für Klarna-Transaktionen wird der Gesamtbetrag implizit aus der Formel (unit_cost * quantity) - discount_amount + tax.total_tax_amount abgeleitet. Es gibt kein explizites Feld für die Übergabe des Betrags.

Zusätzliche von PayPal unterstützte Felder

PayPal unterstützt die obigen Felder für Karten sowie zusätzlich:

Feldname	Typ	Werte/Einschränkungen	Beschreibung
line_items[PMO][PayPal][Beschreibung]	Zeichenfolge	Maximal 127 Zeichen	Beschreibung des Postens.
line_items[PMO][PayPal][Kategorie]	Enum	digital_goods, physical_goods, Spende	Art des Postens.
line_items[PMO][PayPal][sold_by]	Zeichenfolge	Maximal 127 Zeichen	Die Stripe Konto-ID des verbundenen Kontos, das den Artikel verkauft.

Kartenspezifische Posten für L2-/L3-Raten

Übergeben Sie die erforderlichen Daten für berechtigte Karten, um sich für L2-/L3-Netzwerkprogramme zu qualifizieren

Stufe II: Umsatzsteuer auf Transaktionen
Stufe III: Aufschlüsselung nach Posten, z. B. Produktcode, Menge, Stückkosten

Beispielanfrage (Daten der Stufe II)

Beispielantwort

{
  id: "pi_3OoMm5BLxXjrKOiR3LRyi610",
  amount: 4600,
  currency: "usd"
  amount_details: {
    tax: {
      total_tax_amount: 500
    },
  },
  status: "requires_payment_method"
}

Bestätigung des Payment Intent

Erfassung von PaymentIntents

Erfassen Sie den PaymentIntent nach der Bestätigung separat, indem Sie manual_capture: true während der PaymentIntent-Erstellung oder Bestätigung übergeben, und rufen Sie dann den Erfassungs-Endpoint einzeln auf.

Übergeben Sie bei Bedarf einen aktualisierten amount_details-Hash während der Erfassung.

Zahlungsmethodenspezifische Posten

Übergeben Sie zusätzliche Arten von Zahlungsmethoden für jeden einzelnen Posten an einer einzigen Stelle. Sie können auch Daten zu Zahlungsmethoden übergeben, die Sie möglicherweise nicht einsetzen, solange der Parameter unterstützt wird. Dadurch kann Ihre Integration vereinfacht werden, ohne dass Sie für jede Zahlungsmethode eigene Felder hinzufügen oder entfernen müssen.

Notiz

Posten sind nicht standardmäßig in der API-Antwort enthalten. Um Posten zurückzugeben, erweitern Sie amount_details.line_items

Beispielanfrage

Command Line
cURL
curl https://api.stripe.com/v1/payment_intents \
  -u "sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=4600 \
  -d currency=usd \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=paypal \
  -d "payment_method_types[2]"=klarna \
  -d "payment_details[customer_reference]"=customer_reference \
  -d "payment_details[order_reference]"=order_reference \
  -d "amount_details[discount_amount]"=0 \
  -d "amount_details[shipping][from_postal_code]"=94110 \
  -d "amount_details[shipping][to_postal_code]"=94117 \
  -d "amount_details[shipping][amount]"=100 \
  -d "amount_details[tax][total_tax_amount]"=500 \
  -d "amount_details[line_items][0][product_code]"=SKU001 \
  -d "amount_details[line_items][0][product_name]"="Product 001" \
  -d "amount_details[line_items][0][unit_cost]"=2000 \
  -d "amount_details[line_items][0][quantity]"=1 \
  -d "amount_details[line_items][0][discount_amount]"=0 \
  -d "amount_details[line_items][0][tax][total_tax_amount]"=100 \
  --data-urlencode "amount_details[line_items][0][payment_method_options][klarna][image_url]"="https://www.example.com/image.jpg" \
  --data-urlencode "amount_details[line_items][0][payment_method_options][klarna][product_url]"="https://www.example.com/product" \
  -d "amount_details[line_items][0][payment_method_options][paypal][description]"="This is a sample product description unique to PayPal for SKU001" \
  -d "amount_details[line_items][0][payment_method_options][paypal][category]"=digital_goods \
  -d "amount_details[line_items][1][product_code]"=SKU002 \
  -d "amount_details[line_items][1][product_name]"="Product 002" \
  -d "amount_details[line_items][1][unit_cost]"=1800 \
  -d "amount_details[line_items][1][quantity]"=1 \
  -d "amount_details[line_items][1][discount_amount]"=0 \
  -d "amount_details[line_items][1][tax][total_tax_amount]"=100 \
  --data-urlencode "amount_details[line_items][1][payment_method_options][klarna][image_url]"="https://www.example.com/image.jpg" \
  --data-urlencode "amount_details[line_items][1][payment_method_options][klarna][product_url]"="https://www.example.com/product" \
  -d "amount_details[line_items][1][payment_method_options][paypal][description]"="This is a sample product description unique to PayPal for SKU002" \
  -d "amount_details[line_items][1][payment_method_options][paypal][category]"=physical_goods \
  -d "expand[0]"="amount_details.line_items"

Beispielantwort

{
  id: "pi_3OoMm5BLxXjrKOiR3LRyi610",
  amount: 4600,
  currency: "usd"
  amount_details: {
    shipping: {
      from_postal_code: "94110",
      to_postal_code: "94117",
      amount: 100
    },
    tax: {
      total_tax_amount: 500
    },
    line_items: {
      object: "list",
      url: "/v1/payment_intents/pi_3OoMm5BLxXjrKOiR3LRyi610/amount_details_line_items",
      has_more: false,
      data: [{
          _id: "li_123",
          product_code: "SKU001",
          product_name: "Product 001",
          unit_cost: 2000,
          quantity: 1,
          discount_amount: 0,
          tax: {
            total_tax_amount: 100
          },
          payment_method_options: {
            klarna: {
              image_url: "https://www.example.com/image.jpg",
              product_url: "https://www.example.com/product"
            },
            paypal: {
              description: "This is a sample product description unique to PayPal for SKU001",
              category: digital_goods,
            }
          }
        },
        {
          _id: "li_456",
          product_code: "SKU002",
          product_name: "Product 002",
          unit_cost: 1800,
          quantity: 1,
          discount_amount: 0,
          tax: {
            total_tax_amount: 100
          },
          payment_method_options: {
            klarna: {
              image_url: "https://www.example.com/image.jpg",
              product_url: "https://www.example.com/product"
            },
            paypal: {
              description: "This is a sample product description unique to PayPal for SKU001",
              category: physical_goods,
            }
          }
        }
      ]
    }
  },
  status: "requires_payment_method"
}

Branchen-zu-MCC-Codes

Kategorie	Beschreibung
Lebensmittel und Getränke	5812: Restaurants (kein Fast Food) 5814: Schnellrestaurants
Bewirtung und Reisen	3000-3299: Fluggesellschaften 3501-3999, 7011: Hotels & Unterkünfte 3351-3500: Autovermietung 4722: Reiseagenturen und Reiseveranstalter 7512: Autovermietung 7513: Vermietung und Leasing von Lastkraftwagen 7519: Vermietung von Wohnmobilen und Campingfahrzeugen 4411: Kreuzfahrtunternehmen 4112: Schienenpersonenverkehr 4111: Lokaler und vorstädtischer Pendlerverkehr 4215: Kurierdienste 4784: Brücken- und Straßengebühren 4468: Jachthafen, Bootsdienstleistungen 5983: Brennstoffhändler
Einzelhandel und E-Commerce	5962: Direktmarketing – Reisen 5966: Direktmarketing – ausgehendes Telemarketing 5967: Direktmarketing – Sonstiges
Versorgungsunternehmen und Sonstiges	8398: Gemeinnützige und soziale Einrichtungen 9752: Tankstellen in UK, elektronische Hot File 9211: Gerichtskosten, einschließlich Unterhalt und Kindesunterhalt 9311: Steuerzahlungen 9222: Geldstrafen 9402: Postdienste – nur staatliche und ähnliche Dienstleistungen 9399: Behördliche Dienstleistungen (nicht anderweitig zugeordnet) und ähnliche Dienstleistungen 8661: Religiöse Organisationen 8211: Schulen und Bildungseinrichtungen 8220: Hochschulen, Universitäten, Fachhochschulen