Währungsgebühren in QryptoPay
QryptoPay kann zur Bestellsumme eine eigene Gebühr für die Zahlung in jeder Kryptowährung hinzufügen — einen Prozentsatz der Summe mit optionaler unterer und oberer Schwelle. Die Einstellung gilt für das gesamte Modul: Sie aktivieren den zentralen Schalter und legen den Prozentsatz für die benötigten Währungen fest — die Gebühr gilt dann für neue Zahlungen.
ℹ️ Warum das wichtig ist
Das Geld des Kunden landet nicht immer sofort in Ihrem endgültigen Wallet — in manchen Netzwerken kostet das Einsammeln der eingegangenen Mittel eine Netzwerkgebühr. Die zusätzliche Gebühr hilft, diese Kosten auszugleichen. Außerdem können Sie damit den Zahlungsfluss gezielt zu den Währungen lenken, die für Sie interessant sind, ohne die übrigen komplett zu deaktivieren.
Drei Wege, diese Kosten zu verteilen
Wie Sie die Überweisungskosten ausgleichen, entscheiden Sie selbst — es gibt drei Möglichkeiten:
- Auf eigene Kosten. Der Preis im Shop ändert sich nicht, und die Überweisungskosten werden jedes Mal von Ihrem Wallet abgezogen. Sie sind nicht konstant — sie hängen davon ab, welche Währung der Kunde wählt.
- In den Shop-Preis einkalkulieren. Sie erhöhen den Preis des Artikels selbst um eine durchschnittliche Schätzung der Kosten. Das ist ein einheitlicher Ansatz für alle Währungen: Der Shop übergibt QryptoPay den endgültigen Zahlungsbetrag, und die konkrete Währung wählt der Kunde erst beim Bezahlen. Einfach und vorhersehbar, aber die tatsächlichen Überweisungskosten unterscheiden sich je Währung, der Preis aber nicht.
- Die Berechnung an QryptoPay übergeben — die Variante aus diesem Artikel. Nur hier lässt sich für jede Währung eine eigene Gebühr festlegen und so der Zahlungsfluss steuern: eine höhere Gebühr für Währungen, die für Sie ungünstig sind, und eine niedrige oder keine Gebühr für die, die sich lohnen. Die Gebühr wird der Summe erst im letzten Zahlungsschritt hinzugefügt und ist für den Kunden nur dort sichtbar — nicht im Preis des Artikels.
Die ersten beiden Varianten unterscheidet QryptoPay nicht — aus seiner Sicht ist das schlicht «Gebühr deaktiviert». Der Unterschied liegt nur darin, wie Sie den Preis in Ihrem Shop bilden.
Wie die Gebühr berechnet wird
Die Gebühr ist ein Prozentsatz der Bestellsumme. Bei kleinen Zahlungen reicht ein Prozentsatz allein aber oft nicht aus, um die Netzwerkkosten sicher zu decken — dafür gibt es die untere Schwelle: den Mindestbetrag der Gebühr in USD. Bei großen Zahlungen gilt die umgekehrte Logik: Die obere Schwelle begrenzt die Gebühr nach oben, damit der Kauf für den Kunden lohnend bleibt. Beachten Sie: In manchen Netzwerken ist die Überweisungsgebühr fix und hängt nicht von der überwiesenen Summe ab. Jede der beiden Schwellen kann auch unausgefüllt bleiben — dann gibt es von dieser Seite keine Begrenzung.
💡 Vorsicht mit den Schwellen
Eine zu hohe oder zu niedrige Schwelle kann den Kunden bei der Zahlung verwirren. Zum Beispiel liegt bei einer Bestellung über 10 USD, einer Gebühr von 2 % und einer unteren Schwelle von 5 USD die endgültige Gebühr bei 5 USD, nicht bei 0,20 USD — die Schwelle hat gegriffen. Schätzen Sie die Schwellen vorab anhand eines für Ihren Shop typischen Bestellbetrags ab. Oder legen Sie auf Shop-Ebene einen Mindestbetrag für Zahlungen in Kryptowährung fest.
ℹ️ Die Gebühr gilt pro Währung, nicht pro Netzwerk oder Merchant
USDT im Ethereum-Netzwerk und USDT im Tron-Netzwerk erhalten dieselbe Gebühr — getrennt einstellen lässt sich das nicht. Die Einstellung gilt zudem für das gesamte Modul: Haben Sie mehrere Merchants, wirkt die Gebühr für alle gleich, separate Einstellungen je Merchant gibt es nicht.
Die Gebühr wird einmalig festgelegt — in dem Moment, in dem dem Kunden die Rechnung gestellt wird. Ändern Sie den Prozentsatz oder die Schwellen später, bleiben bereits gestellte Rechnungen davon unberührt — die neuen Werte gelten erst für die nächsten Zahlungen.
Was der Kunde sieht
Der auf der Zahlungsseite zu zahlende Betrag enthält die Gebühr bereits — Sie müssen sie nicht separat hinzufügen. Die Höhe der Gebühr ist bei jeder Zahlungsmethode und neben der Bestellsumme angegeben, sodass der Kunde die Währungen selbst vergleichen und die mit der niedrigeren Gebühr wählen kann.
Was der Shop erhält
In der Zahlungsbenachrichtigung wird die Gebühr getrennt von der Bestellsumme ausgewiesen, sodass Sie immer wissen, wie viel der Kunde bezahlt hat, wie viel davon einbehalten wurde und wie viel Ihnen bleibt.
⚠️ Überprüfen Sie Ihren Zahlungsabgleich
Vergleicht Ihre Integration den Zahlungsbetrag mit der Bestellsumme, verändert das Aktivieren der Gebühr diesen Abgleich: Der Zahlungsbetrag wird um die Höhe der Gebühr größer als die Bestellsumme. Gleichen Sie anhand der neuen Felder der Benachrichtigung ab, nicht nur anhand der ursprünglichen Summe.
So richten Sie den Shop ein
Damit der Shop Gebühren korrekt verarbeitet, müssen Sie die Bestellung mit dem Betrag abgleichen, der tatsächlich beim Shop angekommen ist, nicht mit dem vollen Betrag, der vom Kunden eingegangen ist. Nachfolgend ein Ausschnitt aus der Zahlungsbenachrichtigung — nur die dafür nötigen Felder (Bestellung über 49 USD, Gebühr 5 USD):
{
"payment_result": "success", // Zahlungsergebnis
"amount_fiat": "54.00", // Gesamtbetrag vom Kunden: Bestellung und Gebühr
"surcharge_fiat": "5.00", // einbehaltene Gebühr
"amount_fiat_net": "49.00" // verbleibt dem Shop — gleichen Sie die Bestellung mit diesem Betrag ab
}Der erste Wert entspricht immer der Summe der beiden anderen: amount_fiat = amount_fiat_net + surcharge_fiat.
Beide Gebührenfelder werden immer übertragen, auch wenn die Gebühr deaktiviert ist: In diesem Fall ist surcharge_fiat gleich 0.00, und amount_fiat_net entspricht amount_fiat. Dadurch funktionieren bereits implementierte Integrationen weiter, und Sie können schon vorher auf die neuen Felder umsteigen — bevor Sie die Gebühr aktivieren.
Dies ist nur ein Ausschnitt: Den vollständigen Aufbau der Benachrichtigung und die Prüfung dazu finden Sie in der Anleitung zur Einrichtung von QryptoPay.
Nur erfolgreiche Zahlungen automatisieren
Die Benachrichtigung enthält eine Ergebniskennzeichnung: Die Zahlung ist regulär eingegangen, ein falscher Betrag ist eingegangen, oder es gab überhaupt keine gestellte Rechnung zu dieser Zahlung (Näheres zu jedem Fall in der Anleitung zur Einrichtung von QryptoPay). Das wirkt sich auch auf die Gebühr aus: Genau berechnen lässt sie sich nur für eine reguläre Zahlung, die beiden anderen Fälle klärt man sicherer von Hand — eine Nachzahlung, eine Rückerstattung oder die Entscheidung, es so zu lassen.
Bitcoin und Litecoin — die Kosten entstehen anders
Bei Bitcoin und Litecoin kostet die Annahme der Zahlung selbst nichts — das Geld landet sofort bei Ihnen, eine separate Überweisung von der Adresse des Kunden gibt es nicht. Die Kosten entstehen erst später, beim Abheben der angesammelten Gelder: Das Netzwerk fasst zuvor erhaltene Zahlungen in einer Transaktion zusammen, und die Kosten dieser Transaktion steigen mit der Anzahl der zusammengefassten Zahlungen, nicht mit ihrer Summe.
Die Abhebungskosten in diesen Währungen hängen also davon ab, wie viele Zahlungen Sie angenommen haben, nicht von deren Höhe. Eine aktivierte Gebühr für Bitcoin oder Litecoin spiegelt diese Kosten nicht direkt wider — wie bei jeder anderen Währung ist das Ihre eigene Entscheidung und keine Neuberechnung der tatsächlichen Kosten.
Gebühren aktivieren
Die Gebühren werden im Bereich QryptoPay → «Einstellungen» → «Währungen», im Block «Gebühren» konfiguriert: Der zentrale Schalter aktiviert oder deaktiviert die Gebühr für das gesamte Modul, und ein Klick auf eine Währung öffnet den Prozentsatz und beide Schwellen für sie einzeln.
💡 Standardmäßig keine Gebühr
Solange Sie keinen Prozentsatz festlegen, ist die Gebühr für eine Währung null — das Aktivieren des zentralen Schalters allein ändert nichts an den Kosten der Zahlungen.