Die Zuschlagsfunktion ermöglicht es Unternehmen, eine geringe Zusatzgebühr auf die Zahlung eines Kunden zu erheben, wenn dieser eine Karte wählt, die aus Compliance-Gründen für einen Zuschlag in Frage kommt. Diese Gebühr, der sogenannte Zuschlag, deckt die Kosten, die dem Unternehmen in Dänemark, Finnland und Norwegen für die Akzeptanz dieser Zahlungsmethode entstehen.

Zahlt ein Kunde beispielsweise mit einer Firmenkreditkarte – deren Bearbeitung für das Unternehmen in der Regel mit höheren Kosten verbunden ist – oder mit Karten aus Nicht-EWR-Ländern, kann das Kassensystem einen kleinen Zuschlag (entsprechend der Gebühr, die der Händler für die Transaktionsabwicklung zahlt) hinzufügen, um diese Kosten zu decken. Welche Karten für einen Zuschlag berechtigt sind und wie dieser verarbeitet und dem Endkunden angezeigt werden muss, ist in den jeweiligen Landesgesetzen und -richtlinien geregelt.

Die REST API unterstützt Zuschläge in einem Modell:

  • Gehostetes Modell (-gesteuerte Bedienoberfläche): Berechtigung, Präsentation und Zustimmung von Zuschlägen werden im  -gehosteten Kartenschritt verarbeitet. Dies wird über gehostete Formulare und die gehostete Zahlungsseite unterstützt.

Diese Seite erklärt die Verwendung von Zuschlägen mit REST und konzentriert sich dabei auf die gesamten Nutzungsabläufe und Verantwortlichkeiten. Detaillierte Felddefinitionen sind in der technischen REST-Spezifikation beschrieben.


Erste Schritte

Aktivierung

So nutzen Sie Zuschläge in REST-Integrationen:

  • Wenden Sie sich an den , um Zuschläge für Ihr Händlerprofil zu aktivieren.

  • Stellen Sie sicher, dass Ihre Händlerkonfiguration kartenbasierte Zuschläge unterstützt.


Integrationsoptionen

Die Zuschläge sind in zwei Integrationstypen verfügbar:

  • Gehostete Formulare (-Bedienoberfläche): Nutzen Sie REST, um einen gehosteten Zahlungsablauf zu erstellen und lassen das das Ergebnis des Zuschlags im Schritt der gehosteten Kartenzahlung anzeigen.

  • Gehostete Zahlungsseite: Nutzen Sie REST, um eine gehostete Zahlungsseite zu initiieren und lassen  die Checkout-Sitzung anzeigen.


Benutzererfahrung im Zahlungsablauf

Szenario 1: Zuschlag wird nicht angeboten (deaktiviert, nicht berechtigt)

  • Die Zahlung erfolgt in der Währung und dem Betrag des Händlers.

  • Es werden keine zuschlags-bezogenen Informationen angezeigt.

Szenario 2: Zuschlag wird angeboten (aktiviert, berechtigt)

 

  • Im Checkout wird der berechnete Gesamtzuschlag als separate, gekennzeichnete Gebühr und der neue Gesamtbetrag (Händlerbetrag plus Zuschlag) angezeigt
  • Der Karteninhaber prüft alle Gebühren vor der Bestätigung
  • Die Zahlung erfolgt in der Händlerwährung, jedoch zu einem höheren Betrag.



Zahlungsausführung mit REST

Gehostetes Modell (-gesteuerte Bedienoberfläche)

Im gehosteten Modell erstellt der Händler einen gehosteten Zahlungsablauf via REST. Wählt der Kunde die Kartenzahlung aus und wird der Kartenschritt vom 

gehostet, führt die Zuschlags-Verarbeitung durch und zeigt das Ergebnis des Zuschlags an (sofern zutreffend).

Endpunkte

  • POST /payments/sessions (gehostete Zahlungssitzung / HPP-Stil)

  • POST /payments mit gehosteter Konfiguration (gehosteter Kartenablauf)


Zahlungsdetails abrufen (Ergebnis & Zuschlags-Ergebnis)

Zahlungsdetails, einschließlich des Zuschlags-Ergebnisses, können abgerufen werden über:

  • GET /payments/getByPayId/{payID}

  • GET /payments/getByTransId/{transID}

Diese Endpunkte liefern den finalen Transaktionsstatus, wie er vom verarbeitet wurde einschließlich Zuschlags-Information, sofern zutreffend.


Verbindlicher Betrag & Währung

Händler müssen die vom zurückgegebenen Werte als verbindlich betrachten.

  • Händler dürfen Wechselkurse nicht selbst berechnen, umrechnen oder anpassen.

  • Für nachfolgende Operationen müssen Händler Betrag und Währung exakt gemäß den Vorgaben der jeweiligen -Schnittstelle angeben.

  • Jede erforderliche Zuschlags-Abwicklung erfolgt intern durch das . Bei der Verarbeitung des anteiligen Zuschlagsbetrags kann das System den neuen Gesamtbetrag (Händlerbetrag zuzüglich Zuschlag) intern berechnen.


Verfügbare Endpunkte

Zahlungen

Zahlungsdetails abrufen