Klantentegoed & Wallet voor PrestaShop 8 & 9

Overzicht

DataFirefly Klantentegoed voegt aan PrestaShop 8 en 9 een tegoed per klant toe. U crediteert er terugbetalingen, creditnota’s en commerciële gebaren op; de klant besteedt het bij de betaalstap van volgende bestellingen en kan het zelf opwaarderen. Het tegoed wordt behandeld als betaalmethode: een bestelling die deels met tegoed is betaald, behoudt haar totaal, factuur en btw-grondslag, en het tegoeddeel verschijnt als betaalregel.

Installatie

1. Klik in Modules > Modulebeheer op Een module uploaden en sleep dfwallet-1.1.1.zip erin.
2. Bij de installatie maakt de module haar tabellen aan, een tabblad Klanten > Tegoeden, een verborgen virtueel product DFWALLET-TOPUP voor opwaarderingen, en plaatst zich bovenaan de betaalmethoden.
3. Controleer in Betaling > Voorkeuren of de module is toegestaan voor uw valuta, landen en klantgroepen.

Om bij te werken uploadt u gewoon de nieuwe ZIP: tegoeden, geschiedenis en instellingen blijven bewaard, en de updatescripts voegen de nieuwe kolommen toe.

Configuratie

Betaling

• Gedeeltelijk gebruik bij het afrekenen toestaan: als het tegoed niet de hele bestelling dekt, kan de klant het toepassen en de rest met een andere methode betalen.
• Bestelstatus wanneer het tegoed de hele bestelling betaalt: standaard Betaling aanvaard.

Opwaarderen door de klant

• Voorgestelde bedragen: gescheiden door komma’s, in de standaardvaluta. Voorbeeld: 20,50,100.
• Vrij bedrag, met minimale en maximale opwaardering.
• Opwaardeerbonus: staffels in het formaat bedrag:bonus. Met 50:5,100:15 crediteert een opwaardering van € 100 in totaal € 115. De bonus wordt bijgeschreven bij betaling van de opwaardering en teruggenomen als de bestelling wordt geannuleerd of terugbetaald.

De opwaardering wordt zonder btw verkocht, omdat het een vooruitbetaling is. Het tegoed wordt pas bijgeschreven als de opwaardeerbestelling een betaalde status bereikt.

Terugbetalingen en annuleringen

• Het tegoeddeel teruggeven wanneer een bestelling wordt geannuleerd en wanneer ze naar Terugbetaald gaat.
• Elke nieuwe creditnota automatisch op het tegoed crediteren: standaard uit. Laat dit uit als u ook per overschrijving of met een standaard kortingsbon terugbetaalt; creditnota’s worden dan één voor één vanaf de bestelpagina gecrediteerd.

Crediteringen bij een bestelling (terugboekingen en terugbetalingen) zijn begrensd tot het bedrag ervan: automatisch terugboeken én de creditnota van dezelfde bestelling crediteren levert nooit een dubbele creditering op.

Verlopen van commerciële gebaren

• Geldigheid in maanden, 0 voor geen verloop. Dit geldt voor commerciële gebaren, creditcorrecties en opwaardeerbonussen. Terugbetalingen, teruggeboekte betalingen en opwaarderingen verlopen nooit.
• Herinneringsmail vóór het verlopen: aantal dagen vóór de datum, 0 voor geen herinnering.

Een betaling gebruikt altijd eerst de bedragen die het eerst verlopen.

Cronopdracht

De URL bovenaan de configuratiepagina, beveiligd met een token, laat vervallen credits verlopen en verstuurt de herinneringen. Roep hem één keer per dag aan:

0 6 * * * curl -s "https://uw-winkel.nl/module/dfwallet/cron?token=UW_TOKEN" > /dev/null

Zonder cron draait dezelfde verwerking hooguit één keer per uur bij het openen van de lijst met tegoeden, en de verlopen credits van een klant worden verwerkt zodra zijn tegoed wordt getoond.

Een tegoed crediteren

Vanaf de bestelpagina

Het paneel Klantentegoed toont het saldo, de bewegingen bij de bestelling, een knop Op het tegoed crediteren bij elke creditnota en een crediteringsformulier (commercieel gebaar, terugbetaling, correctie). Als de bestelling deels met tegoed is betaald, kan een knop die betaling teruggeven.

Vanaf de klantpagina en de lijst

De klantpagina toont het saldo en een formulier om te crediteren of te debiteren. Klanten > Tegoeden toont alle tegoeden, met snel crediteren op e-mailadres en een detailpagina per klant.

Bij elke beweging kunt u een bericht voor de klant, een interne notitie en voor commerciële gebaren een geldig-tot-datum invullen, en kiezen om de klant per e-mail te verwittigen.

Bulkcreditering via CSV

Het blok Commerciële gebaren in bulk accepteert een CSV-bestand, één klant per regel:

email;amount;message;valid_until
jane@example.com;10;Excuses voor de late levering;2027-06-30

Bericht en datum zijn optioneel; datums als JJJJ-MM-DD of DD/MM/JJJJ, bedragen met komma of punt. Een standaardbericht en -geldigheid gelden voor regels zonder die gegevens. Elke regel heeft een eigen sleutel tegen dubbele boekingen: hetzelfde bestand twee keer versturen crediteert niemand twee keer. Een rapport toont gecrediteerde, al geïmporteerde en foutieve regels.

Aan de klantkant

• Mijn account > Mijn tegoed: saldo, bedragen die binnenkort verlopen, opwaarderen en geschiedenis met paginering en links naar de bestellingen.
• Winkelwagenpagina: melding van het beschikbare tegoed.
• Betaalstap: dekt het tegoed de bestelling, dan wordt Betalen met mijn tegoed als eerste aangeboden. Zo niet, dan toont de knop Mijn tegoed gebruiken het afgetrokken bedrag en de rest, waarna de klant een andere betaalmethode kiest.
• Orderbevestiging: het met tegoed betaalde deel en het nog verschuldigde bedrag.

Het in de winkelwagen toegepaste tegoed verschijnt in het overzicht als regel Tegoed. Verwijdert de klant die met het prullenbakpictogram, dan wordt het tegoed voor die winkelwagen niet meer gebruikt.

Boekhouding

Bij de bevestiging wordt het gebruikte tegoed geregistreerd als betaling van de bestelling. Productentotaal, btw en factuur veranderen niet. Bij betaling per overschrijving of cheque tonen de instructies aan de klant het werkelijk verschuldigde bedrag.

De lijst met tegoeden toont het totale openstaande bedrag per valuta: zolang het niet is besteed, is het een schuld aan uw klanten. Het blok Bewegingen exporteren maakt een CSV (UTF-8, puntkomma als scheidingsteken) met één regel per beweging: datum, klant, bewerking, bedrag, valuta, saldo, bestelling, creditnota, geldigheid, medewerker, bericht en notitie.

E-mails

Twee sjablonen worden in 8 talen meegeleverd in modules/dfwallet/mails/: dfwallet_credit (tegoed gecrediteerd) en dfwallet_expiry (herinnering vóór het verlopen). Ze worden opgesteld in de taal van de klant, inclusief bedragen en datums. U kunt ze aanpassen via Internationaal > Vertalingen > E-mailvertalingen of ze overschrijven in uw thema.

Deïnstallatie en AVG

Tegoeden en geschiedenis blijven bewaard bij het deïnstalleren, omdat ze een schuld aan uw klanten zijn. Activeer Saldi en geschiedenis verwijderen bij het deïnstalleren alleen als u alles wilt wissen. De bewegingen van een klant zitten in de gegevensexport van de officiële AVG-module.

Veelgestelde vragen

De klant ziet de betaaloptie met tegoed niet

De optie verschijnt alleen als het tegoed de hele bestelling dekt. Anders staat de knop Mijn tegoed gebruiken boven de betaalmethoden, mits gedeeltelijk gebruik is ingeschakeld. Controleer ook of de module is toegestaan voor de valuta, het land en de groep van de klant.

Het tegoed is niet bruikbaar bij een opwaardering

Dat is zo bedoeld: een winkelwagen met een opwaardering kan niet met tegoed worden betaald.

Het paneel verschijnt niet op de bestelpagina voor een medewerker

PrestaShop voert de hooks van een module alleen uit als het profiel van de medewerker het recht Bekijken op die module heeft. Voeg het toe via Geavanceerde parameters > Team > Rechten.