Bei einer Unterzahlung bleibt ein Restbetrag offen; bei einer Überzahlung entsteht ein Überschuss, dessen Verwendung geklärt werden muss. Beides rechtfertigt weder eine improvisierte Erstattung noch die Aufforderung zu einer weiteren vollständigen Zahlung. Prüfen Sie zuerst den tatsächlichen Eingang, ordnen Sie ihn dem Kauf zu und entscheiden Sie getrennt darüber, ob Sie den Auftrag ausführen und wie Sie die Differenz ausgleichen.
Dieser Leitfaden setzt voraus, dass Vermögenswert, Netzwerk und Ziel stimmen. Ist das nicht der Fall, verwenden Sie stattdessen den Leitfaden für Zahlungen im falschen Netzwerk. Hier geht es um Betrag, Zeitpunkt oder Zuordnung eines ansonsten passenden Zahlungseingangs.
Die folgenden Kontrollen sind betriebliche und technische Empfehlungen für Händler, keine Liste automatischer Yolfi-Funktionen. Die Beispiele dienen der Veranschaulichung und beschreiben keine Kundenvorfälle.
Erst den Betrag feststellen, dann die Lösung wählen
Bewahren Sie die ursprüngliche Zahlungsanforderung auf: Bestellreferenz, angeforderte Token-Menge, Netzwerk, Ziel, Berechnungsgrundlage des Angebots und etwaige Ablaufregeln. Vergleichen Sie sie mit unabhängig geprüften Zahlungseingängen, die Ihre Bestätigungsanforderungen erfüllen, nicht mit einem Bildschirmfoto der Kunden-Wallet oder einem geschätzten Guthaben.
Halten Sie drei Beträge getrennt:
- Angeforderter Betrag: der laut Zahlungsanweisung geschuldete Betrag.
- Geprüfte Zahlungseingänge: passende, tatsächlich eingegangene und zur Zuordnung geeignete Übertragungen.
- Ungeklärter Saldo: Fehlbetrag oder Überschuss nach bisherigen Zuordnungen, Gutschriften und Erstattungen.
Ziehen Sie eigene spätere Übertragungskosten nicht vom Zahlungsbetrag des Kunden ab. Trennen Sie Anbietergebühren und Buchungskorrekturen von den Belegen über den tatsächlichen Eingang.
Bei einer Auszahlung von einer Kryptobörse kann weniger ankommen als vom Kunden beabsichtigt, wenn der Dienst eine Gebühr abzieht. Prüfen Sie den Eingang, statt Vermutungen anzustellen. Eine gewöhnliche USDC- oder USDT-Übertragung auf Ethereum bezahlt Ethereum-Gas dagegen nicht durch einen Abzug von USDC oder USDT: Ethereum-Gasgebühren werden in ETH bezahlt. Empfehlen Sie Kunden nicht, für Gas einen geschätzten Stablecoin-Betrag hinzuzufügen.
Vergleichen Sie bei der Implementierung exakte ganzzahlige Basiseinheiten oder exakte Dezimalwerte mit der geprüften Dezimalstellenzahl des Vermögenswerts. Vermeiden Sie Vergleiche mit binären Gleitkommazahlen. Runden Sie einen Fehlbetrag niemals nur deshalb weg, weil die Zahlungsseite weniger Nachkommastellen anzeigt.
Entscheidungstabelle für Betragsabweichungen
Nutzen Sie diese Tabelle als Vorlage für interne Richtlinien. Es handelt sich um betriebliche Einordnungen, nicht um Statuswerte der Yolfi-API.
| Geprüfte Situation | Entscheidung zur Auftragsausführung | Maßnahme zum Betragsausgleich | Kontrolle vor Abschluss |
|---|---|---|---|
| Vollständiger Betrag innerhalb der geltenden Frist eingegangen | Nach Erfüllung der Bestätigungsanforderungen genau einmal ausführen | Eingang der Bestellung zuordnen | Frühere Zuordnungen und Ausführungen prüfen |
| Weniger als angefordert eingegangen | Zurückhalten, sofern kein genehmigter Nachlass gilt | Nachverfolgbare Restzahlungsanforderung, Nachlass oder Erstattung genehmigen | Restbetrag und verantwortliche Person dokumentieren |
| Mehr als angefordert eingegangen | Nur bei erfüllten Annahmeregeln genau einmal ausführen | Überschuss auf Erstattung oder vereinbarte Gutschrift prüfen | Bestellzuordnung vom Überschuss trennen |
| Mehrere Übertragungen erreichen den erforderlichen Gesamtbetrag | Zurückhalten, bis die Zusammenrechnung geprüft und zulässig ist | Jede geeignete Übertragung genau einmal zuordnen | Nicht voraussetzen, dass der Anbieter Zahlungen zusammenfasst |
| Vollständiger Betrag geht nach Ablauf ein | Zeitpunkt, Angebot und Verfügbarkeit der Bestellung prüfen | Nach Richtlinie akzeptieren oder andere Lösung vereinbaren | Verknüpfte Ersatzanforderungen prüfen |
| Ursprüngliche Anforderung und Ersatzanforderung erhalten beide Geld | Niemals zweimal ausführen | Beide Eingänge abgleichen und Überschuss klären | Bestellung gegen doppelte Aktionen sperren |
Benennen Sie für jede Ausnahme eine verantwortliche Person und einen Termin für die nächste Rückmeldung. Ein Eingang darf nicht unzugeordnet bleiben, weil Kundendienst und Finanzabteilung jeweils annehmen, das andere Team kümmere sich darum.
Unterzahlungen: nur einen genehmigten nächsten Schritt anfordern
Angenommen, eine Anforderung lautet auf 100 USDC, der geprüfte Eingang beträgt aber 98 USDC. Es fehlen 2 USDC. Bewahren Sie den ursprünglichen Eingangsbeleg auf; ersetzen Sie ihn nicht stillschweigend durch einen neuen Datensatz über 100.
Wählen Sie eine dokumentierte Lösung:
- Restbetrag einziehen. Prüfen Sie, ob Ihre Integration getrennte Eingänge abgleichen kann. Erstellen Sie eine nachverfolgbare Anforderung über den offenen Betrag, die mit derselben Bestellung verknüpft ist und aktuelle Zahlungsanweisungen enthält.
- Nachlass gewähren. Eine befugte Person dokumentiert den erlassenen Betrag und seine buchhalterische Behandlung. Behaupten Sie nicht, dass ein Händlernachlass die Erkennungsregeln des Anbieters verändert.
- Teilzahlung zurückerstatten. Vereinbaren Sie Erstattungsbedingungen und Ziel, bevor Sie die separate ausgehende Zahlung ausführen.
Laut Yolfis FAQ zu Teilzahlungen werden unvollständige Zahlungen nicht bestätigt; Kunden sollen sich an den Händler wenden. Nachzahlungen an dieselbe Adresse sind demnach nur möglich, wenn das System des Händlers sie unterstützt. Versprechen Sie daher nicht, dass das Senden der Differenz die ursprüngliche Yolfi-Anforderung automatisch abschließt.
Wenn die Verarbeitung aufgeteilter Zahlungen nicht geprüft wurde, ziehen Sie die zuständige Stelle hinzu, bevor Sie den Kunden zu einer weiteren Zahlung auffordern. Wer eine weitere vollständige Zahlung verlangt und die erste Teilzahlung behält, verursacht eine vorhersehbare Überzahlung.
Legen Sie Richtlinien für geringe Fehlbeträge fest, bevor Vorfälle auftreten. Definieren Sie beispielsweise eine Genehmigungsgrenze, zulässige Käufe und eine nachvollziehbare Begründung für die Prüfung. Es gibt keinen allgemeingültigen Toleranzprozentsatz: BTCPay Server dokumentiert seine eigene konfigurierbare Unterzahlungstoleranz. Das belegt jedoch nicht, dass Yolfi dieselbe Einstellung anbietet.
Überzahlungen: Kauf und Überschuss trennen
Ein Kunde schuldet 100 USDT und sendet 105 USDT. Erfüllt die Zahlung ansonsten die Annahmebedingungen, ordnen Sie dem Kauf 100 USDT zu und erfassen 5 USDT als ungeklärten Überschuss. Behandeln Sie die Differenz nicht automatisch als zusätzlichen Umsatz oder Anspruch auf weitere Produkte.
Bitten Sie den Kunden, eine verfügbare, richtlinienkonforme Lösung zu wählen: eine Erstattung oder eine ausdrücklich vereinbarte Gutschrift. Erläutern Sie anfallende Gebühren vor der Vereinbarung und prüfen Sie örtliche Verbraucherschutz- und Rechnungslegungspflichten. Ein kleiner Betrag ist keine Erlaubnis, Geld stillschweigend einzubehalten.
Unterscheiden Sie außerdem zwischen einer zu hohen Übertragung und einer Doppelzahlung. Zwei Übertragungen über jeweils 100 USDT für einen Kauf über 100 USDT sind zwei Eingänge, nicht ein korrigierter Eingang. Bewahren Sie beide Transaktionsdatensätze auf, führen Sie den Auftrag einmal aus und prüfen Sie die zusätzlichen 100 USDT separat.
Verspätete Zahlungen: ein Ablauf klärt nicht den Umgang mit eingegangenem Geld
Erfassen Sie die Frist der Zahlungsanforderung, den Erkennungszeitpunkt der Übertragung und den Bestätigungszeitpunkt getrennt. Eine vor Ablauf erkannte, aber danach bestätigte Zahlung unterscheidet sich von einer Übertragung, die erstmals nach Ablauf des Angebots eingeht. Wenden Sie die dokumentierte Regel an; erfinden Sie keine allgemeingültige Nachfrist.
Prüfen Sie bei verspäteten Eingängen:
- ob der ursprüngliche Preis noch gilt;
- ob Bestand, Kapazität oder Zugang noch verfügbar sind;
- ob eine andere Anforderung dieselbe Bestellung bereits bezahlt hat;
- ob bereits eine Erstattung, Gutschrift oder ein Nachlass genehmigt wurde.
Für eine auf 100 USDC lautende Token-Anforderung und eine auf staatliche Währung lautende, in Krypto umgerechnete Anforderung müssen nicht dieselben Regeln für verspätete Zahlungen gelten. Bewahren Sie das ursprüngliche Angebot auf und legen Sie ein neues Angebot offen, statt historische Preise umzuschreiben.
Ist eine Ersatzanforderung nötig, verknüpfen Sie sie in Ihren Unterlagen mit der ursprünglichen Bestellung und weisen Sie den Kunden darauf hin, nicht beide zu bezahlen. Überwachen Sie den alten Zahlungsversuch weiter. Der Abschluss einer Kundendienstanfrage verhindert nicht, dass eine bereits abgesendete Übertragung später bestätigt wird.
Sicher erstatten, ohne einen zweiten Vorfall zu verursachen
Eine Erstattung ist eine separate ausgehende Zahlung, keine Änderung der eingehenden Übertragung. Yolfis Erläuterung zum nicht-verwahrenden Dienst besagt, dass Zahlungen direkt an die konfigurierte Wallet des Händlers gehen. Gehen Sie nicht davon aus, dass Yolfi ein erstattungsfähiges Guthaben hält oder Überschüsse automatisch zurücksendet.
Vor der Genehmigung einer Erstattung:
- Bestätigen Sie den ursprünglichen Eingang, den Anspruch des Kunden und den noch erstattungsfähigen Betrag.
- Authentifizieren Sie die anfragende Person über den etablierten Kundenkanal.
- Erfragen und prüfen Sie Vermögenswert, Netzwerk und Ziel der vorgesehenen Erstattung. Senden Sie Geld nicht ungeprüft an den Transaktionsabsender zurück; die Adresse könnte einer Kryptobörse oder einem anderen Vermittler gehören.
- Vereinbaren Sie unter Beachtung geltender Pflichten den Bruttoerstattungsbetrag, die Gebührenbehandlung und den erwarteten Nettobetrag.
- Verlangen Sie eine Genehmigung gemäß Ihren Wallet-Sicherheitsrichtlinien; dokumentieren Sie Grund und genehmigende Person.
- Erfassen Sie die Referenz der ausgehenden Transaktion und prüfen Sie deren Ergebnis, bevor Sie die Erstattung als abgeschlossen markieren.
Fragen Sie niemals nach einer Wiederherstellungsphrase oder einem privaten Schlüssel. Läuft beim Absenden einer Erstattung die Wartezeit ab, prüfen Sie den Transaktionsstatus, bevor Sie erneut senden. Eine unklare Antwort beweist nicht, dass keine Zahlung an das Netzwerk übermittelt wurde.
Jede Lösung idempotent ausführen
Idempotenz bedeutet, dass Wiederholungsversuche eine geschäftliche Aktion nicht erneut ausführen können. Stripes Hinweise zu Webhooks dokumentieren doppelte Ereignisse und eine nicht garantierte Reihenfolge bei Stripe. Sie sind eine nützliche technische Referenz, aber keine Aussage über Yolfis Zustellungsgarantien.
Für Ihre eigene Integration:
- Authentifizieren Sie Benachrichtigungen nach dem dokumentierten Prüfverfahren des Anbieters.
- Speichern Sie eingehende Ereignisse dauerhaft und entfernen Sie Duplikate anhand dokumentierter Kennungen.
- Identifizieren Sie jeden Eingang über Netzwerk und Transaktionsreferenz sowie gegebenenfalls einen Übertragungs- oder Ereignisindex, wenn eine Transaktion mehrere relevante Übertragungen enthält.
- Erzwingen Sie durch Datenbankbedingungen oder gleichwertige Transaktionskontrollen eine Zuordnung pro Eingang und eine Ausführung pro Bestellung.
- Reservieren Sie eine genehmigte Erstattungsoperation vor dem Absenden, damit parallel laufende Prozesse sie nicht zweimal senden.
Ein wiederholter Webhook ist keine weitere Zahlung. Eine zweite gültige Übertragung ist ein weiterer Eingang, erlaubt aber dennoch keine zweite Lieferung. Gleichen Sie Ausnahmefälle vor Abschluss sowohl mit Wallet-Belegen als auch mit Geschäftsunterlagen ab.
Häufige Fragen
Sollten wir einen sehr kleinen Fehlbetrag akzeptieren?
Nur auf Grundlage einer genehmigten Händlerrichtlinie. Erfassen Sie den Nachlass separat und prüfen Sie, wie die Zahlung erkannt wird; setzen Sie keine automatische Toleranz voraus.
Sollte eine Überzahlung automatisch eine Erstattung auslösen?
Nicht ohne geprüfte Zuordnung zum berechtigten Kunden, Zieladresse, Betrag und Schutz vor Doppelbearbeitung. Stellen Sie den Überschuss zur Prüfung zurück, sofern ihn nicht ein getesteter, genehmigter Prozess sicher bearbeitet.
Können zwei Teilübertragungen eine Bestellung bezahlen?
Ihre Unterlagen können mehrere Eingänge zuordnen, wenn Ihre Richtlinie das erlaubt. Ob ein Zahlungsanbieter diese gemeinsam erkennt, müssen Sie separat prüfen.
Fazit: den Saldo klären, nicht nur die Anfrage schließen
Beginnen Sie mit einem klaren Yolfi-Zahlungslink und führen Sie neben dem Zahlungsdatensatz ein eigenes Verzeichnis der Händlerausnahmen. Schließen Sie einen Fall erst, wenn Bestellzuordnung, Ausführungsentscheidung, Restsaldo und etwaige Erstattungen oder Gutschriften übereinstimmen. So verhindern Sie, dass aus einer kleinen Betragsabweichung eine zweite Zahlung, eine doppelte Lieferung oder eine unsichere Erstattung wird.
