README

PayNow dla Shopware 6 — by CREHLER

Integracja bramki płatniczej PayNow (operator płatności mBanku) ze sklepem Shopware 6.
BLIK (w tym Level 0), płatność kartą, pay-by-link oraz zwroty z panelu administratora.

Czym jest Shopware?

Shopware 6 to nowoczesna platforma e-commerce open source, na której działają tysiące sklepów internetowych w Europie. Daje pełną kontrolę nad wyglądem sklepu, procesem zakupowym i integracjami, a jej modułowa architektura pozwala rozszerzać sklep o wtyczki — takie jak ta integracja PayNow.

Shopware działa też w modelu headless — całą logikę sklepu udostępnia przez Store API, dzięki czemu warstwę zakupową można zbudować na dowolnym froncie (np. aplikacja Nuxt/PWA, aplikacja mobilna), niezależnie od wbudowanego Storefrontu. Ta wtyczka obsługuje oba światy — działa zarówno w klasycznym Storefroncie, jak i w pełni przez Store API (w tym dedykowany endpoint dla BLIK Level 0), więc sprawdzi się także w sklepach headless.

O wtyczce

Bramka płatności PayNow by CREHLER podłącza polską bramkę płatniczą PayNow — operatora płatności mBanku — do Twojego sklepu Shopware 6. Klient płaci tak, jak lubi — kodem BLIK bez wychodzenia ze sklepu, kartą albo szybkim przelewem pay-by-link — a sklep automatycznie otrzymuje potwierdzenie płatności i aktualizuje status zamówienia. Zwroty wykonasz jednym kliknięciem z panelu Shopware.

✨ Funkcje

• 🟢 BLIK Level 0 — klient wpisuje 6-cyfrowy kod BLIK bezpośrednio w sklepie i płaci bez przekierowania do bramki.
• 💳 Płatność kartą — z przekierowaniem na bezpieczną, hostowaną stronę PayNow (z obsługą 3-D Secure). Dane karty wpisywane są wyłącznie po stronie PayNow i nigdy nie trafiają do sklepu — to model w pełni hostowany, najniższy zakres wymogów PCI DSS (typowo SAQ A).
• 🔁 Zapisane karty (tokeny) — klient może zapisać kartę do kolejnych zakupów; płatność finalizuje się tokenem po stronie PayNow.
• 🏦 Pay-by-link (przelewy bankowe) — klient wybiera swój bank z listy i płaci szybkim przelewem online; wybrany bank zostaje zapamiętany, więc przy kolejnych zamówieniach płaci jednym kliknięciem.
• ↩️ Zwroty z panelu administratora — zwroty pieniędzy (płatności) klientowi, w całości lub częściowo, bez logowania do panelu PayNow.
• 🎚️ Konfigurowalny checkout — wybór pozycji pola BLIK (w checkout / osobna strona / ukryte) oraz wyświetlania sekcji karty.

💳 Metody płatności

	Metoda	Opis
	BLIK	Płatność kodem BLIK w sklepie (Level 0) lub z przekierowaniem.
	Karta	Visa / Mastercard — przekierowanie na bezpieczną stronę PayNow, 3-D Secure, zapis karty.
	Przelew (pay-by-link)	Wybór banku z listy i szybki przelew online.

✅ Wymagania

🚀 Szybka instalacja

To skrócony przebieg (Composer). Pełna instrukcja — Composer oraz paczka ZIP, krok po kroku — znajduje się w docs/instalacja.md.

1. Zainstaluj wtyczkę przez Composer:

composer require crehler/pay-now

2. Aktywuj w Shopware:

bin/console plugin:refresh
bin/console plugin:install --activate CrehlerPayNow
bin/console cache:clear

3. Uzupełnij dane w konfiguracji wtyczki — panel admina → Rozszerzenia → Moje rozszerzenia → Bramka płatności PayNow by CREHLER → Skonfiguruj:

• Klucz dostępu do API i Klucz obliczania podpisu — z panelu PayNow: Ustawienia → Sklepy i punkty płatności → wybierz sklep,
• na koniec kliknij przycisk testu połączenia, aby zweryfikować dane.

💡 Do testów włącz Tryb sandbox i podaj dane z testowego konta PayNow.

📚 Pełna dokumentacja → docs/ — konfiguracja krok po kroku, metody płatności, Store API (headless), zwroty i dane testowe (sandbox) — ze zrzutami ekranu.

🛟 Wsparcie

Masz pytanie lub problem? Napisz do nas: support@crehler.com

O CREHLER

CREHLER — Twój partner w e-commerce.

Tworzymy i rozwijamy sklepy internetowe na Shopware, budujemy dedykowane integracje, wtyczki i headless‑owe frontendy (Nuxt). Robimy integracje ERP, WMS, płatności i dostaw, a także customowe konfiguratory, kalkulatory i inne rozszerzenia szyte na miarę Twojego sklepu.

Potrzebujesz wdrożenia, integracji albo dedykowanej funkcji w swoim sklepie? Porozmawiajmy → crehler.com

📄 Licencja

Oprogramowanie własnościowe (proprietary). © Crehler Sp. z o.o. Wszelkie prawa zastrzeżone.