CS-Cart
Oficjalny add-on dpay.pl dla CS-Cart. Umożliwia przyjmowanie płatności online w sklepie internetowym opartym na platformie CS-Cart. Obsługuje przelewy bankowe, karty płatnicze, PayPal, Paysafecard i raty.
Wymagania
- CS-Cart 4.10.1 lub nowszy
- PHP 7.4 lub nowszy
- Aktywne konto w Panelu dpay.pl z utworzonym Punktem Płatności
Obsługiwane metody płatności
- Przelewy bankowe (pay-by-link)
- Karty płatnicze (inline)
- BLIK (w tym BLIK Level 0 - inline)
- Google Pay i Apple Pay
- PayPal
- Paysafecard
- Raty (BLIK BNPL)
Instalacja
- Pobierz pliki add-onu ze strony dpay.pl lub z GitHuba.
- Skopiuj zawartość paczki do katalogu głównego CS-Cart, zachowując strukturę katalogów:
app/addons/dpay/- pliki add-onu (addon.xml, payments, controllers, lib)design/backend/templates/addons/dpay/- szablony panelu administracyjnegodesign/themes/responsive/templates/addons/dpay/- szablony frontendujs/addons/dpay/- pliki JavaScriptvar/langs/pl/addons/dpay.po- tłumaczenia polskievar/langs/en/addons/dpay.po- tłumaczenia angielskie
- Zaloguj się do panelu administracyjnego CS-Cart.
- Przejdź do Add-ons > Manage add-ons.
- Znajdź na liście dpay.pl i kliknij Install.
Konfiguracja
Krok 1 - Przygotowanie danych w Panelu dpay.pl
- Zaloguj się do Panelu dpay.pl.
- Przejdź do sekcji Punkty Płatności.
- Utwórz nowy Punkt Płatności lub wybierz istniejący.
- Zanotuj:
- Nazwa serwisu (
service_name) - unikalna nazwa Twojego Punktu Płatności - Tajny hash (
secret_hash) - klucz używany do podpisywania żądań
- Nazwa serwisu (
- W ustawieniach Punktu Płatności ustaw adres IPN na:
https://twoj-sklep.pl/index.php?dispatch=payment_notification.dpay&mode=ipn
Ważne
Tajny hash powinien być traktowany jak hasło. Nigdy nie udostępniaj go publicznie ani nie umieszczaj w kodzie frontendowym.
Krok 2 - Konfiguracja metody płatności
- Przejdź do Administration > Payment methods w panelu CS-Cart.
- Kliknij + (dodaj nową metodę płatności).
- Na zakładce General ustaw:
- Name - nazwa widoczna dla klienta (np. Płatność online - dpay.pl)
- Processor - wybierz dpay.pl
- Na zakładce Configure wypełnij formularz:
| Pole | Opis |
|---|---|
| Nazwa punktu płatności | Nazwa serwisu z Panelu dpay.pl |
| Klucz HASH | Tajny hash z Panelu dpay.pl |
| PayPal | Włącz/wyłącz płatności PayPal |
| Karty płatnicze | Włącz/wyłącz płatności kartą |
| Paysafecard | Włącz/wyłącz płatności Paysafecard |
| Raty | Włącz/wyłącz płatności ratalne |
| Brak banków | Ukryj listę banków |
| BLIK Zero | Włącz płatności BLIK Level 0 (inline) |
| Apple Pay | Włącz płatności Apple Pay |
| Google Pay | Włącz płatności Google Pay |
| Karta inline | Włącz formularz karty inline |
| Status po opłaceniu | Status zamówienia po udanej płatności |
| Status po błędzie | Status zamówienia po nieudanej płatności |
- Zapisz konfigurację.
Krok 3 - Weryfikacja
- Złóż testowe zamówienie w sklepie.
- Wybierz dpay.pl jako metodę płatności.
- Sprawdź, czy następuje poprawne przekierowanie na stronę płatności.
- Po dokonaniu płatności sprawdź, czy status zamówienia w CS-Cart zmienił się na wybrany status opłacenia.
Zwroty
Add-on nie obsługuje automatycznych zwrotów z poziomu panelu CS-Cart. Zwroty należy wykonywać bezpośrednio z Panelu dpay.pl lub za pomocą API dpay.pl.
Mapowanie statusów
| Status dpay.pl | Status CS-Cart |
|---|---|
| Nowa transakcja | Open (O) |
completed | Processed (P) lub wybrany status |
| Błąd płatności | Failed (F) |
Rozwiązywanie problemów
Zamówienia nie zmieniają statusu automatycznie
- Sprawdź, czy adres IPN jest prawidłowo ustawiony w Panelu dpay.pl.
- Upewnij się, że adres
dispatch=payment_notification.dpay&mode=ipnjest dostępny publicznie. - Sprawdź logi CS-Cart w katalogu
var/logs/.
Błąd waluty
- Add-on obsługuje wyłącznie walutę PLN. Upewnij się, że waluta zamówienia to PLN.
Błąd "BAD SIGNATURE"
- Upewnij się, że Klucz HASH w konfiguracji metody płatności jest identyczny z hashem w Panelu dpay.pl.
Add-on nie pojawia się na liście procesorów
- Sprawdź, czy add-on dpay jest zainstalowany i aktywny w Add-ons > Manage add-ons.
- Upewnij się, że minimalna wersja CS-Cart to 4.10.1.