README

PayU dla Shopware 6 — by CREHLER

Integracja bramki płatniczej PayU ze sklepem Shopware 6.
BLIK (w tym Level 0), płatność kartą, pay-by-link, e-portfele, płatności odroczone (raty) 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 PayU.

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 PayU by CREHLER podłącza bramkę płatniczą PayU — jednego z wiodących operatorów płatności online w Polsce i regionie — do Twojego sklepu Shopware 6. Klient płaci tak, jak lubi — kodem BLIK bez wychodzenia ze sklepu, kartą, szybkim przelewem pay-by-link, e-portfelem albo na raty — 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ą stronę PayU (z obsługą 3-D Secure). Dane karty wpisywane są po stronie PayU i nie trafiają na serwer sklepu — 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 PayU.
• 🏦 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.
• 👛 E-portfele — szybkie metody portfelowe obsługiwane przez PayU.
• 🗓️ Płatności odroczone — raty PayU / „Kup teraz, zapłać później".
• ↩️ Zwroty z panelu administratora — zwroty pieniędzy klientowi, w całości lub częściowo, bez logowania do panelu PayU.
• 🎚️ Konfigurowalny checkout — wybór pozycji pola BLIK (w checkout / osobna strona / ukryte) oraz wyświetlania sekcji karty.

💳 Metody płatności

✅ 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/payu

2. Aktywuj w Shopware:

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

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

• Id punktu płatności (pos_id), Drugi klucz (MD5) oraz Protokół OAuth - client_id / client_secret — z panelu PayU: konfiguracja punktu płatności (POS),
• na koniec kliknij przycisk testu połączenia, aby zweryfikować dane.

💡 Do testów włącz Sandbox i podaj dane z testowego konta PayU.

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