# Aanbetaling: aanbetaling bij bestelling en restbedrag bij levering > Installatie Installeer de module via Modules > Modulebeheer > Een module uploaden door het ZIP-bestand te versturen, of kopieer de map dfdeposit naar de map /modules/ van uw winkel en… - Pagina: - Taal: nl - Bijgewerkt op: 2026-10-07 - Andere talen: [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), [de](https://www.datafirefly.com/de/documentation/dfdeposit/index.md), [it](https://www.datafirefly.com/it/documentation/dfdeposit/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdeposit/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdeposit/index.md) - Index: ## Installatie Installeer de module via **Modules > Modulebeheer > Een module uploaden** door het ZIP-bestand te versturen, of kopieer de map `dfdeposit` naar de map `/modules/` van uw winkel en klik op Installeren. Bij de installatie: - maakt de module haar tabellen aan (aanbetalingen, Stripe-transacties, percentageregels); - maakt ze vijf bestelstatussen aan: **Wacht op aanbetaling**, **Aanbetaling ontvangen, saldo open**, **Saldo opgevraagd**, **Klaar om af te halen, saldo open** en **Verzonden, saldo open**; - voegt ze het menu **Bestellingen > Aanbetalingen** en het scherm **Aanbetalingspercentages** toe, bereikbaar via dat menu en via de configuratie; - registreert ze haar hooks: betaalmethoden, productpagina, winkelwagen, orderbevestiging, klantaccount, bestelpagina in de back-office en pdf-factuur. Bij het verwijderen blijven de tabellen bewust behouden: de nummering van aanbetalingsfacturen en creditnota's moet doorlopend blijven als u de module opnieuw installeert. ## Controle van de configuratie De configuratiepagina begint met een lijst controles in groen, oranje of rood: betaalmethode klaar, Stripe-sleutel door Stripe geaccepteerd, testmodus nog actief, webhookgeheim ingevuld en datum van de laatst ontvangen gebeurtenis, laatste uitvoering van de cronjob, statussen die het saldo opvragen aanwezig, daarvan een status gemarkeerd als betaald, wettelijke vermeldingen op de facturen. Los elke rode regel op voordat u de verkoop opent. De knop **Stripe-sleutel testen** raadpleegt Stripe met de sleutel van de gekozen modus. De test draait ook automatisch bij het opslaan wanneer de sleutel verandert. De URL's van webhook en cronjob kopieert u met de knop **Kopiëren**. ## Aanbetalingsregels ### Percentage en minimumbedrag **Aanbetalingspercentage**: aandeel van de geschikte producten dat bij de bestelling wordt betaald, tussen 1 en 99 %. **Minimaal bestelbedrag** (incl. btw): daaronder wordt de aanbetalingsoptie verborgen. 0 betekent geen minimum. ### Geschikte categorieën en andere producten Laat de lijst leeg om aanbetaling op de hele catalogus aan te bieden, of selecteer de betreffende categorieën. De instelling **Andere producten in de winkelwagen** bepaalt wat er met niet-geschikte producten in een gemengde winkelwagen gebeurt: **Volledig betaald met de aanbetaling** (voor 100 % bij de aanbetaling opgeteld) of **Aanbetalingsoptie verbergen**. ### Verzendkosten en afronding Verzendkosten kunnen **betaald worden met het saldo** (standaard), **met de aanbetaling** of **verdeeld volgens het aanbetalingspercentage**. Afronding gebeurt op de cent of naar de volgende hele eenheid, voor bedragen als € 748 in plaats van € 747,35. ### Klantengroepen en weergave **Klantengroepen**: alleen de gekozen groepen zien de optie, bijvoorbeeld zakelijke klanten voor professionele uitrusting. Leeg = alle klanten. **Tonen op productpagina's** voegt onder de knop In winkelwagen een regel toe zoals "Bestel met 30 % aanbetaling: € 747,00 nu, € 1.743,00 bij verzending of afhalen". **Tonen in de winkelwagen** voegt de verdeling aanbetaling / saldo toe aan het overzicht. ## Percentages per product, categorie of merk Open **Aanbetalingspercentages** vanuit de lijst met aanbetalingen of vanuit de configuratie en klik op **Percentage toevoegen**. Elke regel richt zich op één doel: een product (zoeken op naam, referentie of ID), een categorie of een merk, met een percentage tussen 0 en 99 %. Volgorde van voorrang: de productregel, dan de regel van de diepste categorie onder de categorieën van het product, dan de merkregel, en ten slotte het standaardpercentage uit de configuratie. Een percentage van **0 %** sluit het doel uit: het product wordt volledig met de aanbetaling betaald. Een regel geldt ook als de categorie van het product niet bij de geschikte categorieën hoort. Bevat een winkelwagen producten met verschillende percentages, dan wordt de aanbetaling per regel berekend. De klant en de factuur tonen dan het effectieve percentage, bijvoorbeeld 48,39 %. ## Saldo ### Statussen die het saldo opvragen Krijgt een bestelling met betaalde aanbetaling een van deze statussen, dan ontvangt de klant de e-mail met de saldoaanvraag en de betaallink. Standaard: **Saldo opgevraagd**, **Klaar om af te halen, saldo open** en **Verzonden, saldo open**. Gebruik de standaardstatus **Verzonden** niet voor een bestelling met een openstaand saldo: die is in PrestaShop als betaald gemarkeerd, waarna PrestaShop het restant automatisch als betaald registreert. Gebruik **Verzonden, saldo open**. De controle van de configuratie waarschuwt voor een als betaald gemarkeerde status. ### Status na volledige betaling Status die wordt ingesteld wanneer het saldo op nul komt (standaard Betaling aanvaard), en een tweede voor bestellingen die al verzonden zijn (standaard Verzonden). Op dat moment maakt PrestaShop de eindfactuur aan. ### Herinneringen en meldingen **Herinnering elke** X dagen en **Maximaal aantal herinneringen** sturen de herinneringsmails die de cronjob verstuurt. **Meldingen aan het team**: e-mailadressen, gescheiden door komma's, die een melding krijgen wanneer een klant online een aanbetaling of saldo betaalt, wanneer een aanbetaling met een onverwacht bedrag binnenkomt en wanneer een overschrijvingsbestelling wordt geplaatst. ### Andere manieren om het saldo te betalen Vrije tekst per taal, getoond op de saldopagina en in de e-mails, bijvoorbeeld "Het saldo kan bij het afhalen in de werkplaats ook met kaart of contant worden betaald". ## Kaartbetaling (Stripe) 1. Vink **Kaartbetaling inschakelen** aan en kies de modus **Test** of **Live**. 2. Plak de geheime sleutel van de gekozen modus (`sk_test_`, `sk_live_` of een beperkte sleutel `rk_`). Opgeslagen sleutels worden gemaskeerd weergegeven. 3. Maak in het Stripe-dashboard, Ontwikkelaars > Webhooks, een endpoint aan met de URL uit de configuratie en de gebeurtenissen `checkout.session.completed` en `checkout.session.async_payment_succeeded`. 4. Kopieer het ondertekeningsgeheim `whsec_` naar het veld **Webhook-ondertekeningsgeheim**. De klant wordt doorgestuurd naar een Stripe Checkout-pagina. Bij terugkeer wordt de bestelling direct aangemaakt. Sluit de klant het tabblad eerder, dan maakt de webhook de bestelling aan. Elke sessie wordt maar één keer verwerkt. Na uw eerste testbetaling hoort de regel "Laatste Stripe-gebeurtenis ontvangen" in de controle groen te worden. Blijft ze oranje, controleer dan de URL en de gebeurtenissen van het endpoint. ## Bankoverschrijving Vink **Aanbetaling per overschrijving aanbieden** aan en vul rekeninghouder, IBAN, BIC en naam van de bank in. De bestelling wordt aangemaakt met de status **Wacht op aanbetaling**; de klant ziet uw bankgegevens op de bevestigingspagina en ontvangt ze per e-mail, met de bestelreferentie als betalingskenmerk. **Bankgegevens tonen voor het saldo** voegt overschrijving toe als manier om het saldo te betalen. **Onbetaalde overschrijvingsbestellingen annuleren na** X dagen: de cronjob annuleert bestellingen die zonder enige betaling nog op de aanbetaling wachten, en de voorraad komt weer vrij. 0 schakelt deze annulering uit. ## Aanbetalingsfactuur **Nummerprefix** (standaard AC) en **Prefix van de creditnota's** (standaard AVAC) moeten verschillen. Met **Volgend nummer (minimum)** zet u een bestaande nummering voort: de volgende factuur krijgt deze waarde als die hoger is dan het laatst uitgegeven nummer. **Wettelijke vermeldingen**: tekst per taal, onderaan elke aanbetalingsfactuur afgedrukt (bedrijfsnaam, KvK-nummer, btw-nummer, betalingsvoorwaarden). ## Cronjob Plan de cron-URL uit de configuratie eenmaal per dag in, bijvoorbeeld om 6.00 uur. Ze verstuurt de saldoherinneringen en annuleert verlopen overschrijvingsbestellingen, voor alle winkels. De controle van de configuratie toont de laatste uitvoering. ## Het traject van de klant 1. Bij het afrekenen kiest de klant "Een aanbetaling van € X met kaart betalen" of "per overschrijving". Het detail toont het totaal, de aanbetaling, het saldo en een verdelingsbalk. 2. Na een kaartbetaling gaat de bestelling naar **Aanbetaling ontvangen, saldo open**, en wordt de aanbetalingsfactuur aangemaakt en bij de e-mail gevoegd. Bij een overschrijving wacht de bestelling op uw bevestiging. 3. Bereikt de bestelling een status die het saldo opvraagt, dan krijgt de klant de link naar de saldopagina: kaartbetaling, bankgegevens en uw instructies. 4. Zodra het saldo betaald is, gaat de bestelling naar de eindstatus en ontvangt de klant een bevestigingsmail. Een voortgang in drie stappen (Aanbetaling betaald, Bestelling klaar en saldo opgevraagd, Volledig betaald) staat op de bevestigingspagina, in de besteldetails van het klantaccount en op de saldopagina. De klant kan het saldo vanuit zijn account al betalen voordat het wordt opgevraagd. ## Aanbetalingen beheren in de back-office ### Bestellingen > Aanbetalingen Bovenaan vier indicatoren: openstaande saldi, opgevraagde saldi, te bevestigen overschrijvingen en de aanbetalingen van deze maand. Voor elke bestelling toont de lijst het percentage, het totaal, de aanbetaling, het betaalde bedrag, het openstaande saldo, de status en de aanbetalingsfactuur. Vink meerdere bestellingen aan en kies **Saldo opvragen** om de links in één keer te versturen, bijvoorbeeld op de dag dat een partij klaar is om af te halen. ### Blok "Aanbetaling en saldo" op de bestelpagina - **Aanbetaling bevestigen**: voer bij een ontvangen overschrijving het bedrag, de methode en de referentie in. De betaling wordt geregistreerd en de aanbetalingsfactuur aangemaakt en verstuurd. - **Saldo nu opvragen** of **Betaallink opnieuw verzenden**, met de saldolink om te kopiëren. - **Betaling van het saldo registreren**: overschrijving, cheque, contant, kaart in de winkel of bij levering. Komt het saldo op nul, dan gaat de bestelling naar de eindstatus en wordt de klant op de hoogte gebracht. - **Aanbetalingsfactuur annuleren (creditnota)**: voor een geannuleerde bestelling wordt een genummerde creditnota aangemaakt. De terugbetaling zelf gebeurt in Stripe of per overschrijving. ## Facturatie De aanbetalingsfactuur vermeldt het factuuradres, de bestelreferentie, het percentage, één regel per btw-tarief met bedrag excl. btw, btw en bedrag incl. btw, de betaalmethode en het resterende saldo. De btw-uitsplitsing wordt naar rato van de tarieven van de bestelling berekend, inclusief verzending en cadeauverpakking, en vastgelegd bij uitgifte. De klant downloadt ze in zijn account, de beheerder in de lijst of op de bestelpagina. De eindfactuur van PrestaShop wordt aangemaakt bij betaling van het saldo, met een blok dat naar de aanbetalingsfactuur verwijst. De creditnota neemt de bedragen van de aanbetalingsfactuur negatief over, met de referentie van de geannuleerde factuur. ## Problemen oplossen ### De aanbetalingsoptie verschijnt niet bij het afrekenen Controleer achtereenvolgens: een betaalmethode die klaar is (Stripe-sleutel of IBAN), de klantengroep, het minimumbedrag, de geschikte categorieën en regels van 0 %, en de instelling "Aanbetalingsoptie verbergen" als de winkelwagen een niet-geschikt product bevat. ### Een kaartbetaling heeft geen bestelling aangemaakt Het webhookgeheim ontbreekt waarschijnlijk of is onjuist, of het endpoint luistert niet naar de juiste gebeurtenissen. De betaling blijft zichtbaar in Stripe. Verstuur de gebeurtenis na het herstellen van de webhook opnieuw vanuit het Stripe-dashboard: de bestelling wordt aangemaakt. ### De bestelling staat op "Betalingsfout" Het met kaart betaalde bedrag komt niet overeen met de verwachte aanbetaling, meestal omdat de winkelwagen tijdens de betaling is gewijzigd. Controleer de betalingen van de bestelling en bevestig daarna de aanbetaling in het blok op de bestelpagina of betaal de klant terug. ### Herinneringen worden niet verstuurd De cronjob draait niet of de herinneringstermijn staat op 0. De controle van de configuratie toont de datum van de laatste uitvoering. ### Het saldo staat als betaald terwijl de klant niets heeft betaald Op de bestelling is een als betaald gemarkeerde status toegepast (Betaling aanvaard, Verzonden): PrestaShop registreert het restant dan als betaald. Controleer de betalingen van de bestelling en gebruik voor volgende bestellingen de statussen van de module. ## Compatibiliteit - PrestaShop 8.0 tot 9.x, dezelfde ZIP dekt beide versies. - Multistore, meerdere valuta (valuta zonder decimalen afgehandeld voor Stripe) en meertalig. - ModuleAdminController-architectuur, Stripe-API rechtstreeks aangeroepen, zonder Composer-afhankelijkheid. - Interface, e-mails en pdf's in het Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.