ZahlungpostenPrivate Vorschau

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

Zum Aktivieren Kontakt aufnehmen

Wenden Sie sich an Ihren Vertriebsmitarbeiter oder an den Support, um diese Funktion in der privaten Vorschau zu aktivieren.

„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 einfacher gestalten: Die Übermittlung von Postendaten kann auch den Abgleich für Ihre Kundinnen/Kunden einfacher machen. Wenn Sie beispielsweise hauptsächlich Regierungskundinnen/-kunden betreuen, können die Kundinnen/Kunden so ihren Einkauf besser mit den auf ihren Abrechnungen angezeigten Daten abgleichen.
Verbesserte Autorisierungsquoten: Zahlungsmethoden wie Klarna und PayPal verwenden Postendaten in ihren Risikoevaluationsmodellen, sodass sie potenziell mehr kreditbasierte Zahlungsoptionen genehmigen können, wenn Postendaten übergeben werden.

Einschränkungen der Funktion

Für Zahlungsposten gelten die folgenden Einschränkungen in Bezug auf die 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)	Klarna ist eine globale Zahlungsmethode. Informationen zur Unterstützung von Unternehmensstandorten finden Sie unter Zahlungen mit Klarna.	Verfügbar für Kundinnen und Kunden an allen Standorten. Informationen zur Unterstützung von Unternehmensstandorten finden Sie unter Zahlungen per PayPal.
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
Kompatibilität der Funktionen	Bei Zahlungsposten funktioniert nur der automatische Modus und der separate Autorisierungs- und Erfassungsmodus. Derzeit können Sie die dekrementelle Autorisierung nicht für Transaktionen verwenden, bei denen Sie Zahlungsposten übergeben.	Bei Zahlungsposten funktioniert nur der automatische Modus und der separate Autorisierungs- und Erfassungsmodus.	Bei Zahlungsposten funktioniert nur der automatische Modus und der separate Autorisierungs- und Erfassungsmodus.
Branchenspezifische Metadaten	Sie können keine Posten zusammen mit branchenspezifischen Metadaten wie Mietwagen/Unterkünfte und Fluggesellschaften senden	Klarna unterstützt branchenspezifische Metadaten mit zusätzlichen Händlerdaten (private Vorschau).	Wie bei Karten
Oberflächen	Nur verfügbar für Zahlungen über die 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

Alle unten aufgeführten Felder werden innerhalb der Parameter amount_details oder payment_details übergeben. Weitere Informationen zur Übergabe von Daten finden Sie unter Beispielanfrage (Daten der Stufe II).

Allgemein unterstützte Felder

Private Vorschau

Zwei weitere Felder, [Warennummer] und [Maßeinheit], sind noch nicht in der privaten Vorschau verfügbar, werden aber für das Visa-CEDP-Programm erforderlich (siehe Aktualisierungen der Netzwerkkosten für 20. Februar 2025).

Feldname	Typ	Werte/Einschränkungen	Beschreibung	Erforderlich für L2/L3	Erforderliche API-Felder
payment_details[customer_reference]	Zeichenfolge	Dieses Feld ist nur für Kartenzahlungen verfügbar. Bevor wir diese Zeichenfolge an ein Kartennetzwerk senden, kürzen wir sie auf 25 alphanumerische Zeichen ohne Leerzeichen.	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 nur für Kartenzahlungen verfügbar. Bevor wir diese Zeichenfolge an ein Kartennetzwerk senden, kürzen wir sie auf 25 alphanumerische Zeichen ohne Leerzeichen. Wenn automatic_payment_methods.enabled auf `true` gesetzt ist, müssen Sie dieses Feld als Standardzahlungsmethode festlegen.	Ein einmaliger Wert, der vom Unternehmen zugewiesen wurde, um die Transaktion zu identifizieren.	✅ L2/L3
discount_amount	Ganzzahl	Der Wert muss > 0 betragen	Der auf die Transaktion angewendete Gesamtrabatt wird in der kleinsten Währungseinheit dargestellt.
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]	Ganzzahl	Der Wert muss >= 0 sein	Wenn eine physische Ware versendet wird, werden die Versandkosten in der kleinsten Währungseinheit dargestellt.
tax[total_tax_amount]	Ganzzahl	Der Wert muss >= 0 sein	Der Gesamtsteuerbetrag der Transaktion.	✅ L2
line_items[Steuer][total_tax_amount]	Ganzzahl	Der Wert muss >= 0 sein	Der Gesamtsteuerbetrag für einen einzelnen Posten wird in der kleinsten Währungseinheit dargestellt.	✅ L3
line_items[product_name]	Zeichenfolge	Maximale Länge 1024 Zeichen. Karten werden auf 26 Zeichen gekürzt und PayPal auf 127 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]	Ganzzahl	Der Wert muss >= 0 sein	Die Stückkosten des Postens werden in der kleinsten Währungseinheit dargestellt.	✅ L3	✓
line_items[Menge]	Ganzzahl	Der Wert muss > 0 betragen	Die Menge der Artikel.	✅ L3	✓
line_items[discount_amount]	Ganzzahl	Der Wert muss > 0 betragen	Der auf diesen Posten angewendete Rabatt wird in der kleinsten Währungseinheit dargestellt.

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[payment_method_options][klarna][product_url]	Zeichenfolge	Maximal 4096 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[payment_method_options][klarna][image_url]	Zeichenfolge	Maximal 4096 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[payment_method_options][paypal][description]	Zeichenfolge	Maximal 127 Zeichen	Beschreibung des Postens.
line_items[payment_method_options][paypal][category]	Enum	digital_goods, physical_goods, Spende	Art des Postens.
line_items[payment_method_options][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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=4000 \
  -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[shipping][from_postal_code]"=94110 \
  -d "amount_details[shipping][to_postal_code]"=94117 \
  -d "amount_details[shipping][amount]"=100 \
  -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][discount_amount]"=100 \
  -d "amount_details[line_items][0][quantity]"=1 \
  -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][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: {
    discount_amount: 100,
    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"
}

Das folgende Beispiel zeigt die Übergabe des Top-Level-discount_amount und tax ohne tax auf Postenebene und discount_amount

Beispielantwort

{
  "id": "pi_3R0p2JCvDOElLqwO0mlHFrzv",
  "object": "payment_intent",
  "amount": 2500,
  "amount_capturable": 0,
  "amount_details": {
    "discount_amount": 100,
    "line_items": {
      "object": "list",
      "data": [
        {
          "id": "uli_RueKif6jOR65uG",
          "object": "amount_details_line_item",
          "discount_amount": null,
          "payment_method_options": {
            "klarna": {
              "image_url": "https://www.example.com/image.jpg",
              "product_url": "https://www.example.com/product"
            },
            "paypal": {
              "category": "digital_goods",
              "description": "This is a sample product description unique to PayPal for SKU001"
            }
          },
          "product_code": "SKU001",
          "product_name": "Product 001",
          "quantity": 1,
          "tax": null,
          "unit_cost": 2000
        }
      ],
      "has_more": false,
      "url": "/v1/payment_intents/pi_3R0p2JCvDOElLqwO0mlHFrzv/amount_details_line_items"
    },
    "shipping": {
      "amount": 100,
      "from_postal_code": "94110",
      "to_postal_code": "94117"
    },
    "tax": {
      "total_tax_amount": 500
    },
    "tip": {}
  },
  "amount_received": 0,
  "amount_subtotal": 2500,
  "capture_method": "automatic_async",
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "payment_method": null,
  "payment_method_configuration_details": null,
  "payment_method_options": {
    "card": {
      "installments": null,
      "mandate_options": null,
      "network": null,
      "request_three_d_secure": "automatic"
    },
    "klarna": {
      "preferred_locale": null
    },
    "paypal": {
      "preferred_locale": null,
      "reference": null
    }
  },
  "payment_method_types": ["card", "paypal", "klarna"],
  ...
}

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