Shopware

Integracja Cost+ ze sklepem Shopware 6 za pomocą oficjalnej wtyczki płatności

Zintegruj Cost+ jako metodę płatności w swoim sklepie Shopware 6. Oficjalna wtyczka NoPayn Payment obsługuje wiele metod płatności dla każdego kanału sprzedaży i korzysta z hostowanej strony płatności — w pełni zgodna z PCI DSS.

Wymagania wstępne

Aktywne konto sprzedawcy Cost+
Shopware 6.7 lub nowszy
PHP 8.2 lub nowszy
Dostęp SSH lub do terminala na serwerze Shopware

Obsługiwane metody płatności

Nazwa w kasie	Nazwa techniczna	Identyfikator NoPayn
Credit / Debit Card	`nopayn_credit_card`	`credit-card`
Apple Pay	`nopayn_apple_pay`	`apple-pay`
Google Pay	`nopayn_google_pay`	`google-pay`
Vipps MobilePay	`nopayn_vipps_mobilepay`	`vipps-mobilepay`

Każda metoda może być włączona lub wyłączona dla każdego kanału sprzedaży z poziomu konfiguracji wtyczki.

1. Zainstaluj wtyczkę

Sklonuj lub skopiuj wtyczkę do katalogu custom/plugins/ Shopware:

cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPayment

Następnie zainstaluj i aktywuj za pomocą CLI Shopware:

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

2. Skonfiguruj wtyczkę

W panelu Shopware przejdź do Settings → Extensions → NoPayn Payment
Wprowadź klucz API z portalu sprzedawcy — przejdź do Strony, kliknij na stronę, którą chcesz połączyć, następnie kliknij Integracja, aby znaleźć klucz API
Przełącz poszczególne metody płatności włącz/wyłącz
Zapisz

Portal sprzedawcy Cost+ pokazujący klucz API

Możesz skonfigurować inny klucz API dla każdego kanału sprzedaży, jeśli prowadzisz wiele sklepów.

Aktywuj tylko te metody płatności, na które uzyskałeś zgodę i potwierdzenie.

3. Przepływ płatności

Klient wybiera metodę płatności w kasie i składa zamówienie
Zamówienie jest tworzone ze statusem transakcji in_progress
Klient jest przekierowywany na hostowaną stronę płatności NoPayn
Po płatności:
- Sukces — klient wraca, status weryfikowany przez API, transakcja ustawiona na paid, zamówienie na processing
- Anulowane — klient wraca, transakcja i zamówienie ustawione na cancelled
- Wygasłe (limit 5 minut) — webhook uruchamia się, transakcja i zamówienie ustawione na cancelled

4. Mapowanie statusów zamówień

Status NoPayn	Stan transakcji	Stan zamówienia
`new`	in_progress	open
`processing`	in_progress	open
`completed`	paid	in_progress
`cancelled`	cancelled	cancelled
`expired`	cancelled	cancelled
`error`	cancelled	cancelled

5. Webhooki

Wtyczka automatycznie rejestruje punkt końcowy webhooka pod adresem /api/nopayn/webhook. Ten URL jest wysyłany do NoPayn podczas tworzenia zamówień, zapewniając asynchroniczne potwierdzenie statusu dla wszystkich transakcji.

Ręczna konfiguracja webhooka nie jest wymagana — wtyczka obsługuje rejestrację automatycznie.

6. Przetestuj i uruchom

Złóż kilka testowych zamówień, aby upewnić się, że wszystko działa poprawnie. Zalecamy testowanie zarówno udanych, jak i nieudanych płatności, aby potwierdzić prawidłową obsługę wszystkich scenariuszy.

Wsparcie

Potrzebujesz pomocy? Skontaktuj się z naszym zespołem wsparcia pod adresem support@costplus.io.

On this page