PrestaShop

• Aktywne konto sprzedawcy Cost+
• PrestaShop 9.1 lub nowszy
• PHP 8.1 lub nowszy
• Włączony SSL/HTTPS
• Dostęp administratora do panelu PrestaShop

• Aktywne konto sprzedawcy Cost+
• Instalacja PrestaShop 8.x
• PHP 8.0 lub nowszy
• Dostęp administratora do panelu PrestaShop
• MySQL 5.4 lub nowszy

• Aktywne konto sprzedawcy Cost+
• Instalacja PrestaShop 1.7.x
• PHP 5.4 lub nowszy
• Dostęp administratora do panelu PrestaShop
• MySQL 5.4 lub nowszy

• Aktywne konto sprzedawcy Cost+
• Instalacja PrestaShop 1.6.1.x
• PHP 5.6 lub nowszy (z rozszerzeniami cURL i OpenSSL)
• Włączony SSL/HTTPS w sklepie
• Dostęp administratora do panelu PrestaShop

Pobierz moduł z GitHub.

Metoda A: Przesłanie przez panel administracyjny (zalecana)

1. Przejdź do Modules → Module Manager w panelu administracyjnym
2. Kliknij Upload a module
3. Przeciągnij i upuść plik ZIP lub wybierz go ręcznie
4. Poczekaj na zakończenie instalacji
5. Wyszukaj „NoPayn" i kliknij Configure

Metoda B: Ręczne przesłanie

1. Skopiuj folder nopaynpayment/ do katalogu modules/ PrestaShop
2. Przejdź do Modules → Module Manager
3. Wyszukaj „NoPayn" i kliknij Install
4. Kliknij Configure, aby otworzyć ustawienia

Pobierz moduł z GitHub.

Metoda A: Przesłanie przez panel administracyjny (zalecana)

1. Przejdź do Improve > Module Manager w panelu administracyjnym
2. Kliknij Upload a module
3. Przeciągnij i upuść plik ZIP lub wybierz go ręcznie
4. Poczekaj na zakończenie instalacji
5. Przewiń w dół do sekcji „Other" i kliknij Configure pod Cost+

Metoda B: Ręczne przesłanie przez (S)FTP

1. Rozpakuj pobrany plik ZIP
2. Za pomocą klienta SFTP (np. FileZilla, WinSCP) prześlij wszystkie foldery do katalogu /modules/ w instalacji PrestaShop
3. Przejdź do Improve > Modules > Module Catalog
4. Wyszukaj „Cost+" -- sprawdź zakładkę Uninstalled Modules, jeśli potrzeba
5. Kliknij Install

Pobierz moduł z GitHub.

Metoda A: Przesłanie przez panel administracyjny (zalecana)

1. Przejdź do Improve > Module Manager w panelu administracyjnym
2. Kliknij Upload a module
3. Przeciągnij i upuść plik ZIP lub wybierz go ręcznie
4. Poczekaj na zakończenie instalacji
5. Przewiń w dół do sekcji „Other" i kliknij Configure pod Cost+

Metoda B: Ręczne przesłanie przez (S)FTP

1. Rozpakuj pobrany plik ZIP
2. Za pomocą klienta SFTP (np. FileZilla, WinSCP) prześlij wszystkie foldery do katalogu /modules/ w instalacji PrestaShop
3. Przejdź do Modules > Module Manager
4. Wyszukaj „Cost+" -- sprawdź zakładkę Uninstalled Modules, jeśli potrzeba
5. Kliknij Install

Pobierz moduł z GitHub.

Metoda A: Przesłanie przez panel administracyjny (zalecana)

1. Pobierz costpluspayment.zip ze strony GitHub Releases
2. Przejdź do Modules and Services w panelu administracyjnym PrestaShop
3. Kliknij Add a new module
4. Prześlij plik ZIP
5. Znajdź Cost+ Payment Gateway na liście modułów i kliknij Install

Metoda B: Ręczne przesłanie przez (S)FTP

1. Rozpakuj pobrany plik ZIP
2. Za pomocą klienta SFTP prześlij folder costpluspayment/ do /modules/costpluspayment/ w instalacji PrestaShop
3. Przejdź do Modules and Services w panelu administracyjnym
4. Znajdź Cost+ Payment Gateway i kliknij Install

W konfiguracji modułu NoPayn wprowadź klucz API i skonfiguruj następujące ustawienia:

Wklej klucz w pole API Key na stronie konfiguracji biblioteki Cost+ i kliknij Save.

Wklej klucz w pole API Key na stronie konfiguracji biblioteki Cost+ i kliknij Save.

Po instalacji kliknij Configure przy module Cost+ Payment Gateway i ustaw następujące:

Po zapisaniu otwórz Payment > Restrictions i włącz moduł Cost+ Payment Gateway dla każdej akceptowanej waluty.

Metody płatności są konfigurowane bezpośrednio w ustawieniach modułu (patrz krok 2 powyżej). Przełączaj każdą metodę włącz/wyłącz według potrzeb.

Po zapisaniu klucza API prześlij każdy moduł metody płatności osobno przez Upload a module.

Wróć do Improve > Module Manager, kliknij ponownie Upload a module i prześlij każdy plik ZIP dla metod płatności, które chcesz włączyć (np. Credit Card, MobilePay, Swish).

Moduły płatności będą miały opcję Configure (jeśli wymagana jest dodatkowa konfiguracja) lub tylko przełącznik włącz/wyłącz.

Po zapisaniu klucza API prześlij każdy moduł metody płatności osobno przez Upload a module.

Wróć do Improve > Module Manager, kliknij ponownie Upload a module i prześlij każdy plik ZIP dla metod płatności, które chcesz włączyć (np. Credit Card, MobilePay, Swish).

Moduły płatności będą miały opcję Configure (jeśli wymagana jest dodatkowa konfiguracja) lub tylko przełącznik włącz/wyłącz.

Metody płatności przełącza się bezpośrednio na stronie konfiguracji modułu (patrz krok 2 powyżej). Włącz każdą metodę, którą chcesz mieć dostępną w kasie.

Webhook

URL webhooka jest automatycznie konfigurowany dla każdego zamówienia:

https://your-shop.com/module/nopaynpayment/webhook

Ręczne przechwycenie

Gdy włączone dla płatności kartą:

• Płatność jest autoryzowana, ale nie przechwycona w kasie
• Przechwycenie następuje, gdy zamówienie jest wysłane / oznaczone jako zrealizowane
• Jeśli zamówienie zostanie anulowane, autoryzacja jest automatycznie anulowana

Automatyczny zwrot

Jeśli zamówienie z przechwycona płatnością zostanie anulowane, moduł automatycznie dokonuje pełnego zwrotu. Częściowe zwroty mogą być przetwarzane za pośrednictwem korekt PrestaShop.

Etykiety przycisków kasy

Dla najlepszego doświadczenia użytkownika z przepływem przekierowania na zewnętrzną stronę, rozważ zmianę etykiety przycisku kasy na „Przejrzyj zamówienie" zamiast „Potwierdź i zapłać", ponieważ faktyczna płatność odbywa się na hostowanej stronie Cost+. To jest globalne ustawienie PrestaShop, nie ustawienie modułu.

Webhook

Webhook jest automatycznie konfigurowany przez moduł. Ręczna konfiguracja nie jest wymagana.

Webhook

Webhook jest automatycznie konfigurowany przez moduł. Ręczna konfiguracja nie jest wymagana.

Webhook

Strona konfiguracji modułu wyświetla adres URL webhooka. Skopiuj go do panelu Cost+ jeśli twoje konto Cost+ wymaga statycznej rejestracji webhooka.

Endpoint webhooka odbiera zdarzenia Cost+, a następnie ponownie wywołuje Cost+ przy użyciu GET /orders/{id} przed aktualizacją zamówienia w PrestaShop — dzięki temu obsługa adresu URL powrotu i webhooka jest idempotentna.

Cron wygaśnięcia

Strona konfiguracji modułu wyświetla adres URL cron-a wygaśnięcia. Zaplanuj go do uruchamiania co minutę:

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Użyj dokładnego adresu URL wyświetlanego w panelu administracyjnym PrestaShop — token jest generowany podczas instalacji i jest inny dla każdego sklepu. Endpoint cron-a anuluje przestarzałe oczekujące zamówienia Cost+ po skonfigurowanym Checkout Expiry.

Ręczne przechwycenie i zwroty

• Przy włączonym Manual Capture płatności są autoryzowane w kasie i przechwytywane, gdy zamówienie jest wysłane / oznaczone jako zrealizowane
• Jeśli przechwycone zamówienie zostanie anulowane, moduł automatycznie wykonuje pełny zwrot
• Częściowe zwroty są przetwarzane za pośrednictwem korekt PrestaShop