Zum Hauptinhalt springen
Mit der Wallet-Aufladung können Kunden ihr Guthaben gezielt auffüllen — entweder manuell über die Web-App oder automatisch per Regel, wenn das Guthaben unter einen bestimmten Schwellenwert fällt.

​
Manuelle Aufladung

Eine manuelle Aufladung startet einen Zahlungsvorgang, der den gewünschten Betrag vom Kunden einzieht und als Guthaben verbucht.
1

Kundendetails öffnen

Navigiere zu Kunden und wähle den gewünschten Kunden aus.
2

Debitorenkonto-Tab öffnen

Klicke auf den Tab Debitorenkonto in der Kundendetailansicht.
3

Aufladen klicken

Klicke auf den Button Aufladen in der Wallet-Guthaben-Karte.
4

Betrag eingeben

Gib den gewünschten Aufladebetrag ein. Optional kannst du eine bestimmte Zahlungsmethode auswählen — andernfalls wird die Standard-Zahlungsmethode des Kunden verwendet.
5

Aufladung bestätigen

Klicke auf Aufladen. Fynn erstellt einen Zahlungsvorgang (PaymentIntent), der den Betrag einzieht.

​
Status einer Aufladung

Jede Aufladung durchläuft einen Zahlungsstatus:
StatusBeschreibungBadge
AusstehendZahlung wurde gestartet, aber noch nicht abgeschlossenGelb
AbgeschlossenZahlung war erfolgreich, Guthaben wurde gutgeschriebenGrün
FehlgeschlagenZahlung konnte nicht eingezogen werdenRot
Nach einer erfolgreichen Aufladung wird das Guthaben sofort verfügbar und kann automatisch auf offene Rechnungen angerechnet werden, sofern die automatische Anrechnung aktiviert ist.

​
Aufladungshistorie

Im Debitorenkonto-Tab findest du die Karte Aufladungen mit einer Übersicht aller bisherigen Aufladungen — inklusive angefordertem Betrag, gutgeschriebenem Betrag und Status.

​
Automatische Aufladung

Mit automatischen Aufladungsregeln lässt sich das Guthaben eines Kunden automatisch auffüllen, wenn es unter einen definierten Schwellenwert fällt.

​
Regel erstellen

1

Debitorenkonto öffnen

Navigiere zum Tab Debitorenkonto des gewünschten Kunden.
2

Regel hinzufügen

Klicke in der Karte Automatische Aufladung auf Regel hinzufügen.
3

Parameter konfigurieren

Konfiguriere die Regel:
ParameterBeschreibung
WährungDie Währung, für die die Regel gilt (z.B. EUR)
SchwellenwertWenn das Guthaben unter diesen Betrag fällt, wird aufgeladen
AufladebetragDer Betrag, der automatisch aufgeladen wird
ZahlungsmethodeOptional: Spezifische Zahlungsmethode (Standard: Standard-Zahlungsmethode des Kunden)
4

Regel speichern

Klicke auf Erstellen. Die Regel ist sofort aktiv.
Pro Kunde und Währung kann jeweils nur eine automatische Aufladungsregel existieren.

​
Wie funktioniert die automatische Aufladung?

  1. Trigger: Bei jeder Guthaben-Abbuchung (z.B. Anrechnung auf eine Rechnung) prüft Fynn, ob das Guthaben unter den Schwellenwert gefallen ist
  2. Aufladung starten: Falls ja, wird automatisch eine Aufladung über den konfigurierten Betrag gestartet
  3. Zahlung einziehen: Der Betrag wird über die konfigurierte (oder Standard-) Zahlungsmethode eingezogen
  4. Guthaben gutschreiben: Nach erfolgreicher Zahlung wird das Guthaben aufgeladen
Beispiel:
- Schwellenwert: 10,00 €
- Aufladebetrag: 100,00 €
- Aktuelles Guthaben: 50,00 €
- Neue Rechnung: 45,00 € (Guthaben wird angerechnet)
- Guthaben danach: 5,00 € → unter Schwellenwert!
- Automatische Aufladung: 100,00 € wird eingezogen
- Guthaben nach Aufladung: 105,00 €

​
Regeln verwalten

In der Karte Automatische Aufladung kannst du bestehende Regeln:
  • Aktivieren/Deaktivieren: Regel vorübergehend ein- oder ausschalten
  • Bearbeiten: Schwellenwert, Betrag oder Zahlungsmethode ändern
  • Löschen: Regel dauerhaft entfernen

​
Sicherheitsmechanismen

Fynn schützt vor ungewollten Mehrfach-Aufladungen:
  • Aufladung durch Aufladung wird nicht getriggert: Eine Guthaben-Aufladung (Top-Up) löst keine erneute Schwellenwert-Prüfung aus
  • Fehlerzähler: Nach aufeinanderfolgenden fehlgeschlagenen Aufladungen wird eine Warnung angezeigt. So erkennst du frühzeitig, wenn eine Zahlungsmethode nicht mehr funktioniert
  • Feature-Flag: Die Wallet-Aufladung muss für deinen Account aktiviert sein
Wenn die Zahlungsmethode eines Kunden nicht mehr gültig ist (z.B. abgelaufene Kreditkarte), schlägt die automatische Aufladung fehl. Prüfe regelmäßig Regeln mit Fehlerwarnungen.

​
Häufige Fragen

Ja. Neben der Aufladung per Zahlungseinzug kannst du auch manuell Guthaben hinzufügen — z.B. über eine Gutschrift oder manuelle Buchung. Die Aufladung unterscheidet sich dadurch, dass sie automatisch eine Zahlung vom Kunden einzieht.
Die Aufladung wird als Fehlgeschlagen markiert. Das Guthaben bleibt unverändert. Bei automatischen Aufladungen wird der Fehlerzähler erhöht, und bei der nächsten Guthaben-Abbuchung wird erneut versucht aufzuladen.
Ja. Du kannst pro Währung eine automatische Aufladungsregel erstellen. So lassen sich z.B. EUR- und USD-Guthaben mit unterschiedlichen Schwellenwerten verwalten.
Die Aufladung wird sofort ausgelöst, sobald das Guthaben unter den Schwellenwert fällt. Die tatsächliche Gutschrift erfolgt, sobald die Zahlung erfolgreich eingezogen wurde.
Ja. Du kannst eine Regel deaktivieren, ohne sie zu löschen. Die Regel bleibt gespeichert und kann jederzeit wieder aktiviert werden.