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 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.

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.

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.

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.