# Portfel Klienta i Środki na Koncie dla PrestaShop 8 i 9 > Wprowadzenie DataFirefly Portfel klienta dodaje do PrestaShop 8 i 9 saldo dla każdego klienta. Zapisujesz na nim zwroty, korekty i gesty handlowe; klient wykorzystuje je na etapie płatności kolejnych zamówień… - Strona: - Język: pl - Zaktualizowano: 2026-09-30 - Inne języki: [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), [de](https://www.datafirefly.com/de/documentation/dfwallet/index.md), [it](https://www.datafirefly.com/it/documentation/dfwallet/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfwallet/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfwallet/index.md) - Indeks: ## Wprowadzenie DataFirefly Portfel klienta dodaje do PrestaShop 8 i 9 saldo dla każdego klienta. Zapisujesz na nim zwroty, korekty i gesty handlowe; klient wykorzystuje je na etapie płatności kolejnych zamówień i może je sam zasilać. Saldo jest traktowane jak metoda płatności: zamówienie opłacone częściowo portfelem zachowuje sumę, fakturę i podstawę VAT, a część z portfela pojawia się jako pozycja płatności. ## Instalacja 1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i upuść plik `dfwallet-1.1.1.zip`. 2. Podczas instalacji moduł tworzy swoje tabele, zakładkę **Klienci > Portfele**, ukryty produkt wirtualny `DFWALLET-TOPUP` używany do zasileń i ustawia się na pierwszym miejscu metod płatności. 3. W **Płatność > Preferencje** sprawdź, czy moduł jest dozwolony dla twoich walut, krajów i grup klientów. Aby zaktualizować, załaduj nowy plik ZIP: salda, historia i ustawienia zostają zachowane, a skrypty aktualizacji dodają nowe kolumny. ## Konfiguracja ### Płatność - **Zezwalaj na częściowe użycie przy płatności**: gdy saldo nie pokrywa całego zamówienia, klient może je zastosować i zapłacić resztę inną metodą. - **Status zamówienia, gdy portfel opłaca całe zamówienie**: domyślnie Płatność zaakceptowana. ### Zasilanie przez klienta - **Sugerowane kwoty**: oddzielone przecinkami, w walucie domyślnej. Przykład: `20,50,100`. - **Dowolna kwota**, z **minimalnym** i **maksymalnym zasileniem**. - **Bonus za zasilenie**: progi w formacie `kwota:bonus`. Przy `50:5,100:15` zasilenie 100 zł daje 115 zł. Bonus jest dopisywany po opłaceniu zasilenia i cofany, gdy zamówienie zostanie anulowane lub zwrócone. Zasilenie jest sprzedawane bez VAT, ponieważ to przedpłata. Saldo jest dopisywane dopiero wtedy, gdy zamówienie zasilenia osiągnie status opłacony. ### Zwroty i anulowania - **Zwracaj część opłaconą portfelem po anulowaniu zamówienia** oraz **po zmianie statusu na Zwrócone**. - **Automatycznie zasilaj portfel każdą nową korektą**: domyślnie wyłączone. Pozostaw wyłączone, jeśli zwracasz też przelewem lub natywnym kuponem; korekty księguje się wtedy pojedynczo ze strony zamówienia. Uznania związane z zamówieniem (zwroty części portfela i korekty) są ograniczone do jego kwoty: włączenie automatycznego zwrotu i zaksięgowanie korekty tego samego zamówienia nigdy nie zasila dwa razy. ### Wygasanie gestów handlowych - **Ważność** w miesiącach, 0 oznacza brak wygasania. Dotyczy gestów handlowych, korekt na plus i bonusów za zasilenie. Zwroty, zwrócone płatności i zasilenia nigdy nie wygasają. - **E-mail z przypomnieniem przed wygaśnięciem**: liczba dni przed terminem, 0 oznacza brak przypomnienia. Płatność zawsze najpierw wykorzystuje kwoty, które wygasają najwcześniej. ### Zadanie cron Adres URL widoczny na górze strony konfiguracji, chroniony tokenem, wygasza zaległe uznania i wysyła przypomnienia. Wywołuj go raz dziennie: ``` 0 6 * * * curl -s "https://twoj-sklep.pl/module/dfwallet/cron?token=TWOJ_TOKEN" > /dev/null ``` Bez crona to samo przetwarzanie działa najwyżej raz na godzinę przy otwarciu listy portfeli, a wygasłe uznania klienta są przetwarzane, gdy tylko jego portfel zostanie wyświetlony. ## Zasilanie portfela ### Ze strony zamówienia Panel **Portfel klienta** pokazuje saldo, operacje powiązane z zamówieniem, przycisk **Zaksięguj w portfelu** przy każdej korekcie i formularz zasilenia (gest handlowy, zwrot, korekta). Jeśli zamówienie opłacono częściowo portfelem, przycisk pozwala zwrócić tę płatność. ### Z karty klienta i z listy Karta klienta pokazuje saldo i formularz zasilenia lub obciążenia. **Klienci > Portfele** zawiera listę wszystkich portfeli, szybkie zasilenie po adresie e-mail i szczegółową kartę każdego klienta. Przy każdej operacji możesz podać **wiadomość widoczną dla klienta**, **notatkę wewnętrzną**, **datę ważności** dla gestów handlowych i wybrać **powiadomienie klienta e-mailem**. ### Masowe zasilenia z pliku CSV Blok **Masowe gesty handlowe** przyjmuje plik CSV, jeden klient w wierszu: ``` email;amount;message;valid_until jane@example.com;10;Przepraszamy za opóźnioną dostawę;2027-06-30 ``` Wiadomość i data są opcjonalne; daty w formacie RRRR-MM-DD lub DD/MM/RRRR, kwoty z przecinkiem lub kropką. Domyślna wiadomość i ważność dotyczą wierszy bez tych danych. Każdy wiersz ma własny klucz chroniący przed duplikatami: dwukrotne wysłanie tego samego pliku nikogo nie zasili dwa razy. Raport pokazuje wiersze zasilone, już zaimportowane i błędne. ## Strona klienta - **Moje konto > Mój portfel**: saldo, kwoty wkrótce wygasające, zasilenie i historia z paginacją oraz linkami do zamówień. - **Strona koszyka**: przypomnienie o dostępnym saldzie. - **Etap płatności**: jeśli saldo pokrywa zamówienie, jako pierwsza proponowana jest opcja Zapłać moim portfelem. W przeciwnym razie przycisk Użyj mojego salda pokazuje odjętą kwotę i resztę do zapłaty, po czym klient wybiera inną metodę. - **Potwierdzenie zamówienia**: przypomnienie części opłaconej portfelem i kwoty pozostałej do zapłaty. Saldo zastosowane w koszyku pojawia się w podsumowaniu jako pozycja Portfel. Jeśli klient usunie ją ikoną kosza, saldo przestaje być używane w tym koszyku. ## Księgowość Przy zatwierdzeniu zamówienia wykorzystane saldo jest zapisywane jako płatność zamówienia. Wartość produktów, VAT i faktura się nie zmieniają. Przy płatności przelewem lub czekiem instrukcje wysyłane klientowi podają faktycznie należną kwotę. Lista portfeli pokazuje łączne saldo do wykorzystania w każdej walucie: dopóki nie zostanie wydane, jest zobowiązaniem wobec klientów. Blok **Eksportuj operacje** tworzy plik CSV (UTF-8, separator średnik) z jednym wierszem na operację: data, klient, operacja, kwota, waluta, saldo, zamówienie, korekta, ważność, pracownik, wiadomość i notatka. ## E-maile Dwa szablony są dostarczane w 8 językach w `modules/dfwallet/mails/`: `dfwallet_credit` (portfel zasilony) i `dfwallet_expiry` (przypomnienie przed wygaśnięciem). Są pisane w języku klienta, łącznie z kwotami i datami. Możesz je dostosować w **Międzynarodowe > Tłumaczenia > Tłumaczenia e-maili** lub nadpisać w motywie. ## Odinstalowanie i RODO Salda i historia są zachowywane przy odinstalowaniu, ponieważ stanowią zobowiązanie wobec klientów. Włącz **Usuń salda i historię przy odinstalowaniu** tylko wtedy, gdy chcesz wszystko usunąć. Operacje klienta są uwzględniane w eksporcie danych oficjalnego modułu RODO. ## Najczęstsze pytania ### Klient nie widzi opcji płatności portfelem Opcja pojawia się tylko wtedy, gdy saldo pokrywa całe zamówienie. W przeciwnym razie nad metodami płatności wyświetla się przycisk Użyj mojego salda, o ile częściowe użycie jest włączone. Sprawdź też, czy moduł jest dozwolony dla waluty, kraju i grupy klienta. ### Portfela nie można użyć przy zasileniu To zamierzone: koszyka zawierającego zasilenie nie można opłacić portfelem. ### Panel nie wyświetla się pracownikowi na stronie zamówienia PrestaShop wykonuje hooki modułu tylko wtedy, gdy profil pracownika ma uprawnienie Wyświetl dla tego modułu. Dodaj je w **Zaawansowane > Zespół > Uprawnienia**.