ForHosting KIT · Entwickler-Tools

Rechner für Zahlung mit Gutschein und Bargeld

Dieser Rechner für Gutschein und Barzahlung zeigt genau, wie ein Kauf aufgeteilt wird, wenn ein Gutschein einen Teil, den gesamten Betrag oder mehr als den Gesamtbetrag abdeckt.

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

Geben Sie den Kaufbetrag und das derzeit verfügbare Guthaben ein. Der Rechner nutzt davon so viel wie möglich, weist den noch bar zu zahlenden Betrag aus und zeigt das verbleibende Gutscheinguthaben. Das hilft an der Kasse, bei der Planung eines Einkaufs oder wenn Sie einer anderen Person eine geteilte Zahlung erklären möchten.

Geben Sie Kaufbetrag und verfügbares Guthaben ein

Beginnen Sie mit dem vollständigen Kaufbetrag, bevor ein Gutscheinguthaben angerechnet wird. Geben Sie danach das Guthaben ein, das für diese Transaktion tatsächlich verfügbar ist. Beide Werte müssen dieselbe Währung verwenden, denn der Rechner teilt Geldbeträge auf, führt aber keine Währungsumrechnung durch. Tragen Sie übliche Geldwerte mit höchstens zwei Dezimalstellen ein, zum Beispiel 42, 42.50 oder 19.99. Der Kaufbetrag muss größer als null sein. Ein Gutscheinguthaben von null ist dagegen zulässig und bedeutet lediglich, dass der gesamte Kauf bar bezahlt wird. Wurde der Gutschein bereits verwendet, tragen Sie das aktuell verfügbare Guthaben statt des ursprünglichen Nennwerts ein. Steuern, Versandkosten, Rabatte und Trinkgelder sollten im Kaufbetrag enthalten sein, sofern sie zum Endbetrag an der Kasse gehören. Der Rechner entscheidet nicht, ob ein Händler eine Kombination mehrerer Zahlungsarten akzeptiert oder ob eine bestimmte Gebühr mit dem Gutschein bezahlt werden darf. Er beantwortet die Rechenfrage, sobald der fällige Gesamtbetrag und das nutzbare Guthaben feststehen.

So wird die Aufteilung berechnet

Der Rechner setzt zunächst den Gutschein ein, und zwar bis zum kleineren Wert aus Kaufbetrag und verfügbarem Guthaben. Kostet ein Einkauf 80 und enthält der Gutschein 30, werden 30 über den Gutschein und 50 bar bezahlt. Stehen für denselben Einkauf 100 Guthaben bereit, deckt der Gutschein alle 80 ab, es ist keine Barzahlung nötig und 20 verbleiben auf dem Gutschein. Durch diese Regel können weder der verwendete Gutscheinbetrag noch die verbleibende Barzahlung negativ werden. Die Ergebnisse werden in ganzen Cent berechnet, damit typische Gleitkommaartefakte wie die Anzeige 0.30000000000000004 vermieden werden. Der ausgegebene Kaufbetrag dient außerdem als Bezugspunkt neben den drei berechneten Werten. Zur Kontrolle gilt: Gutscheinnutzung und Barzahlung ergeben zusammen stets den Kaufbetrag. Gutscheinnutzung und verbleibendes Guthaben ergeben zusammen immer das Anfangsguthaben. Mit diesen beiden Beziehungen lässt sich das Ergebnis leicht prüfen oder in eine Vorschau des Bezahlvorgangs übernehmen.

Nutzen Sie das Ergebnis an der Kasse oder in Abläufen

Verstehen Sie das Ergebnis als Zahlungsplan und nicht als Freigabe durch den Händler. Der Wert für die Gutscheinnutzung ist der Betrag, der vom Gutschein abgebucht werden soll. Die Barzahlung muss aus Bargeld, einer Debitkarte, einer Kreditkarte oder einem anderen akzeptierten Zahlungsmittel stammen. Das Restguthaben sollte nach einer erfolgreichen Transaktion auf dem Gutschein verfügbar bleiben, sofern keine Reservierungen, Gebühren oder händlerspezifischen Einschränkungen bestehen. Prüfen Sie vor dem Bezahlen, ob das Geschäft einen Gutschein mit einer weiteren Zahlungsart kombinieren lässt und den Gutschein in der erwarteten Reihenfolge anwendet. Für automatisierte Anwendungen senden Sie dieselben zwei Zahlenfelder an die API und speichern die vier zurückgegebenen Beträge bei einem Angebot, Warenkorb oder einer Supportantwort. Jede Anfrage kostet $0.002; die Browserversion können Sie kostenlos verwenden. Da die Berechnung deterministisch und ohne Netzwerkdienst erfolgt, liefern gleiche Eingaben stets gleiche Ergebnisse. Das ist für eine wiederholbare Einkaufsplanung und verlässliche Testfälle besonders nützlich.

Einen Einkauf vor dem Bezahlen planen

Ermitteln Sie, wie viel Bargeld oder Kartenzahlung nach Einsatz des verfügbaren Gutscheinguthabens noch benötigt wird.

Eine geteilte Zahlung erklären

Zeigen Sie Kunden oder Angehörigen eine klare Aufteilung in Gutschein, Barzahlung und verbleibendes Guthaben.

Kassenlogik vorab prüfen

Verwenden Sie das API-Ergebnis beim Testen eines Warenkorbs, Angebots, Erstattungswerkzeugs oder Supportablaufs, der Gutscheine zuerst einsetzt.

Wie bestimmt der Rechner den verwendeten Gutscheinbetrag?

Er verwendet den kleineren Wert aus Kaufbetrag und verfügbarem Guthaben. Dadurch wird weder mehr als der Preis noch mehr als das Guthaben eingesetzt.

Was geschieht, wenn das Guthaben höher als der Kaufbetrag ist?

Der Gutschein deckt den gesamten Kauf ab, die Barzahlung beträgt null und der nicht genutzte Wert erscheint als Restguthaben.

Was geschieht bei einem Gutschein ohne Guthaben?

Ein Guthaben von null wird akzeptiert. Der verwendete Gutscheinbetrag ist null und der gesamte Kaufbetrag wird der Barzahlung zugeordnet.

Kann ich für die beiden Beträge verschiedene Währungen eingeben?

Nein. Beide Beträge müssen dieselbe Währung verwenden. Dieser Rechner teilt eine Zahlung auf und rechnet keine Währungen um.

Ist damit garantiert, dass ein Geschäft die Teilzahlung akzeptiert?

Nein. Die Regeln unterscheiden sich je nach Händler. Erkundigen Sie sich, ob der Gutschein mit Bargeld oder einer anderen Zahlungsart kombiniert werden darf.

Was kostet die Nutzung der API?

Jede API-Anfrage kostet $0.002. Sie können den Rechner außerdem kostenlos in Ihrem Browser verwenden.

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/life/gift-card-split

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/life/gift-card-split \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"purchase_amount":86.4,"gift_card_balance":50}'
{
  "purchase_amount": 86.4,
  "gift_card_balance": 50
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.gift_card_split",
  "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 →