Cost+Docs

PrestaShop

Integracja Cost+ ze sklepem PrestaShop (9.x, 8.x i 1.7)

PrestaShop

Zintegruj Cost+ jako metodę płatności w swoim sklepie PrestaShop. Moduł Cost+ jest dostępny dla PrestaShop 9.x, PrestaShop 8.x i PrestaShop 1.7.

Wymagania wstępne

  • 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

1. Zainstaluj moduł

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+

PrestaShop 8 Module Manager

Okno dialogowe przesyłania modułu

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+

PrestaShop 1.7 Module Manager

Okno dialogowe przesyłania modułu

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

2. Wprowadź dane uwierzytelniające API

Zaloguj się do portalu sprzedawcy i przejdź do sekcji Strony, następnie kliknij na stronę, którą chcesz połączyć. Kliknij Integracja, aby znaleźć swój klucz API.

Portal sprzedawcy Cost+ pokazujący klucz API

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

UstawienieOpis
API KeyTwój klucz API NoPayn
Credit / Debit CardWłącz/wyłącz płatności kartą
Apple PayWłącz/wyłącz Apple Pay
Google PayWłącz/wyłącz Google Pay
Vipps MobilePayWłącz/wyłącz Vipps MobilePay
Manual CaptureAutoryzuj płatności kartą bez natychmiastowego przechwycenia — pobierz środki przy wysyłce
Debug LoggingWłącz szczegółowe logowanie do var/logs/nopayn_debug.log

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

Strona konfiguracji Cost+ w PrestaShop 8

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

Strona konfiguracji Cost+ w PrestaShop 1.7

W środowiskach hostingowych PrestaShop 8.x i 1.7 włącz opcję cURL CA bundle podczas konfiguracji, aby uniknąć problemów z certyfikatami SSL.

3. Włącz metody płatności

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.

Aktywuj tylko te metody płatności, na które uzyskałeś zgodę i potwierdzenie.

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

Aktywuj tylko te metody płatności, na które uzyskałeś zgodę i potwierdzenie.

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

Aktywuj tylko te metody płatności, na które uzyskałeś zgodę i potwierdzenie.

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.

Przepływ płatności

  1. Klient wybiera metodę płatności Cost+ w kasie
  2. Klient jest przekierowywany na hostowaną stronę płatności Cost+ (HPP)
  3. Po zakończeniu płatności klient jest przekierowywany z powrotem do sklepu
  4. Webhook potwierdza status płatności serwer-serwer

Webhook

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

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

Ręczna konfiguracja webhooka nie jest wymagana — moduł obsługuje rejestrację automatycznie.

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.

4. Ostatnie kroki i testowanie

  1. Sprawdź dokładnie wszystkie włączone metody płatności
  2. Złóż kilka testowych zamówień -- zarówno udanych, jak i nieudanych -- aby upewnić się, że wszystko działa poprawnie
  3. Skonfiguruj zaawansowane zachowanie, takie jak ręczne vs. automatyczne przechwytywanie, w zależności od procesu realizacji zamówień

Wsparcie

Potrzebujesz pomocy? Skontaktuj się z naszym zespołem wsparcia pod adresem support@costplus.io.

WooCommerce

Integracja Cost+ ze sklepem WooCommerce za pomocą oficjalnej wtyczki WordPress

Magento

Integracja Cost+ ze sklepem Magento (2.x i 1.9 / OpenMage LTS)

On this page

Wymagania wstępne1. Zainstaluj modułMetoda A: Przesłanie przez panel administracyjny (zalecana)Metoda B: Ręczne przesłanieMetoda A: Przesłanie przez panel administracyjny (zalecana)Metoda B: Ręczne przesłanie przez (S)FTPMetoda A: Przesłanie przez panel administracyjny (zalecana)Metoda B: Ręczne przesłanie przez (S)FTP2. Wprowadź dane uwierzytelniające API3. Włącz metody płatnościPrzepływ płatnościWebhookRęczne przechwycenieAutomatyczny zwrotEtykiety przycisków kasyWebhookWebhook4. Ostatnie kroki i testowanieWsparcie