# Anzahlung: Anzahlung bei Bestellung und Restzahlung bei Lieferung > Installation Installieren Sie das Modul über Module > Modulmanager > Modul hochladen, indem Sie die ZIP-Datei senden, oder kopieren Sie den Ordner dfdeposit in das Verzeichnis /modules/ Ihres Shops und… - Seite: - Sprache: de - Aktualisiert am: 2026-10-07 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfdeposit/index.md), [en](https://www.datafirefly.com/en/documentation/dfdeposit/index.md), [es](https://www.datafirefly.com/es/documentation/dfdeposit/index.md), [it](https://www.datafirefly.com/it/documentation/dfdeposit/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdeposit/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdeposit/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdeposit/index.md) - Index: ## Installation Installieren Sie das Modul über **Module > Modulmanager > Modul hochladen**, indem Sie die ZIP-Datei senden, oder kopieren Sie den Ordner `dfdeposit` in das Verzeichnis `/modules/` Ihres Shops und klicken Sie auf Installieren. Bei der Installation: - legt das Modul seine Tabellen an (Anzahlungen, Stripe-Transaktionen, Satzregeln); - erstellt es fünf Bestellstatus: **Warten auf Anzahlung**, **Anzahlung erhalten, Restbetrag offen**, **Restbetrag angefordert**, **Abholbereit, Restbetrag offen** und **Versandt, Restbetrag offen**; - fügt es das Menü **Bestellungen > Anzahlungen** und die Seite **Anzahlungssätze** hinzu, erreichbar über dieses Menü und über die Konfiguration; - registriert es seine Hooks: Zahlungsarten, Produktseite, Warenkorb, Bestellbestätigung, Kundenkonto, Bestellseite im Backoffice und PDF-Rechnung. Bei der Deinstallation bleiben die Tabellen absichtlich erhalten: Die Nummerierung der Anzahlungsrechnungen und Gutschriften muss fortlaufend bleiben, falls Sie das Modul erneut installieren. ## Prüfung der Einrichtung Die Konfigurationsseite beginnt mit einer Liste von Prüfungen in Grün, Orange oder Rot: Zahlungsart bereit, Stripe-Schlüssel von Stripe akzeptiert, Testmodus noch aktiv, Webhook-Geheimnis eingetragen und Datum des letzten empfangenen Ereignisses, letzter Cronjob-Lauf, auslösende Status vorhanden, ein auslösender Status als bezahlt markiert, Pflichtangaben der Rechnungen. Beheben Sie jede rote Zeile, bevor Sie den Verkauf starten. Die Schaltfläche **Stripe-Schlüssel testen** fragt Stripe mit dem Schlüssel des gewählten Modus ab. Der Test läuft auch automatisch beim Speichern, wenn sich der Schlüssel ändert. Webhook- und Cron-URL kopieren Sie mit der Schaltfläche **Kopieren**. ## Anzahlungsregeln ### Satz und Mindestbetrag **Anzahlungssatz**: Anteil der berechtigten Produkte, der bei der Bestellung gezahlt wird, zwischen 1 und 99 %. **Mindestbestellwert** (inkl. MwSt.): Darunter wird die Anzahlungsoption ausgeblendet. 0 bedeutet kein Minimum. ### Berechtigte Kategorien und andere Produkte Lassen Sie die Liste leer, um die Anzahlung für den ganzen Katalog anzubieten, oder wählen Sie die betroffenen Kategorien. Die Einstellung **Andere Produkte im Warenkorb** legt fest, was mit nicht berechtigten Produkten in einem gemischten Warenkorb geschieht: **Vollständig mit der Anzahlung bezahlt** (sie werden zu 100 % zum Anzahlungsbetrag addiert) oder **Anzahlungsoption ausblenden**. ### Versandkosten und Rundung Versandkosten können **mit dem Restbetrag bezahlt** (Standard), **mit der Anzahlung bezahlt** oder **nach Anzahlungssatz aufgeteilt** werden. Gerundet wird auf den Cent oder auf die nächste volle Einheit, etwa 748 € statt 747,35 €. ### Kundengruppen und Anzeige **Kundengruppen**: Nur die gewählten Gruppen sehen die Option, zum Beispiel Gewerbekunden für Profiausstattung. Leer = alle Kunden. **Auf Produktseiten anzeigen** fügt unter dem Warenkorb-Button eine Zeile wie „Mit 30 % Anzahlung bestellen: 747,00 € jetzt, 1.743,00 € bei Versand oder Abholung“ ein. **Im Warenkorb anzeigen** ergänzt die Übersicht um die Aufteilung Anzahlung / Restbetrag. ## Sätze pro Produkt, Kategorie oder Marke Öffnen Sie **Anzahlungssätze** über die Anzahlungsliste oder die Konfiguration und klicken Sie auf **Satz hinzufügen**. Jede Regel zielt auf genau ein Ziel: ein Produkt (Suche nach Name, Artikelnummer oder ID), eine Kategorie oder eine Marke, mit einem Satz zwischen 0 und 99 %. Reihenfolge: die Produktregel, dann die Regel der tiefsten Kategorie unter den Kategorien des Produkts, dann die Markenregel, zuletzt der Standardsatz aus der Konfiguration. Ein Satz von **0 %** schließt das Ziel aus: Das Produkt wird vollständig mit der Anzahlung bezahlt. Eine Regel gilt auch dann, wenn die Kategorie des Produkts nicht zu den berechtigten Kategorien gehört. Enthält ein Warenkorb Produkte mit unterschiedlichen Sätzen, wird die Anzahlung Zeile für Zeile berechnet. Kunde und Rechnung sehen dann den effektiven Satz, zum Beispiel 48,39 %. ## Restbetrag ### Status, die den Restbetrag anfordern Erreicht eine Bestellung mit bezahlter Anzahlung einen dieser Status, erhält der Kunde die Anforderungs-E-Mail mit dem Zahlungslink. Standardmäßig: **Restbetrag angefordert**, **Abholbereit, Restbetrag offen** und **Versandt, Restbetrag offen**. Verwenden Sie den Standardstatus **Versandt** nicht für eine Bestellung mit offenem Restbetrag: Er ist in PrestaShop als bezahlt markiert, und PrestaShop erfasst den Rest dann automatisch als bezahlt. Nutzen Sie **Versandt, Restbetrag offen**. Die Prüfung der Einrichtung meldet einen als bezahlt markierten auslösenden Status. ### Status nach vollständiger Zahlung Status, der gesetzt wird, wenn der Restbetrag null erreicht (standardmäßig Zahlung eingegangen), und ein zweiter für bereits versandte Bestellungen (standardmäßig Versandt). In diesem Moment erstellt PrestaShop die Schlussrechnung. ### Erinnerungen und Benachrichtigungen **Erinnerung alle** X Tage und **Maximale Anzahl an Erinnerungen** steuern die Erinnerungs-E-Mails, die der Cronjob versendet. **Team-Benachrichtigungen**: durch Kommas getrennte Adressen, die benachrichtigt werden, wenn ein Kunde eine Anzahlung oder einen Restbetrag online bezahlt, wenn eine Anzahlung mit unerwartetem Betrag eingeht und wenn eine Überweisungsbestellung aufgegeben wird. ### Weitere Möglichkeiten, den Restbetrag zu zahlen Freitext pro Sprache, angezeigt auf der Restbetragsseite und in den E-Mails, zum Beispiel „Der Restbetrag kann bei Abholung in der Werkstatt auch mit Karte oder bar bezahlt werden“. ## Kartenzahlung (Stripe) 1. Aktivieren Sie **Kartenzahlung aktivieren** und wählen Sie den Modus **Test** oder **Live**. 2. Fügen Sie den geheimen Schlüssel des gewählten Modus ein (`sk_test_`, `sk_live_` oder ein eingeschränkter Schlüssel `rk_`). Gespeicherte Schlüssel werden maskiert angezeigt. 3. Legen Sie im Stripe-Dashboard unter Entwickler > Webhooks einen Endpunkt mit der in der Konfiguration angezeigten URL und den Ereignissen `checkout.session.completed` und `checkout.session.async_payment_succeeded` an. 4. Kopieren Sie das Signaturgeheimnis `whsec_` in das Feld **Webhook-Signaturgeheimnis**. Der Kunde wird auf eine Stripe-Checkout-Seite weitergeleitet. Bei der Rückkehr wird die Bestellung sofort angelegt. Schließt der Kunde den Tab vorher, legt der Webhook die Bestellung an. Jede Sitzung wird nur einmal verarbeitet. Nach Ihrer ersten Testzahlung sollte die Zeile „Letztes Stripe-Ereignis empfangen“ der Prüfung grün werden. Bleibt sie orange, prüfen Sie URL und Ereignisse des Endpunkts. ## Banküberweisung Aktivieren Sie **Anzahlung per Überweisung anbieten** und tragen Sie Kontoinhaber, IBAN, BIC und Name der Bank ein. Die Bestellung wird im Status **Warten auf Anzahlung** angelegt; der Kunde sieht Ihre Bankverbindung auf der Bestätigungsseite und erhält sie per E-Mail, mit der Bestellreferenz als Verwendungszweck. **Bankverbindung für den Restbetrag anzeigen** ergänzt die Überweisung als Zahlungsweg für den Restbetrag. **Unbezahlte Überweisungsbestellungen stornieren nach** X Tagen: Der Cronjob storniert Bestellungen, die ohne jede Zahlung weiter auf die Anzahlung warten, und der Bestand wird wieder verkaufbar. 0 deaktiviert diese Stornierung. ## Anzahlungsrechnung **Nummernpräfix** (standardmäßig AC) und **Präfix der Gutschriften** (standardmäßig AVAC) müssen sich unterscheiden. Mit **Nächste Nummer (Minimum)** setzen Sie einen bestehenden Nummernkreis fort: Die nächste Rechnung erhält diesen Wert, wenn er höher ist als die zuletzt vergebene Nummer. **Pflichtangaben**: Text pro Sprache, unten auf jede Anzahlungsrechnung gedruckt (Firma, Handelsregister, USt-IdNr., Zahlungsbedingungen). ## Cronjob Planen Sie die in der Konfiguration angezeigte Cron-URL einmal täglich ein, zum Beispiel um 6 Uhr. Sie verschickt die Erinnerungen an den Restbetrag und storniert abgelaufene Überweisungsbestellungen, für alle Shops. Die Prüfung der Einrichtung zeigt den letzten Lauf. ## Der Ablauf für den Kunden 1. Im Checkout wählt der Kunde „Anzahlung von X € mit Karte bezahlen“ oder „per Überweisung“. Die Details zeigen Gesamtbetrag, Anzahlung, Restbetrag und einen Aufteilungsbalken. 2. Nach einer Kartenzahlung wechselt die Bestellung zu **Anzahlung erhalten, Restbetrag offen**, die Anzahlungsrechnung wird erstellt und an die E-Mail angehängt. Bei Überweisung wartet die Bestellung auf Ihre Bestätigung. 3. Erreicht die Bestellung einen auslösenden Status, erhält der Kunde den Link zur Restbetragsseite: Kartenzahlung, Bankverbindung und Ihre Hinweise. 4. Ist der Restbetrag bezahlt, wechselt die Bestellung in den Endstatus und der Kunde erhält eine Bestätigungs-E-Mail. Eine Fortschrittsanzeige in drei Schritten (Anzahlung bezahlt, Bestellung bereit und Restbetrag angefordert, Vollständig bezahlt) erscheint auf der Bestätigungsseite, in den Bestelldetails des Kundenkontos und auf der Restbetragsseite. Der Kunde kann den Restbetrag schon vor der Anforderung über sein Konto bezahlen. ## Anzahlungen im Backoffice verwalten ### Bestellungen > Anzahlungen Oben stehen vier Kennzahlen: offene Restbeträge, angeforderte Restbeträge, zu bestätigende Überweisungen und die Anzahlungen dieses Monats. Für jede Bestellung zeigt die Liste Satz, Gesamtbetrag, Anzahlung, bezahlten Betrag, offenen Restbetrag, Status und Anzahlungsrechnung. Markieren Sie mehrere Bestellungen und wählen Sie **Restbetrag anfordern**, um die Links auf einmal zu senden, etwa am Tag, an dem eine Charge abholbereit ist. ### Bereich „Anzahlung und Restbetrag“ auf der Bestellseite - **Anzahlung bestätigen**: Für eine eingegangene Überweisung geben Sie Betrag, Zahlungsart und Referenz ein. Die Zahlung wird erfasst, die Anzahlungsrechnung erstellt und versendet. - **Restbetrag jetzt anfordern** oder **Zahlungslink erneut senden**, dazu der Link zum Kopieren. - **Zahlung des Restbetrags erfassen**: Überweisung, Scheck, bar, Karte im Geschäft oder bei Lieferung. Erreicht der Restbetrag null, wechselt die Bestellung in den Endstatus und der Kunde wird benachrichtigt. - **Anzahlungsrechnung stornieren (Gutschrift)**: Für eine stornierte Bestellung wird eine nummerierte Gutschrift erstellt. Die Erstattung selbst erfolgt in Stripe oder per Überweisung. ## Rechnungsstellung Die Anzahlungsrechnung enthält Rechnungsadresse, Bestellreferenz, Satz, eine Zeile pro MwSt.-Satz mit Netto, MwSt. und Brutto, die Zahlungsart und den verbleibenden Restbetrag. Die MwSt.-Aufschlüsselung wird anteilig zu den Sätzen der Bestellung berechnet, inklusive Versand und Geschenkverpackung, und bei Ausstellung festgeschrieben. Der Kunde lädt sie in seinem Konto herunter, der Administrator in der Liste oder auf der Bestellseite. Die PrestaShop-Schlussrechnung wird bei Zahlung des Restbetrags erstellt, mit einem Hinweis auf die Anzahlungsrechnung. Die Gutschrift übernimmt die Beträge der Anzahlungsrechnung als negative Werte und die Referenz der stornierten Rechnung. ## Fehlerbehebung ### Die Anzahlungsoption erscheint nicht im Checkout Prüfen Sie der Reihe nach: eine bereite Zahlungsart (Stripe-Schlüssel oder IBAN), die Kundengruppe, den Mindestbetrag, die berechtigten Kategorien und Regeln mit 0 % sowie die Einstellung „Anzahlungsoption ausblenden“, falls der Warenkorb ein nicht berechtigtes Produkt enthält. ### Eine Kartenzahlung hat keine Bestellung erzeugt Das Webhook-Geheimnis fehlt wahrscheinlich oder ist falsch, oder der Endpunkt hört nicht auf die richtigen Ereignisse. Die Zahlung bleibt in Stripe sichtbar. Senden Sie das Ereignis nach der Korrektur des Webhooks im Stripe-Dashboard erneut: Die Bestellung wird angelegt. ### Die Bestellung steht auf „Zahlungsfehler“ Der per Karte gezahlte Betrag entspricht nicht der erwarteten Anzahlung, meist weil sich der Warenkorb während der Zahlung geändert hat. Prüfen Sie die Zahlungen der Bestellung und bestätigen Sie dann die Anzahlung im Bereich der Bestellseite oder erstatten Sie den Betrag. ### Erinnerungen werden nicht versendet Der Cronjob läuft nicht oder die Erinnerungsfrist steht auf 0. Die Prüfung der Einrichtung zeigt das Datum des letzten Laufs. ### Der Restbetrag gilt als bezahlt, obwohl der Kunde nichts gezahlt hat Auf die Bestellung wurde ein als bezahlt markierter Status angewendet (Zahlung eingegangen, Versandt): PrestaShop erfasst den Rest dann als bezahlt. Prüfen Sie die Zahlungen der Bestellung und verwenden Sie für die nächsten Bestellungen die Status des Moduls. ## Kompatibilität - PrestaShop 8.0 bis 9.x, dasselbe ZIP deckt beide Versionszweige ab. - Multishop, mehrere Währungen (Währungen ohne Nachkommastellen für Stripe berücksichtigt) und mehrere Sprachen. - ModuleAdminController-Architektur, Stripe-API direkt aufgerufen, ohne Composer-Abhängigkeit. - Oberfläche, E-Mails und PDFs auf Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.