README

Tpay dla Shopware 6 — by CREHLER

Integracja bramki płatniczej Tpay ze sklepem Shopware 6.
BLIK (w tym Level 0), karty z formularzem w checkout, pay-by-link, 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 Tpay.

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 Tpay by CREHLER podłącza polską bramkę płatniczą Tpay do Twojego sklepu Shopware 6. Klient płaci tak, jak lubi — kodem BLIK bez wychodzenia ze sklepu, kartą, przelewem pay-by-link 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ą — domyślnie z przekierowaniem do bezpiecznej strony Tpay, a opcjonalnie z formularzem karty osadzonym wprost w checkout sklepu (dane szyfrowane kluczem RSA Tpay), z obsługą 3-D Secure.
• 🔁 Zapisane karty (tokeny) — klient może zapisać kartę do kolejnych zakupów; tokeny przechowywane w formie zaszyfrowanej.
• 🏦 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.
• 📅 Płatności odroczone / raty — wsparcie dla metod ratalnych Tpay.
• ↩️ Zwroty z panelu administratora — zwroty pieniędzy (płatności) klientowi, w całości lub częściowo, bez logowania do panelu Tpay.
• 🎚️ Konfigurowalny checkout — możliwość osadzenia formularza karty oraz wyboru pozycji pola BLIK (w checkout / osobna strona / ukryte).

💳 Metody płatności

	Metoda	Opis
	BLIK	Płatność kodem BLIK w sklepie (Level 0) lub z przekierowaniem.
	Karta	Visa / Mastercard — formularz w checkout lub redirect, 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/tpay

2. Aktywuj w Shopware:

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

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

• Client ID i Client Secret — z panelu Tpay: Integracja → API → Klucze Open API,
• Kod bezpieczeństwa powiadomień — Ustawienia → Powiadomienia → Bezpieczeństwo (wymagany, by potwierdzenia płatności były akceptowane),
• (opcjonalnie) Klucz publiczny Cards API — tylko jeśli chcesz osadzić formularz karty w checkout,
• na koniec kliknij „Testuj połączenie", aby zweryfikować dane.

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

📚 Pełna dokumentacja → docs/ — konfiguracja krok po kroku, metody płatności, webhooki, zwroty i rozwiązywanie problemów (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.