DocsOpenCart
Integracja Cost+ ze sklepem OpenCart (4.x i 3.x / ocStore 3)
Zintegruj Cost+ jako metodę płatności w swoim sklepie OpenCart. Oficjalne rozszerzenie NoPayn Payment Gateway jest dostępne dla OpenCart 4 i OpenCart 3 / ocStore 3.
Wymagania wstępne
- Aktywne konto sprzedawcy Cost+
- OpenCart 4.0.0.0 lub nowszy
- PHP 8.0 lub nowszy
- Dostęp administratora do panelu OpenCart
- Aktywne konto sprzedawcy Cost+
- ocStore 3.0.x lub OpenCart 3.0.3.x
- PHP 7.4 lub nowszy
- Dostęp administratora do panelu OpenCart
Obsługiwane metody płatności
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Swish
1. Zainstaluj rozszerzenie
Metoda A: Przesłanie przez panel administracyjny (zalecana)
- Pobierz najnowsze wydanie
.ocmod.zipz GitHub - W panelu OpenCart przejdź do Extensions → Installer
- Prześlij plik
.ocmod.zip - Przejdź do Extensions → Extensions → Payment
- Znajdź NoPayn Payment Gateway i kliknij Install, a następnie Edit
Metoda B: Ręczne przesłanie
- Pobierz lub sklonuj repozytorium
- Skopiuj zawartość folderu
upload/do katalogu głównego OpenCart - Przejdź do Extensions → Extensions → Payment
- Znajdź NoPayn Payment Gateway i kliknij Install, a następnie Edit
Architektura
OpenCart 3 wykorzystuje konfigurację wielorozszerzeniową:
- NoPayn - Global Settings — współdzielona konfiguracja (klucz API, statusy zamówień, dostępność metod, ręczne przechwycenie, logowanie debugowania)
- NoPayn - Card Payments — płatności kartą kredytową/debetową w kasie
- NoPayn - Apple Pay / Google Pay — płatności portfelem (jeśli włączony jest tylko jeden portfel, etykieta dostosowuje się automatycznie)
- NoPayn - Vipps MobilePay — płatności Vipps/MobilePay w kasie
- NoPayn - Swish — płatności Swish w kasie
Metoda A: Przesłanie przez panel administracyjny (zalecana)
- Pobierz zasób
.ocmod.zipz najnowszego wydania GitHub
Użyj zasobu .ocmod.zip z wydania — nie automatycznie generowanych archiwów „Source code" z GitHub, które zawierają układ repozytorium, a nie układ instalatora.
- W panelu przejdź do Extensions → Installer
- Prześlij plik
.ocmod.zip - Przejdź do Extensions → Extensions → Payments
- Najpierw zainstaluj NoPayn - Global Settings
- Otwórz NoPayn - Global Settings i skonfiguruj:
- Klucz API
- Statusy zamówień: zrealizowane, oczekujące i anulowane
- Dostępne metody płatności zatwierdzone dla Twojego konta sprzedawcy
- Opcjonalnie: ręczne przechwycenie karty
- Opcjonalnie: logowanie debugowania
- Zainstaluj moduły kasy, które chcesz udostępnić:
- NoPayn - Card Payments
- NoPayn - Apple Pay / Google Pay
- NoPayn - Vipps MobilePay
- NoPayn - Swish
- Dla każdego modułu kasy ustaw: Status, Geo Zone i Sort Order
Metoda B: Ręczne przesłanie
- Pobierz lub sklonuj repozytorium
- Skopiuj zawartość folderu
upload/do katalogu głównego sklepu - Przejdź do Extensions → Extensions → Payments
- Postępuj zgodnie z tą samą kolejnością instalacji jak w Metodzie A (najpierw Global Settings, potem moduły kasy)
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.
W ustawieniach NoPayn Payment Gateway wprowadź klucz API w odpowiednim polu.
W NoPayn - Global Settings wprowadź klucz API w odpowiednim polu. Klucz API jest współdzielony przez wszystkie moduły kasy — wystarczy go wprowadzić raz.
3. Skonfiguruj ustawienia płatności
- Włącz metody płatności, na które uzyskałeś zgodę
- Ustaw preferowane statusy zamówień dla zrealizowanych, oczekujących i anulowanych płatności
- Opcjonalnie ogranicz płatności według Geo Zone
- Ustaw Status na Enabled
- Kliknij Save
Ustawienia globalne
NoPayn - Global Settings przechowuje całą współdzieloną konfigurację:
| Ustawienie | Opis |
|---|---|
| API Key | Twój klucz API NoPayn |
| Order Statuses | Mapowanie statusów: zrealizowane, oczekujące i anulowane |
| Method Availability | Które metody płatności są zatwierdzone dla Twojego konta sprzedawcy |
| Manual Capture | Autoryzuj płatności kartą — przechwytuj później |
| Debug Logging | Włącz szczegółowe logowanie do rozwiązywania problemów |
Ustawienia modułu kasy
Każdy moduł kasy ma własne ustawienia sklepu:
| Ustawienie | Opis |
|---|---|
| Status | Włącz lub wyłącz tę metodę płatności w kasie |
| Geo Zone | Ogranicz do określonych stref geograficznych |
| Sort Order | Kolejność wyświetlania na stronie kasy |
Aktywuj tylko te metody płatności, na które uzyskałeś zgodę i potwierdzenie.
Przepływ płatności
- Klient wybiera metodę płatności Cost+ w kasie
- Klient jest przekierowywany na hostowaną stronę płatności NoPayn
- Po płatności klient wraca, a status zamówienia jest automatycznie aktualizowany
- NoPayn wysyła webhook do asynchronicznego potwierdzenia statusu
Rozszerzenie korzysta z hostowanej strony płatności Cost+, co oznacza, że klienci są przekierowywani na bezpieczny formularz płatności. Żadne wrażliwe dane karty nie są obsługiwane przez Twój serwer.
Każdy moduł kasy jest osobnym rozszerzeniem płatności OpenCart, dając klientom oddzielne opcje radiowe w kasie (np. „Card Payments", „Apple Pay & Google Pay").
- Klient wybiera etykietę metody płatności w kasie (np. Card Payments)
- Rozszerzenie tworzy hostowane zamówienie płatności NoPayn
- Klient jest przekierowywany na bezpieczną stronę płatności NoPayn
- Po płatności klient wraca, a status zamówienia jest automatycznie aktualizowany
- NoPayn wysyła webhook do asynchronicznego potwierdzenia statusu
Moduł Apple Pay / Google Pay wysyła obie metody w jednej transakcji, dzięki czemu hostowana strona NoPayn może oferować oba portfele w jednym przepływie.
Aktualizacja z v1.0.0 do v2.0.0
Wersja 1.0.0 używała jednej metody kasy o nazwie „NoPayn Checkout". Wersja 2.0.0 zmienia to na oddzielne moduły kasy dla każdej metody płatności. Podczas aktualizacji:
- Prześlij nowy pakiet
- Istniejący wpis „NoPayn Checkout" staje się NoPayn - Global Settings
- Przejrzyj i zapisz ustawienia globalne
- Zainstaluj i włącz nowe moduły kasy, które klienci mają widzieć
4. Przetestuj i uruchom
Złóż kilka testowych zamówień, aby upewnić się, że wszystko działa poprawnie. Zalecamy testowanie zarówno udanych, jak i nieudanych płatności, aby potwierdzić prawidłową obsługę wszystkich scenariuszy.
Wsparcie
Potrzebujesz pomocy? Skontaktuj się z naszym zespołem wsparcia pod adresem support@costplus.io.