Bezpłatna 15-minutowa konsultacja bezpośrednio z naszymi ekspertami.
Wtyczka Square Payments dla Shopware 6 pozwala zintegrować bezpieczną i niezawodną obsługę płatności Square bezpośrednio ze sklepem internetowym. Dzięki niej mogą Państwo zapewnić klientom płynny, znajomy proces zamówienia, a jednocześnie korzystać z infrastruktury płatniczej Square, ochrony przed nadużyciami i zarządzania transakcjami. Wtyczka została zaprojektowana tak, aby naturalnie wpisywać się w ekosystem Shopware i włączać obsługę płatności w codzienną pracę sklepu bez dodatkowych narzędzi.
Ważne dla firm z Polski: według Square akceptacja płatności kartą jest obecnie dostępna w USA, Kanadzie, Australii, Japonii, Wielkiej Brytanii, Irlandii, Francji i Hiszpanii. Polski nie ma na tej liście. Wtyczka ma więc znaczenie przede wszystkim dla polskich firm, które sprzedają przez podmiot zarejestrowany w jednym z tych krajów, oraz dla zespołów deweloperskich w Polsce, które przygotowują rozszerzenia na Shopware Marketplace. Przy sprzedaży krajowej w Polsce standardem są raczej BLIK, Przelewy24 i PayU.
Zanim wtyczka zostanie zgłoszona do Shopware Marketplace, trzeba upewnić się, że spełnia wszystkie wytyczne techniczne i standardy jakości. Shopware wymaga, aby każde rozszerzenie przeszło ustrukturyzowany proces walidacji, który potwierdza bezpieczeństwo, stabilność i kompatybilność z platformą. Na tym etapie kluczowym elementem pracy staje się Shopware CLI Extension Verifier.
Ten poradnik pokazuje w praktyce, jak zainstalować wtyczkę Square Payments przez Packagist i jak uruchomić lokalnie Shopware Extension Verifier. Wykonując poniższe kroki, deweloperzy i sprzedawcy mogą sprawdzić, czy wtyczka jest poprawnie zbudowana, zgodna z wymaganiami Marketplace i gotowa do zgłoszenia. Staranna weryfikacja nie tylko przyspiesza akceptację, ale także zapewnia klientom końcowym niezawodne i profesjonalne działanie płatności.
Packagist
composer require solution25/square-payments
Aby sprawdzić, czy wtyczka spełnia wymagania Shopware Marketplace, mogą Państwo użyć Shopware CLI Extension Verifier.
Proszę przejść do katalogu wtyczki:
Na przykład, jeśli wtyczka znajduje się w folderze custom:
custom/plugins/square-payments-shopware-6-solution25
cd custom/plugins/square-payments-shopware-6-solution25
Aby zwalidować rozszerzenie, mogą Państwo użyć następującego polecenia:
Docker:
docker run --rm -v $(pwd):/ext ghcr.io/shopware/shopware-cli extension validate --full /ext
Lub bez Dockera:
shopware-cli extension validate /path/to/your/extension
Więcej szczegółów znajdą Państwo w dokumentacji Shopware: Shopware CLI Extension Verifier
Uruchomienie Shopware Extension Verifier pozwala upewnić się, że wtyczka spełnia wszystkie wymagania Shopware Marketplace. Należą do nich:
Pracując z wtyczką Square Payments, zdecydowanie zalecamy, aby proces instalacji i walidacji zawsze testować najpierw w osobnym środowisku deweloperskim lub stagingowym, a dopiero potem przenosić zmiany do sklepu produkcyjnego. Dzięki temu ewentualne problemy wychodzą na jaw wcześnie i nie dotykają prawdziwych klientów ani transakcji. Ważną dobrą praktyką jest też korzystanie z systemu kontroli wersji, takiego jak Git: zmiany pozostają przejrzyste, aktualizacjami łatwiej zarządzać, a historia wszystkich modyfikacji wtyczki jest czytelna. Po uruchomieniu Shopware Extension Verifier warto dokładnie przeanalizować wszystkie ostrzeżenia, błędy i rekomendacje. Usunięcie krytycznych problemów przed zgłoszeniem wtyczki wyraźnie zwiększa szansę na sprawną akceptację.
Jeśli verifier jest uruchamiany przez Dockera, należy zadbać o to, aby kontener miał niezbędne uprawnienia i dostęp do plików wtyczki. Pozwala to uniknąć błędów walidacji wynikających z ograniczeń systemu plików. Stosowanie tych zasad sprawia, że weryfikacja i instalacja przebiegają bardziej niezawodnie, w uporządkowany sposób i bez błędów.
Poprawna instalacja i gruntowna weryfikacja to kluczowe kroki, aby z powodzeniem wdrożyć wtyczkę Square Payments i przygotować ją do zgłoszenia w Shopware Marketplace. Postępując zgodnie z opisanym procesem, mają Państwo pewność, że wtyczka jest prawidłowo zainstalowana, zbudowana zgodnie z wymaganiami Shopware i w pełni zgodna z wytycznymi Marketplace. Shopware Extension Verifier pomaga wcześnie wykryć potencjalne problemy, uniknąć błędów technicznych i zapewnić, że rozszerzenie spełnia wymagane standardy jakości. Przyspiesza to akceptację i przekłada się na stabilniejszą, bardziej profesjonalną integrację dla sprzedawców i klientów.
Staranna walidacja i optymalizacja wtyczki prowadzą w efekcie do bezpiecznego, niezawodnego rozwiązania płatniczego, które trwale poprawia doświadczenie zakupowe w Shopware 6. Jeśli planują Państwo integrację płatności w Shopware 6 dla sklepu w Polsce lub dla sprzedaży zagranicznej, zespół solution25 chętnie pomoże dobrać odpowiednich dostawców i przeprowadzi wdrożenie: +49 421 438 1919-0.