Die Aufschlagsfunktion 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 Aufschlag in Frage kommt. Diese Gebühr, der sogenannte Aufschlag, 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 Aufschlag (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 Aufschlag 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 Aufschlägen werden im  -gehosteten Kartenschritt verarbeitet. Dies wird über gehostete Formulare und die gehostete Zahlungsseite unterstützt.

Diese Seite erklärt die Verwendung von Aufschlä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 Aufschläge in REST-Integrationen:

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

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


Integrationsoptionen

Die Aufschlä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 Aufschlags 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: Aufschlag wird nicht angeboten (deaktiviert, nicht berechtigt)

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

  • Es werden keine aufschlags-bezogenen Informationen angezeigt.

Szenario 2: Aufschlag wird angeboten (aktiviert, berechtigt)

 

  • Im Checkout wird der berechnete Gesamtaufschlag als separate, gekennzeichnete Gebühr und der neue Gesamtbetrag (Händlerbetrag plus Aufschlag) 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 Aufschlags-Verarbeitung durch und zeigt das Ergebnis des Aufschlags an (sofern zutreffend).

Endpunkte

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

  • POST /payments mit gehosteter Konfiguration (gehosteter Kartenablauf)


Zahlungsdetails abrufen (Ergebnis & Aufschlags-Ergebnis)

Zahlungsdetails, einschließlich des Aufschlags-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 Aufschlags-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 Aufschlags-Abwicklung erfolgt intern durch das . Bei der Verarbeitung des anteiligen Aufschlagsbetrags kann das System den neuen Gesamtbetrag (Händlerbetrag zuzüglich Aufschlag) intern berechnen.


Verfügbare Endpunkte

Zahlungen

Zahlungsdetails abrufen