# Kundenguthaben & Wallet für PrestaShop 8 & 9 > Überblick DataFirefly Kundenguthaben ergänzt PrestaShop 8 und 9 um ein Guthaben pro Kunde. Sie schreiben darauf Erstattungen, Rechnungskorrekturen und Kulanzgutschriften gut; der Kunde setzt es im Zahlungsschritt seiner nächsten Bestellungen… - Seite: - Sprache: de - Aktualisiert am: 2026-09-30 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfwallet/index.md), [en](https://www.datafirefly.com/en/documentation/dfwallet/index.md), [es](https://www.datafirefly.com/es/documentation/dfwallet/index.md), [it](https://www.datafirefly.com/it/documentation/dfwallet/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfwallet/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfwallet/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfwallet/index.md) - Index: ## Überblick DataFirefly Kundenguthaben ergänzt PrestaShop 8 und 9 um ein Guthaben pro Kunde. Sie schreiben darauf Erstattungen, Rechnungskorrekturen und Kulanzgutschriften gut; der Kunde setzt es im Zahlungsschritt seiner nächsten Bestellungen ein und kann es selbst aufladen. Das Guthaben wird als Zahlungsart behandelt: Eine teilweise mit Guthaben bezahlte Bestellung behält ihre Summe, ihre Rechnung und ihre MwSt.-Bemessungsgrundlage, und der Guthabenanteil erscheint als Zahlungszeile. ## Installation 1. Klicken Sie unter **Module > Modulverwaltung** auf **Modul hochladen** und ziehen Sie `dfwallet-1.1.1.zip` hinein. 2. Bei der Installation legt das Modul seine Tabellen an, einen Menüpunkt **Kunden > Guthaben**, ein verstecktes virtuelles Produkt `DFWALLET-TOPUP` für Aufladungen, und setzt sich an die erste Stelle der Zahlungsarten. 3. Prüfen Sie unter **Zahlung > Einstellungen**, dass das Modul für Ihre Währungen, Länder und Kundengruppen freigegeben ist. Für ein Update laden Sie einfach die neue ZIP-Datei hoch: Guthaben, Verlauf und Einstellungen bleiben erhalten, die Update-Skripte fügen neue Spalten hinzu. ## Konfiguration ### Zahlung - **Teilnutzung an der Kasse erlauben**: Deckt das Guthaben nicht die ganze Bestellung, kann der Kunde es anrechnen und den Rest mit einer anderen Zahlungsart bezahlen. - **Bestellstatus, wenn das Guthaben die ganze Bestellung bezahlt**: standardmäßig Zahlung akzeptiert. ### Aufladung durch den Kunden - **Vorgeschlagene Beträge**: durch Kommas getrennt, in der Standardwährung. Beispiel: `20,50,100`. - **Freier Betrag**, mit **minimaler** und **maximaler Aufladung**. - **Aufladebonus**: Staffeln im Format `Betrag:Bonus`. Mit `50:5,100:15` schreibt eine Aufladung von 100 € insgesamt 115 € gut. Der Bonus wird bei Zahlung der Aufladung gutgeschrieben und bei Stornierung oder Erstattung zurückgenommen. Die Aufladung wird ohne MwSt. verkauft, da es sich um eine Vorauszahlung handelt. Das Guthaben wird erst gutgeschrieben, wenn die Aufladebestellung einen bezahlten Status erreicht. ### Erstattungen und Stornierungen - **Guthabenanteil zurückbuchen, wenn eine Bestellung storniert wird** und **wenn sie auf Erstattet wechselt**. - **Jede neue Rechnungskorrektur automatisch dem Guthaben gutschreiben**: standardmäßig aus. Lassen Sie es aus, wenn Sie auch per Überweisung oder nativem Gutschein erstatten; Rechnungskorrekturen werden dann einzeln auf der Bestellseite gutgeschrieben. Gutschriften zu einer Bestellung (Rückbuchungen und Erstattungen) sind auf deren Betrag begrenzt: Automatische Rückbuchung und Gutschrift der Rechnungskorrektur derselben Bestellung schreiben nie doppelt gut. ### Verfall von Kulanzgutschriften - **Gültigkeit** in Monaten, 0 für keinen Verfall. Sie gilt für Kulanzgutschriften, Korrekturgutschriften und Aufladeboni. Erstattungen, zurückgebuchte Zahlungen und Aufladungen verfallen nie. - **Erinnerungs-E-Mail vor dem Verfall**: Tage vor dem Datum, 0 für keine Erinnerung. Eine Zahlung verbraucht immer zuerst die Beträge, die zuerst verfallen. ### Cron-Aufgabe Die oben auf der Konfigurationsseite angezeigte, per Token geschützte URL lässt fällige Gutschriften verfallen und versendet die Erinnerungen. Rufen Sie sie einmal täglich auf: ``` 0 6 * * * curl -s "https://ihr-shop.de/module/dfwallet/cron?token=IHR_TOKEN" > /dev/null ``` Ohne Cron läuft dieselbe Verarbeitung höchstens einmal pro Stunde beim Öffnen der Guthabenliste, und abgelaufene Gutschriften eines Kunden werden verarbeitet, sobald sein Guthaben angezeigt wird. ## Guthaben gutschreiben ### Auf der Bestellseite Das Feld **Kundenguthaben** zeigt den Stand, die Bewegungen zur Bestellung, eine Schaltfläche **Dem Guthaben gutschreiben** für jede Rechnungskorrektur und ein Gutschriftformular (Kulanz, Erstattung, Korrektur). Wurde die Bestellung teilweise mit Guthaben bezahlt, bucht eine Schaltfläche diese Zahlung zurück. ### Auf der Kundenseite und in der Liste Die Kundenseite zeigt den Stand und ein Formular für Gutschrift oder Belastung. **Kunden > Guthaben** listet alle Guthaben, mit Schnellgutschrift per E-Mail-Adresse und einer Detailseite pro Kunde. Zu jeder Bewegung können Sie eine **dem Kunden angezeigte Nachricht**, eine **interne Notiz** und für Kulanzgutschriften ein **Gültig-bis-Datum** angeben sowie den **Kunden per E-Mail benachrichtigen**. ### Massengutschriften per CSV Der Block **Kulanzgutschriften in großer Menge** nimmt eine CSV-Datei an, ein Kunde pro Zeile: ``` email;amount;message;valid_until jane@example.com;10;Entschuldigung für die verspätete Lieferung;2027-06-30 ``` Nachricht und Datum sind optional; Datumsangaben als JJJJ-MM-TT oder TT/MM/JJJJ, Beträge mit Komma oder Punkt. Standardnachricht und -gültigkeit gelten für Zeilen ohne Angabe. Jede Zeile hat einen eigenen Schutz vor Dubletten: Wird dieselbe Datei zweimal gesendet, erhält niemand eine doppelte Gutschrift. Ein Bericht nennt gutgeschriebene, bereits importierte und fehlerhafte Zeilen. ## Kundenseite - **Mein Konto > Mein Guthaben**: Stand, bald verfallende Beträge, Aufladung und Verlauf mit Seitenumbruch und Links zu den Bestellungen. - **Warenkorbseite**: Hinweis auf das verfügbare Guthaben. - **Zahlungsschritt**: Deckt das Guthaben die Bestellung, wird Mit meinem Guthaben bezahlen zuerst angeboten. Andernfalls zeigt die Schaltfläche Mein Guthaben verwenden den abgezogenen Betrag und den Rest, danach wählt der Kunde eine andere Zahlungsart. - **Bestellbestätigung**: Hinweis auf den mit Guthaben bezahlten Anteil und den offenen Betrag. Das im Warenkorb angerechnete Guthaben erscheint in der Übersicht als Zeile Guthaben. Entfernt der Kunde sie über das Löschsymbol, wird das Guthaben für diesen Warenkorb nicht mehr verwendet. ## Buchhaltung Bei der Bestellbestätigung wird das verwendete Guthaben als Zahlung der Bestellung erfasst. Warensumme, MwSt. und Rechnung ändern sich nicht. Bei Überweisung oder Scheck nennen die an den Kunden gesendeten Anweisungen den tatsächlich offenen Betrag. Die Guthabenliste zeigt den offenen Gesamtbetrag pro Währung: Bis zur Verwendung ist er eine Verbindlichkeit gegenüber Ihren Kunden. Der Block **Bewegungen exportieren** erzeugt eine CSV-Datei (UTF-8, Semikolon-getrennt) mit einer Zeile pro Bewegung: Datum, Kunde, Vorgang, Betrag, Währung, Stand, Bestellung, Rechnungskorrektur, Gültigkeit, Mitarbeiter, Nachricht und Notiz. ## E-Mails Zwei Vorlagen liegen in 8 Sprachen unter `modules/dfwallet/mails/`: `dfwallet_credit` (Guthaben gutgeschrieben) und `dfwallet_expiry` (Erinnerung vor dem Verfall). Sie werden in der Sprache des Kunden verfasst, einschließlich Beträgen und Datumsangaben. Anpassen können Sie sie unter **International > Übersetzungen > E-Mail-Übersetzungen** oder durch Überschreiben in Ihrem Theme. ## Deinstallation und DSGVO Guthaben und Verlauf bleiben bei der Deinstallation erhalten, da sie eine Verbindlichkeit gegenüber Ihren Kunden sind. Aktivieren Sie **Salden und Verlauf bei der Deinstallation löschen** nur, wenn Sie alles entfernen möchten. Die Bewegungen eines Kunden sind im Datenexport des offiziellen DSGVO-Moduls enthalten. ## Häufige Fragen ### Der Kunde sieht die Zahlungsoption Guthaben nicht Die Option erscheint nur, wenn das Guthaben die ganze Bestellung deckt. Andernfalls wird über den Zahlungsarten die Schaltfläche Mein Guthaben verwenden angezeigt, sofern die Teilnutzung aktiviert ist. Prüfen Sie auch, ob das Modul für Währung, Land und Gruppe des Kunden freigegeben ist. ### Das Guthaben ist bei einer Aufladung nicht nutzbar Das ist gewollt: Ein Warenkorb mit einer Aufladung kann nicht mit Guthaben bezahlt werden. ### Das Feld erscheint für einen Mitarbeiter nicht auf der Bestellseite PrestaShop führt die Hooks eines Moduls nur aus, wenn das Mitarbeiterprofil das Recht Anzeigen für dieses Modul hat. Fügen Sie es unter **Erweiterte Einstellungen > Team > Berechtigungen** hinzu.