# Zuschläge einziehen Gleichen Sie Ihre Kosten für die Kartenabwicklung durch Zuschläge aus. Mit Zuschlägen können Sie einen Teil der Kosten für die Annahme von Kartenzahlungen ausgleichen. Wenn Sie eine Plattform betreiben, die Zahlungsgebühren festlegt und von Ihren verbundenen Konten einzieht, können Ihre verbundenen Konten diese Kosten durch einen Zuschlag ausgleichen. ## Compliance Wenn Sie einen Zuschlag auf Ihre Kartenzahlungen erheben, müssen Sie alle geltenden Gesetze, Vorschriften und Regeln der Kartennetzwerke einhalten. Die Anforderungen für die Erhebung von Zuschlägen variieren je nach Region und Kartentyp und können folgende Verpflichtungen umfassen: - Die zulässigen Zuschlagsbeträge müssen genau berechnet werden, damit diese Beträge die durch geltendes Recht, Kartennetzwerke oder Ihre Akzeptanzkosten (die Sie [ermitteln](https://support.stripe.com/questions/exporting-payment-data) müssen) festgelegten Grenzen nicht überschreiten. - Benachrichtigen Sie Ihren Acquirer (Händlerbank) und/oder das Kartennetzwerk darüber, dass Sie beabsichtigen, einen Aufschlag zu erheben. - Berechnen Sie für alle Kartennetzwerke oder Kartenprodukte einen einheitlichen Aufschlag. - Weisen Sie die/den Karteninhaber/in vor dem Kauf deutlich auf die für jede Transaktion anfallenden Zuschläge sowie auf die Gesamtkosten hin und führen Sie den Zuschlag auf dem Transaktionsbeleg separat aus. - Bieten Sie die Möglichkeit, die Transaktion zu stornieren oder eine andere Zahlungsmethode zu wählen, nachdem die/der Karteninhaber/in über den Zuschlag informiert wurde. Selbst wenn eine Zuschlagsfunktion verfügbar ist, müssen Sie sicherstellen, dass die Erhebung von Zuschlägen zulässig ist und dass der von Ihnen erhobene Zuschlag die durch geltende Gesetze, Vorschriften oder die Kartennetzwerke festgelegten Grenzen nicht überschreitet. Sie sind dafür verantwortlich, alle länderspezifischen oder regionalen Anforderungen oder Einschränkungen (einschließlich aller Anforderungen oder Einschränkungen auf Bundesstaats-, Provinz- oder Territorialebene) zu kennen und einzuhalten. Die Informationen auf dieser Seite bezüglich der Einhaltung dieser Anforderungen dienen lediglich als allgemeine Orientierungshilfe und stellen keine rechtliche, steuerliche, buchhalterische oder sonstige fachliche Beratung dar. Wenden Sie sich an einen Fachmann, wenn Sie sich hinsichtlich Ihrer Verpflichtungen unsicher sind. > Sie sind in vollem Umfang für Bußgelder, Strafzahlungen oder Verluste verantwortlich, die im Zusammenhang mit der Nichteinhaltung der geltenden Anforderungen für Zuschläge entstehen. ## Verfügbarkeit Zuschläge sind in den folgenden Ländern und für die folgenden Zahlungsmethoden verfügbar: | Land | Zulässige Zahlungsmethoden | Maximaler Zuschlagsbetrag | | ---------- | -------------------------- | ------------------------- | | USA | Nur Kreditkarten | 3 % | | Kanada | Nur Kreditkarten | 2,4 % | | Australien | Alle Karten | 4 % | | Neuseeland | Alle Karten | 4 % | ## Before you begin - Ihre Integration muss auf API-Version [2026-03-25.preview](https://docs.stripe.com/changelog.md?channel=preview#2026-03-25.preview) basieren. Sie müssen die [SDKs für die öffentliche Vorschau](https://docs.stripe.com/sdks/versioning.md?#public-preview-release-channel) verwenden oder diese [Stripe-Version](https://docs.stripe.com/api/versioning.md) in Ihrem Anfrage-Header angeben, um auf Vorschaufunktionen zugreifen zu können. - Weitere Informationen finden Sie unter [API-Änderungen](https://docs.stripe.com/payments/cards/surcharge.md#migrate-to-public-preview), wenn Sie sich derzeit in der privaten Vorschau für Zuschläge befinden. ## Verfügbarkeit von Zuschlägen ermitteln Wenn Sie entweder `surcharge.amount` oder `surcharge.enforce_validation` übermitteln und Ihrem [PaymentIntent](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-amount_details-surcharge) eine Zahlungsmethode hinzufügen, enthält die Antwort die folgenden Attribute, anhand derer Sie die Verfügbarkeit von Zuschlägen feststellen können: - `surcharge.status` gibt an, ob Zuschläge je nach Land und Finanzierungsart der Zahlungsmethode verfügbar sind. - Dies gibt `available` oder `unavailable` zurück. - `surcharge.maximum_amount` gibt den maximalen Zuschlagsbetrag an, den Sie angeben können. Bei diesem Wert handelt es sich jedoch um eine technische Beschränkung und nicht um einen von Stripe empfohlenen Betrag. Die durch Gesetze oder Anforderungen der Kartennetzwerke in Ihrer Rechtsordnung festgelegten Obergrenzen für Zuschläge können von `surcharge.maximum_amount` abweichen. Sie sind dafür verantwortlich, sicherzustellen, dass der von Ihnen erhobene Zuschlag diese Obergrenzen nicht überschreitet. - Standardmäßig validiert Stripe den Zuschlag, den Sie auf einen bestimmten `PaymentIntent` anwenden, anhand des maximalen Zuschlagsbetrags. Wenn Sie versuchen, einen Zuschlag über den maximalen Zuschlagsbetrag hinaus zu erheben, wird eine Fehlermeldung angezeigt. ### Deaktivieren Sie die Validierungen des Zuschlagsbetrags - Sie können die Validierung des maximalen Zuschlagsbetrags deaktivieren, indem Sie `enforce_validation: disabled` übergeben. Wenn Sie die Validierung durch die Einstellung `enforce_validation: disabled` deaktivieren, gibt Stripe das Feld `maximum_amount` nicht zurück, und die standardmäßige technische Beschränkung für den Zuschlagsbetrag findet keine Anwendung. - Sie können die Überprüfung des maximalen Zuschlagsbetrags beim Erstellen, Aktualisieren oder Bestätigen eines PaymentIntent deaktivieren. Nachdem Sie die Überprüfung des maximalen Zuschlagsbetrags aktiviert oder deaktiviert haben, können Sie `surcharge.enforce_validation` nicht mehr ändern. - Übergabe von `enforce_validation: disabled` hebt keine anderen Verfügbarkeitsbeschränkungen auf, einschließlich Beschränkungen hinsichtlich der Art der Kartenaufladung und anderer regionaler Beschränkungen. Sie müssen sicherstellen, dass der von Ihnen erhobene Zuschlag allen geltenden Gesetzen und Anforderungen der Kartennetzwerke entspricht, unabhängig davon, ob Sie die Überprüfung des maximalen Zuschlagsbetrags deaktivieren oder nicht. - Sie können auch `enforce_validation: enabled`, um explizit technische Validierungen des maximalen Zuschlagsbetrags zu aktivieren. Danach können Sie `surcharge.enforce_validation` nicht mehr ändern. - Standardmäßig wendet Stripe technische Beschränkungen für den maximalen Zuschlagsbetrag an. Wenn Sie kein Feld in `surcharge.enforce_validation` übergeben, enthält die Antwort den Eintrag `enforce_validation: automatic`, um dieses Verhalten zu kennzeichnen. #### Szenario 1: Validierung aktivieren und `maximum_amount` verwenden Erstellen Sie einen `PaymentIntent` mit aktivierter Validierung, um den Betrag `maximum_amount` zu erhalten: ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d amount=1000 \ -d currency=usd \ -d "payment_method={{PAYMENTMETHOD_ID}}" \ -d "payment_method_types[]=card" \ -d "amount_details[surcharge][enforce_validation]=enabled" ``` ```json { "id": "pi_123", "object": "payment_intent", "amount": 1000, "amount_capturable": 0, "amount_details": { "surcharge": { "enforce_validation": "enabled", "maximum_amount": 24, "status": "available" } }, "status": "requires_confirmation" } ``` #### Szenario 2: Validierung deaktivieren ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d amount=1000 \ -d currency=usd \ -d "payment_method={{PAYMENTMETHOD_ID}}" \ -d "payment_method_types[]=card" \ -d "amount_details[surcharge][enforce_validation]=disabled" ``` Stripe gibt den Wert `maximum_amount` nicht zurück, wenn Sie die Validierung deaktivieren. ```json { "id": "pi_123", "object": "payment_intent", "amount": 1000, "amount_capturable": 0, "amount_details": { "surcharge": { "enforce_validation": "disabled", "status": "available" } }, "status": "requires_confirmation" } ``` ## Zuschlagsbetrag berechnen Sie müssen für jede Transaktion die Höhe der Zuschläge berechnen, die den gesetzlichen, behördlichen und den Anforderungen der Kartennetzwerke entsprechen. Ihre Kosten für die Zahlungsabwicklung variieren je nach Kartenmarke, Einzahlungsart und den verfügbaren Netzwerken. Wenn Stripe den maximalen Zuschlagsbetrag zurückgibt, vergleichen Sie Ihren berechneten Zuschlag stets mit dem im PaymentIntent für die ausgewählte Zahlungsmethode zurückgegebenen Wert `surcharge.maximum_amount`, um Fehler zu vermeiden. Die Vorschriften der Kartennetzwerke und der jeweiligen rechtlichen Zuständigkeitsbereiche bezüglich Zuschlägen können sich im Laufe der Zeit ändern. Stripe behält sich vor, den maximalen Zuschlag anzupassen. Sie sind dafür verantwortlich, den Wert `surcharge.maximum_amount` einzuhalten. Wenn Sie einen Zuschlag anwenden, der den Wert `surcharge.maximum_amount` überschreitet, kann es zu Validierungsfehlern kommen. ## Zahlung mit Zuschlag bestätigen Nachdem Sie den Zuschlag berechnet und dem Kunde bzw. der Kundin mitgeteilt haben, können Sie ihn bei der Bestätigung oder Erfassung des PaymentIntent anwenden. > #### Geben Sie den Gesamtbetrag einschließlich des Zuschlags an > > Stripe berechnet nur den Betrag im übergeordneten Feld `amount` und erhöht diesen nicht um zusätzliche Werte. Daher müssen Sie den Gesamtbetrag einschließlich des Zuschlags im Feld `amount` angeben. Bei einer Zwischensumme von 10,00 USD mit einem Zuschlag von 0,20 USD würden Sie beispielsweise 10,20 USD im übergeordneten Feld `amount` übergeben. Der Zuschlag in Höhe von 0,20 USD würde separat in `amount_details[surcharge][amount]` angegeben werden. ```curl curl https://api.stripe.com/v1/payment_intents/{{PAYMENTINTENT_ID}}/confirm \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d amount_to_confirm=1020 \ -d "amount_details[surcharge][enforce_validation]=enabled" \ -d "amount_details[surcharge][amount]=20" ``` ```json { "id": "pi_123", "object": "payment_intent", "amount": 1020, "amount_capturable": 1020, "amount_details": { "surcharge": { "enforce_validation": "enabled", "amount": 20, "maximum_amount": 24, "status": "available" } }, "status": "requires_capture" } ``` ## Zuschlag beim Erstellen eines PaymentIntent anwenden Geben Sie beim Erstellen eines PaymentIntent das übergeordnete Feld `amount` inklusive des Zuschlagbetrags an: ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d amount=1020 \ -d currency=usd \ -d "payment_method={{PAYMENTMETHOD_ID}}" \ -d "payment_method_types[]=card" \ -d "amount_details[surcharge][enforce_validation]=enabled" \ -d "amount_details[surcharge][amount]=20" ``` ## Wenden Sie bei der Erfassung einen Zuschlag an Sie können den Zuschlag auch bei der Erfassung anwenden. Sie können dieses Verhalten in verschiedenen Szenarien anwenden: - **Zuschlag nach Bestätigung anpassen**: Wenn Sie den Zuschlagsbetrag nach Bestätigung ändern müssen, können Sie ihn nur reduzieren. Sie können den Zuschlagsbetrag während der Erfassung nicht erhöhen. - **Szenarien mit mehreren Erfassungen**: Wenn Sie mehrere Erfassungen für einen einzelnen PaymentIntent durchführen, können Sie für jede einzelne Erfassung einen Zuschlag festlegen. Die Summe aller bei der Mehrfacherfassung übergebenen Zuschläge darf den bei der Bestätigung übergebenen Zuschlag nicht übersteigen. ```curl curl https://api.stripe.com/v1/payment_intents/{{PAYMENTINTENT_ID}}/capture \ -u "<>:" \ -H "Stripe-Version: 2026-03-25.preview" \ -d amount_to_capture=1020 \ -d "amount_details[surcharge][enforce_validation]=enabled" \ -d "amount_details[surcharge][amount]=20" ``` ## Rückerstattungen Sie müssen eine Logik implementieren, um einer Kundin bzw. einem Kunden bei einer Rückerstattung die Zuschläge zurückzuerstatten. Die Regeln der Kartennetzwerke sowie bestimmte Gesetze und Vorschriften verlangen, dass Sie bei einer vollständigen Rückerstattung den gesamten Zuschlag zurückerstatten und bei einer teilweisen Rückerstattung einen anteiligen Zuschlagsbetrag. Nehmen wir beispielsweise an, eine Kundin bzw. ein Kunde gibt einen Artikel im Wert von 60,00 USD aus einer Gesamtbestellung von 100,00 USD zurück, auf die Sie einen Zuschlag von 1,50 USD erhoben haben. Um einen anteiligen Zuschlag zu erstatten, müssen Sie 60,90 USD erstatten (60,00 USD zuzüglich 60/100 des Aufschlags von 1,50 USD). ## Belege In den vorgefertigten Belegen von Stripe wird der Zuschlag automatisch angezeigt. Wenn Sie eigene Belege erstellen, geben Sie den angewendeten Aufschlag separat an. Beispiel: Bei einem Kaufbetrag von insgesamt 10,20 USD, auf den Sie einen Zuschlag von 0,20 USD erhoben haben, müssen Sie 10,00 und 0,20 als separate Posten auf dem Beleg ausweisen. Überprüfen Sie den Wert `amount_details.surcharge.amount` im PaymentIntent, um den angewandten Zuschlag anzuzeigen. ## Berichterstattung Das Feld `amount_details_surcharge_amount` steht Ihnen in der Sigma-Tabelle `payment_intents` zur Verfügung. Dieses Feld gibt den Zuschlag an, der auf die Transaktion erhoben wird, die Sie an das Kartennetzwerk senden. ## Interoperabilität von Funktionen - Sie können Zuschläge bei [Zahlungsposten](https://docs.stripe.com/payments/payment-line-items/flexible-payment-scenarios.md#add-a-surcharge) verwenden. - Sie können Zuschläge mit [Mehrfacherfassung](https://docs.stripe.com/payments/multicapture.md) verwenden und bei jeder Erfassung unterschiedliche Zuschlagsbeträge angeben. - Sie können keinen Zuschlagsbetrag erfassen, der höher ist als der bei der Bestätigung übermittelte Betrag. - Die Summe aller bei der Mehrfacherfassung übermittelten Zuschlagsbeträge darf den bei der Bestätigung übermittelten Zuschlagsbetrag nicht überschreiten. - Wenn Sie die Zuschlagsfunktion mit [inkrementeller Autorisierung](https://docs.stripe.com/payments/incremental-authorization.md) nutzen, können Sie den Zuschlagsbetrag über den PaymentIntent-Erfassungs-Endpoint verringern, falls Sie einen geringeren Betrag einziehen als autorisiert. Sie können den Zuschlagsbetrag jedoch nicht erhöhen, unabhängig davon, um wie viel er während der inkrementellen Autorisierung erhöht wurde. - Bei der automatischen Erfassung mit teilweisen Autorisierungen ist die Erhebung von Zuschlägen nicht möglich. ## Migration von Änderungen der Private Preview API Falls Sie derzeit die private Vorschauversion der Zuschlagsfunktion nutzen, finden Sie hier die wichtigsten Änderungen, die Sie vornehmen müssen, um auf das Verhalten der öffentlichen Vorschauversion zugreifen zu können: | Private Vorschau | Öffentliche Vorschau | | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | | `amount_surcharge` (übergeordnete Ebene) | `amount_details[surcharge][amount]` | | Stripe erhöht den `amount` automatisch | Sie geben den `amount` inklusive Zuschlag an | | Betragsvalidierung wird immer erzwungen | `amount_details[surcharge][enforce_validation]` | | Zuschlag nur für `/update` und `/confirm` | Zuschlag ist verfügbar für `/create`, `/update`, `/confirm` und `/capture` | | Der im Hash `payment_method_options` zurückgegebene Wert für `maximum_amount` und `status` | Der im Hash `payment_method_options` zurückgegebene Wert für `maximum_amount` und `status` |