Zahlungsposten

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

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

Kosteneinsparungen für zugelassene kommerzielle Karten für IC+ Nutzer/innen: Durch die Übermittlung von Zahlungsposten können Sie an dem von den großen Kartennetzwerken verwalteten Programm Level 2/Level 3/Product 3 (L2/L3) teilnehmen. Bei berechtigten kommerziellen Karten können Sie durch die Weitergabe von Postendaten bei der Abwicklungsgebühr sparen.
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-inländische Transaktionen unterstützt (US-Nutzer/innen, die US-ausgestellte Karten akzeptieren, 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 200 Einzelposten. (Die American Express-Spezifikation beschränkt uns darauf, ihnen nur die ersten 4 Posten zu senden.)	Wie bei Karten	Wie bei Karten
Kompatibilität der Funktionen	Sowohl die automatische Erfassung als auch die manuelle Erfassung funktionieren mit Zahlungsposten. Flexible Zahlungsszenarien – mit Ausnahme von Teilautorisierung und Dekrementautorisierungen – funktionieren mit Zahlungsposten für Zahlungen, bei denen Sie Posten übergeben.	Sowohl die automatische Erfassung als auch die manuelle Erfassung funktionieren mit Zahlungsposten.	Sowohl die automatische Erfassung als auch die manuelle Erfassung funktionieren mit Zahlungsposten.
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	Verfügbar für Zahlungen über die PaymentIntents API.	Wie bei Karten	Wie bei Karten

Anspruch auf L2-/L3-Raten

Visa CEDP-Programm

Weitere Informationen zum Commercial Enhanced Data Program (CEDP) von Visa, das das US-Programm ersetzt, finden Sie unter Level 2/3-Austauschprogramme, einschließlich Informationen zu den Netzwerkgebühren, finden Sie im [CEDP-Supportartikel](https://support.stripe.com/questions/understand-the-visa-commercial-enhanced-data-program-(cedp)

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

Die Stripe API lehnt Einzelposten, die die Netzwerk-MCC- und/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	Ebene 3/Produkt 3
Kartentypen	Nur Geschäfts-, Einkaufs- und Firmenkarten sind berechtigt	Nur Einkaufs- und Firmenkarten sind berechtigt
MCCs	Nutzer/innen mit den folgenden MCCs kommen nicht für Stufe 2 in Frage: 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	Nutzer/innen mit den folgenden MCCs haben keinen Anspruch auf Level 3/Produkt 3: Für Mastercard: 5812, 3501-3999, 7011, 3351-3500, 7512, 7513, 7519, 3000-3299, 4511, 4112, 8398, 4468, 5499, 5541, 5542, 5983 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 Mastercard: Die Sales Tax muss zwischen 0,1 % und 30 % liegen, es sei denn, das Unternehmen verwendet eine der folgenden MCCs - 4468, 5541, 5542, 5499, 5983, 7511, 9752, 4111, 4131, 4215, 4784, 8211, 8220, 8398, 8661, 9211, 9222, 9311, 9399 oder 9402. Für Visa: Die Sales Tax muss zwischen 0,1 % und 22 % liegen, es sei denn, das Unternehmen verwendet eine der folgenden MCCs - 4468, 5499, 5541, 5542 oder 5983.	Nicht erforderlich für Tarife für Level 3/Produkt 3. Der Wert 0 ist akzeptabel, wenn keine Verkaufssteuer eingezogen wird, aber ein genauer Wert gemeldet werden muss.

Die folgenden Felder sind erforderlich, um L2- oder L3-Tarife zu erhalten.

Berechtigung für Karten der Tarife L2 oder L3	Level 2	Ebene 3/Produkt 3
Mindestanforderungen an Felder	tax[total_tax_amount] payment_details[order_reference]	line_item[product_name] line_item[unit_cost] line_item[Menge] line_item[tax][total_tax_amount] line_item[product_code] line_item[unit_of_measure] payment_details[order_reference]

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 2).

„Pflichtfeld“ bedeutet, dass ein Feld ausgefüllt werden muss, damit die Stripe-Validierung bestanden wird, wenn Daten zu einem Posten eingegeben werden. „Erforderlich für L2 oder L3“ bedeutet, dass ein Feld ausgefüllt werden muss, um Netzwerk-L2/L3-Tarife zu erhalten.

Allgemein unterstützte Felder

Feldname	Typ	Beschreibung	Format
line_item[product_name]	Zeichenfolge	Der Produktname des Postens.	Erforderliches Feld Erforderlich für L3 Maximale Länge 1024 Zeichen (Karten werden auf 26 alphanumerische Zeichen gekürzt und Paypal auf 127 Zeichen).
line_item[unit_cost]	Ganzzahl	Die Stückkosten des Postens werden in der kleinsten Währungseinheit dargestellt	Erforderliches Feld Erforderlich für L3 Der Wert muss >= 0 sein
line_item[Menge]	Ganzzahl	Die Menge der Artikel.	Erforderliches Feld Erforderlich für L3 Der Wert muss > 0 betragen
line_item[tax][total_tax_amount]	Ganzzahl	Der Gesamtsteuerbetrag für einen einzelnen Posten wird in der kleinsten Währungseinheit dargestellt	Erforderlich für L3 Der Wert muss >= 0 sein Bedingte Validierung ¹
line_item[product_code]	Zeichenfolge	Der Produktcode des Postens, beispielsweise einer SKU	Erforderlich für L3 Maximale Länge: 12 Zeichen
line_item[unit_of_measure]	Zeichenfolge	Eine Mengeneinheit für den Posten, z.  B. Gallonen, Feet, Meter, allgemeine Maßeinheiten (wie Stück) usw.	Erforderlich für L3 Maximale Länge: 12 Zeichen Alphanumerisch
payment_details[order_reference]	Zeichenfolge	Ein einmaliger Wert, der vom Unternehmen zugewiesen wurde, um die Transaktion zu identifizieren.	Erforderlich für L3 Erforderlich für L2 Für Kartennetzwerke: gekürzt auf 25 alphanumerische Zeichen, ohne Leerzeichen Für Klarna: auf 255 Zeichen gekürzt und für Kunden sichtbar, wenn sie die Bestellung in der Klarna-App ansehen
tax[total_tax_amount]	Ganzzahl	Der Gesamtsteuerbetrag für die Transaktion wird in der kleinsten Währungseinheit dargestellt	Erforderlich für L2 Der Wert muss >= 0 sein Bedingte Validierung ¹
payment_details[customer_reference]	Zeichenfolge	Ein eindeutiger Wert zur Identifizierung des Kunden/der Kundin. 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)
shipping[to_postal_code]	Zeichenfolge	Wenn eine physische Ware versendet wird, die Postleitzahl des Ortes, an den sie versendet wird	Maximale Länge 10 Zeichen Alphanumerisch, Bindestriche sind zulässig
shipping[from_postal_code]	Zeichenfolge	Wenn eine physische Ware versendet wird, die Postleitzahl, von der aus sie versendet wird	Maximale Länge 10 Zeichen Alphanumerisch, Bindestriche sind zulässig
shipping[amount]	Ganzzahl	Wenn eine physische Ware versendet wird, werden die Versandkosten in der kleinsten Währungseinheit dargestellt	Der Wert muss >= 0 sein
shipping[to_postal_code]	Ganzzahl	Der auf die Transaktion angewendete Gesamtrabatt wird in der kleinsten Währungseinheit dargestellt	Der Wert muss > 0 betragen Vorbehaltliche Validierung ²
line_item[discount_amount]	Ganzzahl	Der auf diesen Posten angewendete Rabatt wird in der kleinsten Währungseinheit dargestellt	Der Wert muss > 0 betragen Vorbehaltliche Validierung ²

¹ tax[total_tax_amount] und line_item[tax][total_tax_amount] schließen sich gegenseitig aus. Sie können nur eines davon angeben.

² discount_amount und line_item[discount_amount] schließen sich gegenseitig aus. Sie können nur eines davon angeben.

Zusätzliche, von Cards unterstützte Felder

Cards unterstützt die vorangehenden allgemeinen Felder sowie Folgendes:

Feldname	Typ	Beschreibung	Format
line_item[payment_method_options][card][commodity_code]	Zeichenfolge	Kennung, die die Artikel kategorisiert, die nach einem standardisierten Warenschema gekauft werden, wie z. B. UNSPSC, NAICS, NAPCS usw.	Maximale Länge 12 Zeichen. Der Wert muss aus alphanumerischen Zeichen ohne Leerzeichen bestehen.

Zusätzliche von Klarna unterstützte Felder

Klarna unterstützt die vorangehenden allgemeinen Felder sowie Folgendes:

Feldname	Typ	Beschreibung	Format
line_item[payment_method_options][klarna][product_url]	Zeichenfolge	Gültige HTTP- oder HTTPS-URL des Produkts	Maximal 4096 Zeichen.
line_item[payment_method_options][klarna][image_url]	Zeichenfolge	Gültige HTTP- oder HTTPS-URL des Bildes	Maximal 4096 Zeichen.
amount_details[line_items][0][payment_method_options][klarna][reference]	Zeichenfolge	Eindeutige Referenz für diesen Posten, um ihn mit den internen Aufzeichnungen Ihres Systems abzugleichen. Das Feld wird in der Klarna Consumer App angezeigt, wenn es übergeben wird.	Maximal 255 Zeichen.
amount_details[line_items][0][payment_method_options][klarna][subscription_reference]	Zeichenfolge	Beliebige Kennung Ihrer Wahl zur Beschreibung eines Abonnements. Wird in ausgewählten wiederkehrenden Integrationen von Klarna verwendet. Auf Kundenseite ist dies nicht sichtbar.	Maximal 255 Zeichen.

Hinweis

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 vorangehenden allgemeinen Felder sowie Folgendes:

Feldname	Typ	Beschreibung	Format
line_item[payment_method_options][paypal][description]	Zeichenfolge	Beschreibung des Postens.	Maximal 127 Zeichen
line_item[payment_method_options][paypal][category]	Enum	Art des Postens.	digital_goods, physical_goods, Spende
line_item[payment_method_options][paypal][sold_by]	Zeichenfolge	Die Stripe Konto-ID des verbundenen Kontos, das den Artikel verkauft. Lassen Sie das Feld leer, wenn Sie kein verbundenes Konto sind.	Maximal 127 Zeichen

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 2: Verkaufssteuer auf Transaktionen
Level 3/Produkt 3: Aufschlüsselung auf Postenebene wie Produktcode, Menge, Stückkosten

Beispielanfrage (Level-2-Daten)

Beispielantwort (Level-2-Daten)

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

PaymentIntent-Vorgänge

Sie können Posten sowohl bei der Bestätigung als auch bei der Erfassung übermitteln.

Posten bei der Bestätigung festlegen

Sie können Einzelposten bei der Bestätigung unabhängig von der gewählten capture_method festlegen. Wenn Sie Posten bei der Bestätigung übergeben und dann separat erfassen, müssen Sie Posten nicht erneut übergeben.

Posten während der Erfassung festlegen

Wenn Sie bei der Bestätigung keine Einzelposten angeben, können Sie diese bei der Erfassung übergeben.

Hinweis

Wird bei Verwendung von PayPal nicht unterstützt

Ü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.

Hinweis

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

Beispielanfrage (mit zahlungsmethodenspezifischen Posten)

Command Line
Sprache auswählencURL
 No results
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 \
  -d "amount_details[line_items][0][unit_of_measure]"=feet \
  -d "amount_details[line_items][0][payment_method_options][card][commodity_code]"=123123 \
  --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 \
  -d "amount_details[line_items][1][unit_of_measure]"=gallons \
  -d "amount_details[line_items][1][payment_method_options][card][commodity_code]"=123123 \
  --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"

Musterantwort (mit zahlungsmittelspezifischen Posten)

{
  "id": "pi_3OoMm5BLxXjrKOiR3LRyi610",
  "amount": 4000,
  "currency": "usd"
  "amount_details": {
    "shipping": {
      "from_postal_code": "94110",
      "to_postal_code": "94117",
      "amount": 100
    },
    "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": 100,
          "tax": {
            "total_tax_amount": 100
          },
          "unit_of_measure": "feet",
          "payment_method_options": {
            "card": {
              "commodity_code": "123123",
            },
            "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,
          "tax": {
            "total_tax_amount": 100
          },
          "unit_of_measure": "gallons",
          "payment_method_options": {
            "card": {
              "commodity_code": "123123",
            },
            "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"
}

Rabatt und/oder Steuer auf höchster Ebene verwenden

Das folgende Beispiel zeigt die Übergabe der obersten Ebene discount_amount und tax ohne Posten-Ebene tax und discount_amount.

Beispielanfrage (Rabatt und/oder Steuer auf höchster Ebene)

Beispielantwort (Rabatt und/oder Steuer auf höchster Ebene)

{
  "id": "pi_3R0p2JCvDOElLqwO0mlHFrzv",
  "amount": 2500,
  "amount_capturable": 0,
  "amount_received": 2500,
  "payment_details": {
    "customer_reference": "customer_reference",
    "order_reference": "order_reference"
  },
  "amount_details": {
    "discount_amount": 100,
    "shipping": {
      "amount": 100,
      "from_postal_code": "94110",
      "to_postal_code": "94117"
    },
    "tax": {
      "total_tax_amount": 500
    },
    "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"
    }
  }
  ...
}

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

Flexible Zahlungsszenarien

Sie können Zahlungsposten mit komplexen Zahlungen wie Mehrfacherfassungen und Übererfassungen verwenden.