Magento

• Aktywne konto sprzedawcy Cost+
• Instalacja Magento 2.4.6 -- 2.4.8
• PHP 8.2 -- 8.4
• Dostęp administratora do panelu Magento
• Dostęp SSH do serwera (do instalacji przez Composer)

• Aktywne konto sprzedawcy Cost+
• Magento 1.9.x lub OpenMage LTS 20+
• PHP 7.4 lub nowszy
• Dostęp administratora do panelu Magento
• Dostęp SSH lub FTP do serwera

Metoda A: Instalacja przez Composer (zalecana)

Połącz się z serwerem Magento przez SSH i przejdź do katalogu głównego Magento.

Zainstaluj wtyczkę:

composer require nopayn/nopayn-magento-2

Uruchom polecenia konfiguracji Magento:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Jeśli pracujesz w trybie produkcyjnym, uruchom również:

php bin/magento setup:static-content:deploy

Metoda B: Instalacja ręczna

1. Przejdź do katalogu app/code
2. Pobierz i rozpakuj wydanie Cost+ z GitHub
3. Uruchom polecenia konfiguracji:

php bin/magento setup:upgrade
php bin/magento cache:clean

Jeśli w trybie produkcyjnym:

php bin/magento setup:static-content:deploy

Pobierz lub sklonuj moduł z GitHub.

Skopiuj zawartość app/ do katalogu głównego app/ Twojego Magento:

cp -r app/* /path/to/magento/app/

Wyczyść pamięć podręczną Magento:

rm -rf var/cache/*

Zaloguj się do panelu administracyjnego Magento i przejdź do System → Configuration → Sales → Payment Methods, aby sprawdzić, czy sekcja NoPayn Payment Gateway jest widoczna.

1. Przejdź do Stores → Configuration → Sales → Payment Methods → Cost+ Payments
2. Wprowadź swój klucz API (patrz krok 3 poniżej)
3. Włącz metody płatności, na które uzyskałeś zgodę
4. Zapisz zmiany

1. Przejdź do System → Configuration → Sales → Payment Methods
2. Znajdź sekcję NoPayn Payment Gateway
3. Wprowadź swój klucz API (patrz krok 3 poniżej)
4. Włącz poszczególne metody płatności (karta kredytowa/debetowa, Apple Pay, Google Pay, Vipps MobilePay)
5. Opcjonalnie ogranicz według kraju
6. Zapisz konfigurację

1. Klient wybiera metodę płatności w kasie i składa zamówienie
2. Klient jest przekierowywany na hostowaną stronę płatności NoPayn
3. Po płatności klient wraca, a status zamówienia jest automatycznie aktualizowany
4. NoPayn wysyła webhook do asynchronicznego potwierdzenia statusu

1. Klient wybiera metodę płatności w kasie i składa zamówienie
2. Zamówienie jest tworzone ze statusem Pending Payment
3. Klient jest przekierowywany na bezpieczną stronę płatności NoPayn
4. Po płatności:
   • Sukces — klient wraca, status jest weryfikowany przez API, zamówienie ustawiane na Processing
   • Anulowane — klient wraca, zamówienie ustawiane na Canceled
   • Wygasłe (limit 5 minut) — webhook uruchamia się, zamówienie ustawiane na Canceled
5. NoPayn wysyła webhook do asynchronicznego potwierdzenia statusu

Mapowanie statusów zamówień

Webhooki

Moduł rejestruje punkt końcowy webhooka pod adresem /nopayn/payment/webhook. Ten URL jest automatycznie wysyłany do NoPayn podczas tworzenia zamówień. Webhook zawsze weryfikuje status zamówienia przez API NoPayn przed aktualizacją zamówienia Magento.