ForHosting KIT · Entwickler-Tools

Rechner für feste und prozentuale Bearbeitungsgebühren

Der Rechner verbindet einen festen Bearbeitungsbetrag mit einem Prozentsatz der Bestellzwischensumme und zeigt anschließend die vollständige Gebühr sowie den Zahlbetrag.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Er eignet sich, wenn Verpackung, Verwaltung, Sonderbearbeitung oder Auftragsabwicklung nicht durch nur eine Gebührenart gedeckt werden können. Geben Sie die Zwischensumme und eine oder beide Gebührenkomponenten ein. Sie erhalten eine transparente Aufschlüsselung mit auf zwei Dezimalstellen gerundeten Geldbeträgen für Shop, Angebot, Rechnung oder Bezahlvorgang.

Geben Sie Zwischensumme und Gebührenanteile ein

Beginnen Sie mit der Bestellzwischensumme vor der Bearbeitungsgebühr. Sie sollte dem Waren- oder Dienstleistungsbetrag entsprechen, auf den Ihre Richtlinie den prozentualen Anteil anwendet. Rechnen Sie die Gebühr selbst nicht ein, da sonst eine unerwünschte Aufzinsung entsteht. Tragen Sie danach den festen Betrag ein, der etwa Verpackung, Unterlagen, Kommissionierung oder einen anderen gleichbleibenden Aufwand abdecken kann. Geben Sie den Prozentsatz als Prozentwert und nicht als Dezimalbruch an: Verwenden Sie 4.5 für viereinhalb Prozent, nicht 0.045. Beide Komponenten dürfen null sein, sodass auch rein feste oder rein prozentuale Modelle möglich sind. Sämtliche Eingaben müssen mindestens null sein; der Prozentsatz ist auf 100 begrenzt. Getrennte Werte erleichtern die Erläuterung gegenüber Kunden, den Abgleich mit der Shop-Konfiguration und verhindern, dass der feste Betrag versehentlich Teil der Prozentbasis wird.

Verstehen Sie Berechnung und Rundung

Zuerst multipliziert der Rechner die Zwischensumme mit dem durch 100 geteilten Prozentsatz. Dieser Anteil wird auf zwei Dezimalstellen gerundet, wie es bei Checkout-Beträgen üblich ist. Anschließend wird die feste Gebühr addiert und die gesamte Bearbeitungsgebühr erneut gerundet. Die endgültige Bestellsumme ergibt sich aus ursprünglicher Zwischensumme plus Gesamtgebühr. Die Ausgabe enthält die normalisierte Zwischensumme, den Festbetrag, den Prozentsatz, den berechneten Prozentanteil, die Bearbeitungsgebühr und den Endbetrag. Dadurch kann eine Integration eine einzige Gebührenposition anzeigen und dennoch ausreichend Einzelheiten für Tests und Abstimmungen speichern. Steuern, Versand, Rabatte, Trinkgelder, Zahlungsentgelte und Währungsumrechnungen sind nicht enthalten. Wenden Sie diese Posten separat und entsprechend der Reihenfolge sowie den rechtlichen Vorgaben Ihres Systems an.

Setzen Sie das Ergebnis sicher im Checkout ein

Verwenden Sie den Rechner als deterministischen Schritt, nachdem Sie die maßgebliche Zwischensumme bestimmt haben und bevor Sie die endgültige Zahlungsübersicht anzeigen. Ein Shop kann ihn bei Warenkorbänderungen aufrufen, der Betrieb kann ein geplantes Gebührenmodell prüfen und die Buchhaltung kann erwartete Beträge mit abgeschlossenen Bestellungen vergleichen. Da weder Netzwerk, gespeicherter Zustand, Zufall noch Tagesdatum verwendet werden, liefern gleiche Eingaben stets dasselbe Ergebnis. Bewahren Sie Eingaben und Aufschlüsselung gemeinsam auf, wenn Sie eine frühere Gebühr später erklären müssen. Prüfen Sie vor der Einführung, in welcher Reihenfolge Ihre Plattform Rabatte, Versand, Steuern und Gebühren behandelt; der Rechner arbeitet ausschließlich mit Ihrer Eingabe. Zeigen Sie die Gebühr vor der Zahlungsbestätigung verständlich an. Die API kostet $0.002 je Anfrage; im Browser läuft dieselbe reine Berechnung ohne Übertragung an Dritte.

Shop-Checkout konfigurieren

Berechnen Sie die kombinierte Gebühr für ein Modell aus Festbetrag und Prozentsatz.

Gebührenmodell testen

Vergleichen Sie Gebühren für typische Zwischensummen vor der Veröffentlichung.

Abgeschlossene Bestellungen abstimmen

Berechnen Sie den Sollbetrag aus gespeicherten Eingaben und vergleichen Sie ihn mit der Bestellung.

Welche Zwischensumme soll ich eingeben?

Nutzen Sie die laut Ihrer Richtlinie maßgebliche Prozentbasis vor dieser Gebühr. Ob Rabatte, Versand oder Steuern dazugehören, bestimmt Ihr Checkout.

Kann ich nur eine feste Gebühr berechnen?

Ja. Setzen Sie percentage_fee auf null oder lassen Sie das Feld weg; der Aufschlag entspricht dann dem Festbetrag.

Wie werden Bruchteile eines Cents behandelt?

Der Prozentanteil wird vor der Addition des Festbetrags auf zwei Dezimalstellen gerundet. Auch Gebühr und Endsumme werden gerundet.

Sind Steuern oder Versand enthalten?

Nein. Berechnet wird nur die Bearbeitungsgebühr aus Ihrer Zwischensumme; weitere Anpassungen erfolgen separat.

Was kostet die API?

Die API kostet $0.002 je Anfrage. Die Browserversion führt dieselbe deterministische Berechnung lokal aus.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/ecom/handling-fee

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/ecom/handling-fee \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subtotal":125.5}'
{
  "subtotal": 125.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.handling_fee",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →