Do czego służy wtyczka
Wtyczka dolicza do zamówienia procentową opłatę, ale tylko wtedy, gdy klient wybierze metodę płatności, która kosztuje Cię prowizję – np. kartę przez Stripe czy PayPal. Kto płaci przelewem albo przy odbiorze, nie płaci nic więcej.
Co potrafi
Opłata tylko przy wybranych metodach płatności
Wskazujesz metody, przy których opłata ma się naliczać. Na ekranie ustawień widzisz listę wszystkich metod płatności w Twoim sklepie razem z ich identyfikatorami, więc nie musisz ich nigdzie szukać.
Efekt: prowizję operatora pokrywa klient, który wybrał droższą metodę – a nie Twoja marża.
Procent od produktów i wysyłki
Opłata liczy się od wartości produktów po rabatach i od kosztu wysyłki, razem z podatkiem. Możesz wpisać ułamek procenta, np. 1,5%. Kwota jest zaokrąglana tak, jak ceny w Twoim sklepie.
Efekt: opłata rośnie razem z kwotą, od której operator płatności liczy swoją prowizję.
Czytelna nazwa w podsumowaniu
Nazwę pozycji ustawiasz sam, np. „Opłata za płatność kartą {rate}%” – w miejsce {rate} wtyczka wstawia procent. Przy sklepie wielojęzycznym nazwę przetłumaczysz w WPML (String Translation).
Efekt: klient od razu widzi, za co i ile dopłaca – bez niespodzianek przy płatności.
Klasyczna i blokowa kasa
Suma przelicza się od razu po zmianie metody płatności – zarówno w klasycznej kasie, jak i w nowej kasie blokowej WooCommerce.
Dobrze wiedzieć
- Opłata jest osobną pozycją w podsumowaniu kasy, w zamówieniu i w e-mailach do klienta.
- Opłata nie jest dodatkowo opodatkowana – liczy się od kwot, które już zawierają podatek.
- Wtyczka jest zgodna z HPOS (nowym zapisem zamówień WooCommerce).
Instalacja i pierwsze ustawienia
Zanim zaczniesz
Potrzebujesz WordPressa 6.2 lub nowszego, WooCommerce 8.0+ i PHP 7.4+ oraz konta administratora. Przed instalacją każdej nowej wtyczki zrób kopię zapasową sklepu – w większości paneli hostingowych to jeden przycisk.
Krok 1: pobierz wtyczkę i klucz licencyjny
Po zamówieniu (wersji Pro albo bezpłatnej wersji Free na 3 dni) dostajesz e-mail z kluczem licencyjnym i przyciskiem Pobierz. Ten sam klucz i plik znajdziesz zawsze w Moje konto → Licencje na wpasist.eu.
- Kliknij Pobierz i zapisz plik
payment-fee-for-woocommerce.zipna komputerze. - Nie rozpakowuj pliku – WordPress instaluje wtyczkę prosto z ZIP-a.
Safari na Macu potrafi sam rozpakować pobrany plik. Jeśli zamiast pliku ZIP widzisz folder, spakuj go z powrotem (prawy przycisk myszy → Kompresuj) albo wyłącz w Safari opcję otwierania „bezpiecznych” plików po pobraniu.
Krok 2: zainstaluj i włącz wtyczkę
- Zaloguj się do panelu WordPressa (zwykle
twojsklep.pl/wp-admin). - Wejdź w Wtyczki → Dodaj nową wtyczkę i kliknij Wyślij wtyczkę na serwer.
- Wybierz plik
payment-fee-for-woocommerce.zipi kliknij Zainstaluj. - Po komunikacie „Wtyczka została zainstalowana” kliknij Włącz wtyczkę.
Wynik: w menu po lewej masz pozycję wpAsist, a w niej tę wtyczkę i ekran Licencje.
Krok 3: aktywuj licencję
- Wejdź w wpAsist → Licencje.
- Przy tej wtyczce wklej klucz z e-maila i kliknij Aktywuj licencję.
- Status zmieni się na Aktywna do … (data końca licencji).
Bez aktywnej licencji opłata nie jest doliczana do zamówień. Ustawienia zostają zapisane i wracają do działania po aktywacji klucza.
Klucz działa na jednej domenie. Przeniesienie sklepu na inny adres zrobisz sam w Moje konto → Licencje → Zmień domenę na wpasist.eu. Nowe wersje wtyczki przychodzą w panelu jak każda aktualizacja WordPressa (Kokpit → Aktualizacje), dopóki licencja jest aktywna – ustawienia zostają bez zmian.
Krok 4: ustaw opłatę
Wejdź w wpAsist → Opłata za płatność, zakładka Ustawienia.
| Pole | Co oznacza | Przykład |
|---|---|---|
| Opłata | Włącza i wyłącza doliczanie opłaty. | zaznaczone |
| Wysokość opłaty (%) | Procent od produktów i wysyłki z podatkiem, od 0 do 100, z dokładnością do 0,01. | 1,5 |
| Metody płatności (ID) | Identyfikatory metod, przy których opłata się nalicza – każdy w osobnej linii. Pod polem widzisz listę metod Twojego sklepu z ich ID. | stripe |
| Nazwa opłaty w koszyku | Tekst pozycji w podsumowaniu; {rate} zamienia się na procent. | Opłata za płatność kartą {rate}% |
Kliknij Zapisz zmiany.
Po instalacji wpisane są przykładowe wartości: 0,7% i metody Stripe (stripe, stripe_eps, stripe_bancontact). Zamień je na swoje, zanim włączysz opłatę.
Krok 5: sprawdź w kasie
Złóż próbne zamówienie, najlepiej w oknie prywatnym przeglądarki:
- Dodaj produkt do koszyka i przejdź do kasy.
- Wybierz metodę płatności z listy – w podsumowaniu pojawia się pozycja z opłatą, a suma rośnie.
- Wybierz inną metodę, np. przelew – opłata znika.
Najczęstsze problemy
| Objaw | Co zrobić |
|---|---|
| Opłata się nie pojawia | Sprawdź, czy opłata jest włączona, procent jest większy od 0, a ID metody jest wpisane dokładnie tak jak na liście pod polem. Sprawdź też status licencji w wpAsist → Licencje. |
| Opłata nie zmienia się po zmianie metody | Wyłącz cache dla strony kasy w wtyczce cache (np. LiteSpeed, WP Rocket) – kasa nie może być zapisywana w pamięci podręcznej. |
| Nazwa opłaty jest w złym języku | Przetłumacz ją w WPML → Tłumaczenie ciągów (szukaj „Payment fee” albo swojej nazwy). |
Historia zmian (changelog)
1.0.3 – 2026-10-24
- Licencja: wtyczka przy sprawdzaniu klucza podaje swoją nazwę, więc klucz działa tylko we wtyczkach, które obejmuje (jedna wtyczka, pakiet albo All Access).
- wpAsist → Licencje: nowe „Użyj tego klucza we wszystkich wtyczkach wpAsist” – klucz pakietu lub All Access aktywuje się od razu we wszystkich wtyczkach; wtyczki, których klucz nie obejmuje, zachowują własny klucz.
1.0.2
- Nowa instrukcja krok po kroku: co potrafi wtyczka, instalacja i pierwsze ustawienia (readme.txt i instrukcja-pl.txt).
1.0.1
- Aktualizacje prosto z panelu WordPressa (Kokpit → Aktualizacje), dopóki licencja jest aktywna.
- Czytelny komunikat w panelu, gdy licencja nie jest aktywna.
- Wszystkie wtyczki i licencje wpAsist w jednym menu wpAsist.
1.0.0
- Pierwsze wydanie: procentowa opłata przy wybranych metodach płatności, w klasycznej i blokowej kasie.
- Lista metod płatności sklepu z ich ID na ekranie ustawień.
- Pełne polskie tłumaczenie.
Forum dla klientów
Pytaj, zanim się zirytujesz 🙂
Problem po instalacji? Coś niejasne w instrukcji? Tu nie ma głupich pytań, są tylko sklepy, które jeszcze nie działają tak, jak powinny. Odpisujemy osobiście, zwykle tego samego dnia.
Forum dostępne tylko dla klientów. Zaloguj się albo kup wtyczkę, żeby rozwinąć swój sklep razem z nami i móc zadawać pytania i otrzymać wsparcie.
