InPost Pay - Woocommerce (Widget 2.0)
Wstęp
Dokumentacja techniczna wtyczki InPost Pay dla Woocommerce z obsługą Widget 2.0.
Wtyczka dodaje do sklepu Woocommerce funkcjonalność dokonywania zamówień przez aplikację InPost przez:
Dodanie tabeli w bazie danych,
Dodanie przycisku “Utwórz koszyk z InPost Pay” na karcie produktu,
Dodanie przycisku “Kup z InPost Pay” na stronie koszyka,
Dodanie przycisku “Kup z InPost Pay” na stronie zamówienia,
Akcji wykonywanych na standardowe hook’i,
Dodaniu pola na stronie zamówienia,
Dodaniu sekcji administracyjnej,
Udostępnienia REST API,
Dołączenia do strony pliku JS serwowanego z webserwera oraz pliku serwowanego z zasobu zewnętrznego.
Wtyczka
Wersja 3.3.0 (14.10.2026)
Changelog
Na tej stronie:
- 1.1 Wstęp
- 1.2 Wtyczka
- 1.2.1 Changelog
- 1.3 Wymagania
- 1.4 Konfiguracja konta Merchanta - środowisko sandbox
- 1.5 Wymagania techniczne po stronie Merchanta
- 1.6 Konfiguracja konta Merchanta - środowisko produkcyjne
- 1.7 Instalacja / Aktualizacja
- 1.8 Konfiguracja Testowa
- 1.9 Konfiguracja Produkcyjna
- 1.10 Instrukcja konfiguracji ciasteczek funkcjonalnych dla wtyczek cookie w sklepie WooCommerce z InPostPay
- 1.11 Produkty promowane
- 1.12 Produkty sugerowane
- 2 Produkty wykluczone
- 2.2 Jak wykluczyć kategorie?
- 2.3 Wtyczka logistyczna
- 2.4 Obsługa produktów cyfrowych i dostaw elektronicznych
- 2.5 Pełna konfiguracja
- 2.5.1 Ustawienia API
- 2.5.2 Środowisko
- 2.5.3 Pokazuj widget
- 2.5.4 Client ID
- 2.5.5 Client Secret
- 2.5.6 POS ID
- 2.5.7 Merchant ID
- 2.5.8 Włącz płatności zgodne z podpisaną umową z bankiem
- 2.5.9 Włącz płatność przy odbiorze zgodnie z podpisaną umową z InPost
- 2.5.10 Wybierz dostępne metody płatności w aplikacji
- 2.5.11 Wirtualna metoda płatności
- 2.5.12 Status zamówienia dla zamówienia opłaconego przez InPost Pay
- 2.5.13 Status zamówień
- 2.5.14 Maksymalna liczba produktów sugerowanych
- 2.5.15 Niestandardowa strona podziękowania (opcjonalne)
- 2.5.16 Ustawienia przekazywanych opisów
- 2.5.17 Odśwież stronę po dodaniu produktu do koszyka
- 2.5.18 Format odpowiedzi
- 2.5.19 Wyszukiwanie użytkownika po numerze telefonu w historii zamówień
- 2.5.20 Odśwież fragmenty koszyka WooCommerce po aktualizacji koszyka z aplikacji
- 2.5.21 Wczesna odpowiedź aktualizacji koszyka (pominięcie hooka shutdown)
- 2.5.22 Buforowanie wyjścia podczas tworzenia zamówienia (tryb awaryjny)
- 2.5.23 Dodatkowe akcje WooCommerce dla zamówień i koszyka
- 2.6 Zgody
- 2.6.1 Adres zgody
- 2.6.2 Identyfikator linku
- 2.6.3 Tekst linku
- 2.6.4 Opisy widoczne w aplikacji
- 2.6.5 Czy wymagane
- 2.7 Kupony InPost Pay
- 2.8 Koszt transportu
- 2.8.1 Wybierz metody dostawy
- 2.8.2 Mapuj z metodą wysyłki
- 2.8.3 Włącz lub wyłącz opcje dostawy
- 2.8.4 Sposób obliczania ceny dla dodatkowej opcji dostawy
- 2.8.4.1 Mapuj z metodą wysyłki (dla opcji dostawy)
- 2.8.4.2 Dodatkowa prowizja
- 2.8.5 Dostępne od
- 2.8.6 Dostępne do
- 2.8.7 Ograniczenie dostawy Paczkomatem dla paczek powyżej 25kg
- 2.9 Wygląd przycisków
- 2.9.1 Tło
- 2.9.2 Wariant
- 2.9.3 Zaokrąglenie
- 2.9.4 Widget size
- 2.9.5 Wyświetlaj
- 2.9.6 Umiejscowienie
- 2.9.7 Położenie
- 2.9.8 Margines
- 2.10 Marketing
- 2.11 Wsparcie
- 2.11.1 Pobierz dane i logi wtyczki (dzisiaj)
- 2.11.2 Stan bazy danych
- 2.12 Analityka reklamowa (GA4, Meta Ads, Google Ads)
- 2.13 Wsparcie dla niestandardowych numerów zamówień (aliasów)
- 2.14 Filtr przesyłek dla InPost Pay
- 2.14.1 Przykłady scenariuszy
- 2.14.2 Wskazówki i uwagi
- 2.15 Wyświetlanie w niestandardowym miejscu
- 2.16 Programowalne akcje
- 2.17 Blokowanie ładowania widgetu InPost Pay przed wyrażeniem zgody
- 2.18 Dodawanie widgetu InPost Pay za pomocą Elementora
- 2.19 Dodawanie widgetu InPost Pay za pomocą bloków Gutenberga
- 2.20 Obsługa customowych akcji AJAX add-to-cart w InPost Pay
- 2.21 Filtr blokujący zmianę ilości wybranych produktów w aplikacji
- 2.22 Maskowanie adresu email klienta
- 2.23 Dezinstalacja
Wymagania
Do poprawnego działania wtyczka wymaga:
Woocommerce w wersji nie niższej niż 7.0.0
PHP w wersji nie niższej niż 7.4
Aby uzyskać szczegółowe informacje techniczne dotyczące wtyczki InPost Pay dla WooCommerce, prosimy zapoznać się z artykułem Specyfikacja techniczna - InPost Pay Plugin. Ponadto, dla zapewnienia pełnej kompatybilności zapraszamy do sprawdzenia listy kompatybilnych wtyczek w Kompatybilne wtyczki - InPost Pay WooCommerce.
Konfiguracja konta Merchanta - środowisko sandbox
Aby uzyskać dostęp do środowiska Sandbox uzupełnij i wyślij formularz kontaktowy wybierając opcję “Sklep internetowy” oraz zakładkę “Sandbox”.
Aplikacja testowa InPost Mobile
Aplikację InPost Mobile Sandbox zainstaluj korzystając z instrukcji dostępnej pod linkiem
Aplikacja testowa InPost Mobile.
Chcesz testować na środowisku lokalnym?
W celu zapewnienia zdalnego dostępu do środowiska lokalnego, konieczne jest zastosowanie dodatkowego rozwiązania w postaci tunelowania ruchu z publicznej domeny na lokalny adres. Bez takiego obejścia nie ma możliwości bezpośredniego połączenia się z lokalnym środowiskiem.
Rekomendowane rozwiązanie
Aktualnie zalecanym narzędziem jest ngrok, który umożliwia szybkie skonfigurowanie tunelu między publicznym adresem URL a lokalnym środowiskiem. Wystarczy darmowe konto, które zapewnia jedną stałą domenę publiczną. Ta domena może przekierowywać ruch do lokalnej aplikacji lub zamkniętego środowiska testowego.
Wymagania
Po utworzeniu darmowej domeny publicznej należy przekazać jej adres w formularzu Kontakt -> Sandbox, aby otrzymać credentiale i cały ruch testowy mógł być kierowany na ten adres.
Wymagania techniczne po stronie Merchanta
Ruch wychodzący od InPost do Merchanta dla IP Proxy InPost 34.118.93.24, 34.116.145.216.
Konfiguracja konta Merchanta - środowisko produkcyjne
Aby uzyskać dostęp do środowiska Produkcyjnego, zapoznaj się z instrukcją dostępną pod linkiem
Konfiguracja konta Merchanta - środowisko produkcyjne
Aby wdrożenie przebiegło sprawnie, przygotowaliśmy listę kluczowych kroków, które pomogą Wam szybko rozpocząć integracji swojego sklepu z InPost Pay Checklista implementacji InPost Pay.
Zapoznaj się z przewodnikiem poprawnej implementacji
W przewodniku znajdziesz obowiązkowe standardy oraz dodatkowe miejsca, gdzie InPost Pay może być widoczny. Wybierz te, które najlepiej pasują do Twojego sklepu. Szczegóły znajdziesz w sekcji Standardy implementacji InPost Pay.
Przycisk na stronie produktu (obowiązkowe)
Przycisk na stronie koszyka (obowiązkowe)
Strona podziękowania (obowiązkowe)
Przekazywanie numeru paczki (obowiązkowe)
W rozdziale Zwroty i podgląd transakcji w InPost Pay znajdziesz informacje jak obsługiwać zwroty i jak śledzić transakcje realizowane za pośrednictwem InPost Pay. Znajdziesz tutaj także informacje o integracji z API, które pozwala na pełną automatyzację tych procesów w Twoim systemie.
Instalacja / Aktualizacja
W celu instalacji wtyczki postępuj zgodnie z poniższymi krokami:
Pobierz spakowaną wtyczkę Woocommerce ze strony InPost i nie rozpakowuj jej
Zaloguj się do sekcji administracyjnej swojego sklepu
Z menu po lewej stronie wybierz “Wtyczki” a następnie “Dodaj nową”
Na górze strony wybierz “Wyślij wtyczkę na serwer” następnie “Wybierz plik” i odszukaj spakowaną wtyczkę pobraną w punkcie 1
Kliknij “Zainstaluj”
W następnym oknie kliknij “Włącz wtyczkę”
W celu aktualizacji wtyczki postępuj zgodnie z powyższymi krokami. Przy aktualizacji wtyczki ustawienia nie kasują się.
W przypadku pierwszej instalacji wtyczki na sklepie działającym na PHP 8.x, po jej aktywacji należy przejść do zakładki Ustawienia, wybrać odpowiednie Środowisko, a następnie zapisać zmiany.
Konfiguracja Testowa
W tym rozdziale opisujemy skrócony proces konfiguracji potrzebny do przeprowadzenia testów działania integracji z InPost Pay. W celu wstępnej konfiguracji przejdź do sekcji administracyjnej sklepu i kliknij “InPost Pay” w menu po lewej stronie. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki. Wypełnij pola zgodnie z poniższą listą:
Wybierz środowisko i opcje wyświetlania
a. Środowisko ustaw na “Sandbox” - w ten sposób przetestujesz proces zakupowy na środowisku testowym.
b. Pokazuj widget ustaw na “Testerom” - w ten sposób widget będzie widoczny tylko dla osób, które mają go zobaczyć. Ustawienie innej opcji wyświetli widget działający bądź nie wszystkim osobom odwiedzającym Twój sklep.
W celu wyświetlenia widgetu w przeglądarce internetowej wpisz adres Twojego sklepu z dopiskiem ?showIzi=true
Przykład: https://mojsklep.pl?showIzi=true
Wypełnij dane dostępowe do API, które otrzymałeś od InPost w polach
a. Client ID
b. Client Secret
Pole POS ID wypełnij zgodnie z wartością otrzymaną od InPost
Pole Merchant ID wypełnij zgodnie z wartością otrzymaną od InPost
Włącz możliwość płatności
Wybierz status zamówienia, jakie zostanie nadane zamówieniom opłaconym poprzez InPost Pay oraz jakie zostanie nadane zamówieniom za pobraniem.
Sprawdź czy słownik statusów zamówień jest zgodny z tym, co rzeczywiście prezentujesz w komunikacji klientom. Sekcja ta wykorzystywana jest w sklepach, które mają nietypowy proces zakupowy. Sekcja ta będzie różna w różnych sklepach bo przedstawia statusy w Twoim sklepie.
Wpisz ile produktów sugerowanych chcesz prezentować w aplikacji InPost. Szczegółowy opis działania tego mechanizmu opisany jest w rozdziale Produkty sugerowane.
Dodaj zgody, które będą wymagane w Twoim sklepie. Szczegółowy opis każdej z opcji znajdziesz w rozdziale Pełna Konfiguracja.
Określ, które wysyłkowe metody bazowe, wspiera proces zakupowy Twojego sklepu.
Połącz wysyłkę Kurierem z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Kurierem w aplikacji InPost.
Tę część w podstawowej konfiguracji możesz pominąć. Określa ona ceny dodatkowych opcji wysyłki dla opcji Kurier. Pełny opis znajdziesz w rozdziale Pełna Konfiguracja.
Połącz wysyłkę przez Paczkomat z wysyłką systemową. Po wybraniu z listy rozwijalnej sposobu wysyłki te same reguły dostępności i cen dla wybranej metody będą obowiązywać dla wysyłki Paczkomat w aplikacji InPost.
Tę część w podstawowej konfiguracji możesz pominąć. Określa ona ceny dodatkowych opcji wysyłki dla opcji Paczkomat - Paczka w Weekend oraz płatności przy odbiorze oraz dni i godziny między którymi te opcje będą dostępne dla Twoich klientów. Pełny opis znajdziesz w rozdziale Pełna konfiguracja.
Tę część w podstawowej konfiguracji możesz pominąć. Określa ona czy dostępność metod wysyłki ma być dodatkowo sprawdzana dla produktów w koszyku na podstawie szczegółowych ustawień wtyczki logistycznej InPost. Pozostaw tę opcję wyłączoną, jeżeli nie korzystasz z oficjalnej wtyczki logistycznej InPost.
Określ gdzie widget powinien być dostępny na Twojej stronie. Możesz wyświetlać go na karcie produktu oraz w koszyku. Dla każdego miejsca wyświetlania możesz określić, do której strony przycisk InPost Pay będzie wyrównany. Dla każdego miejsca możesz osobno wybrać, czy tło na stronie jest jasne czy ciemne co zapewnia poprawne wyświetlanie tekstów. Dla każdego miejsca możesz oddzielnie wybrać wariant wyświetlania. Przycisk może być czarny bądź żółty. Całość konfiguruje się w zakładce “Wygląd przycisków”.
Konfiguracja Produkcyjna
Po poprawnej konfiguracji testowej i upewnieniu się, że integracja w środowisku Sandbox działa należy udostępnić InPost Pay wszystkim użytkownikom.
W celu konfiguracji przejdź do listy modułów i kliknij “Konfiguruj” obok modułu InPpost Pay. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki.
Zmień konfigurację zgodnie z poniższą listą:
Wybierz środowisko i opcje wyświetlania
a. Środowisko ustaw na “Produkcyjne” - w ten sposób podczas składania zamówień będą wykonywane produkcyjne płatności
b. Pokazuj widget ustaw na “Każdemu” - w ten sposób widget będzie widoczny dla wszystkich klientów sklepu.
Uzupełnij pola Client ID, Client Secret, POS ID oraz Merchant ID wartościami pobranymi z panelu merchanta. Pełną instrukcję generowania danych dostępowych do API dla środowiska produkcyjnego znajdziesz tutaj.
Instrukcja konfiguracji ciasteczek funkcjonalnych dla wtyczek cookie w sklepie WooCommerce z InPostPay
Jeśli na Twoim sklepie WooCommerce zintegrowanym z InPostPay występują wtyczki do zarządzania ciasteczkami, należy dodać odpowiednie ciasteczka funkcjonalne. Poniższa instrukcja dotyczy konfiguracji popularnych wtyczek cookie.
Przykładowe wtyczki cookie, które mogą występować na Twoim sklepie:
Cookie Yes
GDPR Cookie Compliance
Cookie Consent Manager for WordPress
CookieBot for GDPR & CCPA Compliance
Cookie Notice for GDPR & CCPA
Konfiguracja ciasteczek funkcjonalnych:
Dla każdej z powyższych wtyczek, należy dodać następujące ciasteczka jako funkcjonalne:
basket_binding_api_key - niezbędne do zarządzania koszykiem zakupowym i integracji z systemem InPostPay.
inpost_pay_currency_restore_uid - służy do zapisywania preferencji walutowych użytkownika, co jest kluczowe dla prawidłowego działania płatności InPost Pay.
Instrukcja krok po kroku:
Zaloguj się do panelu administracyjnego WooCommerce.
Przejdź do sekcji zarządzania wtyczkami i znajdź swoją wtyczkę do zarządzania ciasteczkami.
Otwórz ustawienia wtyczki cookie i przejdź do sekcji zarządzania ciasteczkami.
Dodaj następujące ciasteczka jako funkcjonalne:
basket_binding_api_keyinpost_pay_currency_restore_uid
Zapisz zmiany i przetestuj działanie sklepu, aby upewnić się, że ciasteczka są prawidłowo ustawiane.
Podsumowanie
Dodanie odpowiednich ciasteczek funkcjonalnych jest kluczowe dla prawidłowego działania integracji InPostPay w Twoim sklepie WooCommerce. Postępując zgodnie z powyższymi krokami, zapewnisz użytkownikom płynne korzystanie z funkcji zakupowych.
Produkty promowane
Funkcjonalność wycofana z usługi InPost Pay.
Produkty sugerowane
Aplikacja InPost podczas dokonywania zakupów z InPost Pay sugeruje produkty do dodania do koszyka zgodnie z wbudowanym w WooCommerce systemem Produktów Powiązanych.
Jak wyświetlić produkty sugerowane w aplikacji?
W celu pokazania produktów sugerowanych należy uzupełnić sekcję Produktów Powiązanych w konfiguracji produktu WooCommerce.
W tym celu:
Przejdź do edycji produktu w Twoim sklepie.
W panelu Dane Produktu wybierz sekcję “Powiązane produkty”.
Wypełnij sekcje “pu-sell” bądź “cross-sell” - produkty z obu sekcji będą widoczne w aplikacji.
Dlaczego na stronie widzę produkty sugerowane a w aplikacji nie?
Możliwe, że Twój sklep prezentuje produkty powiązane w niestandardowy sposób. Dzieje się tak na przykład przez to jak działa Twój szablon bądź jedna z zainstalowanych wtyczek. Jeśli Twój sklep prezentuje produkty sugerowane a nie widzisz ich w Aplikacji InPost upewnij się, że Produkty Powiązane są skonfigurowane zgodnie z instrukcją zawartą w akapicie powyżej.
Produkty wykluczone
Czym są Unavailable Products oraz Unavailable Categories?
Funkcjonalność produktów wykluczonych w ramach InPost Pay, to nowa zakładka wtyczki, dostępna z poziomu admina. Umożliwia wykluczenie wybranych produktów lub kategorii w celu ograniczenia ich dostępności dostawy w aplikacji mobilnej InPost Pay.
Jak wykluczyć produkty?
Wykluczanie produktów polega na wykluczeniu jego konkretnych metod dostawy.
Aby wykluczyć produkty w aplikacji mobilnej InPost Pay, wykonaj następujące kroki:
Przejdź do zakładki InPost Pay -> Unavailable Products w panelu administracyjnym WooCommerce.
Kliknij przycisk „Wybierz produkty”.
W nowo otwartym oknie wybierz kategorię produktów — po rozwinięciu kategorii zobaczysz dostępne produkty.
Zaznacz metody dostawy dla danego produktu, które chcesz wykluczyć w aplikacji i kliknij „Zapisz”.
Możesz edytować wykluczenie dostawy dla produktu odznaczając je na liście Wykluczonych produktów. Usunięcie wykluczenia dla obu metod dostawy równa się usunięciu produktu z listy Wykluczonych produktów.
Jak wykluczyć kategorie?
Wykluczanie kategorii polega na wykluczeniu konkretnych metod dostawy dla wszystkich przypisanych produktów
Aby wykluczyć całe kategorie w aplikacji mobilnej InPost Pay, wykonaj następujące kroki:
Przejdź do zakładki InPost Pay -> Unavailable Categories w panelu administracyjnym WooCommerce.
Następnie zobaczysz listę kategorii z paginacją
Zaznacz metody dostawy dla danej kategorii, które chcesz wykluczyć w aplikacji, zapis jest automatyczny.
Wtyczka logistyczna
InPost dostarcza dedykowaną wtyczkę do integracji z InPost dla Klientów WooCommerce. Wtyczka ta pozwala na w pełni zautomatyzowany przebieg procesu zakupowego łącznie z nadaniem numeru przesyłki i wysłaniem go do Twoich klientów przez aplikację InPost w procesie zakupowym InPost Pay.
Pobierz wtyczkę z: InPost PL
Dokumentacja: [PL] WooCommerce
Jak nadać paczkę jeśli mam wtyczkę logistyczną InPost?
Sposób wysyłki, adres oraz identyfikator paczkomatu automatycznie zostaną przekazane do wtyczki logistycznej. Ty nie musisz znać danych klienta. Musisz nadać paczkę zgodnie z instrukcją wtyczki.
Jak nadać paczkę jeśli nie mam wtyczki logistycznej InPost?
Na stronie zamówienia dokonanego przez InPost Pay dostępne są informacje mówiące o sposobie wysyłki oraz numerze paczkomatu w formie okienka. Skopiuj je i postępuj zgodnie z Twoim standardowym procesem nadawania paczek.
Obsługa produktów cyfrowych i dostaw elektronicznych
Wtyczka wspiera obsługę produktów cyfrowych oraz zamówień zawierających produkty do pobrania.
Produkty wirtualne:
W przypadku zamówień zawierających produkty wirtualne (np. kody, dostęp online), nie jest generowany żaden fizyczny sposób dostawy. Merchant powinien samodzielnie obsłużyć wysyłkę (np. ręcznie wysłać kod/licencję na adres e-mail klienta, widoczny w szczegółach zamówienia po prawej stronie panelu administracyjnego WooCommerce).Produkty do pobrania:
Jeżeli zamówienie zawiera produkty do pobrania, pliki zostaną automatycznie wysłane na adres e-mail podany przez klienta jako adres do dostawy cyfrowej.Zamówienia mieszane:
W przypadku zamówień mieszanych (produkty fizyczne + cyfrowe) wtyczka automatycznie wykryje obecność produktów cyfrowych i odpowiednio dostosuje sposób realizacji zamówienia.
Pełna konfiguracja
Konfiguracja została podzielona na sekcje umożliwiające dostosowanie działania wtyczki do potrzeb sklepu.
Po instalacji wtyczki w menu po lewej stronie sekcji administracyjnej zobaczysz nowe menu “InPost Pay”. Po jego kliknięciu pokaże się formularz umożliwiający konfigurację wtyczki.
Ustawienia API
W tej sekcji ustawia się dane dostępowe do systemu, rodzaje obsługiwanych metod płatności oraz informacja wymieniane między InPost Pay a sklepem.
Dane dostępowe do środowiska sandbox uzyskasz pisząc maila na skrzynkę integracjapay@inpost.pl lub wypełniając formularz kontaktowy w opcji Dla Biznesu i zakładce Sandbox.
Dane produkcyjne otrzymasz po podpisaniu umowy o usługę InPost Pay i wygenerujesz poprzez panel Merchanta zgodnie z instrukcją.
Opis dostępnych opcji:
Środowisko
Do czego służy: | Jak ustawić: |
|---|---|
Określa czy sklep wysyła dane do | Kiedy testujesz integrację ustaw środowisko Sandbox. |
Pokazuj widget
Do czego służy: | Jak ustawić: |
|---|---|
Podczas testów nie chcemy, żeby widget InPost Pay wyświetlał się wszystkim klientom. Niezależnie od tego jakie środowisko zostało ustawione możesz tymczasowo ukryć widget i pokazywać go tylko wybranym osobom. W celu wyświetlenia widgetu w trybie tylko dla testerów wejdź na stronę główną sklepu i dodaj na końcu adresu url ?showIzi=true | Kiedy konfigurujesz integrację wybierz |
|
|
Client ID
Do czego służy: | Jak ustawić: |
|---|---|
Dana dostępowa do API umożliwiająca działanie wtyczki. | Zgodnie z danymi otrzymanymi od InPost. |
Client Secret
Do czego służy: | Jak ustawić: |
|---|---|
Dana dostępowa do API umożliwiająca działanie wtyczki. | Zgodnie z danymi otrzymanymi od InPost. |
POS ID
Do czego służy: | Jak ustawić: |
|---|---|
Dana dostępowa do API | Zgodnie z danymi otrzymanymi od InPost. |
Merchant ID
Do czego służy: | Jak ustawić: |
|---|---|
Dana dostępowa do API umożliwiająca działanie wtyczki. | Zaloguj się do panelu InPost i pobierz Merchant Client ID |
Włącz płatności zgodne z podpisaną umową z bankiem
Do czego służy: | Jak ustawić: |
|---|---|
Określa, czy Twoi klienci będą mogli dokonywać płatności przez bramki płatnicze, które są zawarte w Twojej umowie takie jak Blik, Apple Pay, płatność kartą. | Zaznacz Tak jeśli metody mają być dostępne. Jeśli nie zaznaczysz żadnej metody, domyślnie dostępne będą wszystkie formy płatności zgodne z Twoją umową z bankiem. |
Włącz płatność przy odbiorze zgodnie z podpisaną umową z InPost
Do czego służy: | Jak ustawić: |
|---|---|
Określa, czy Twoi klienci będą mogli dokonywać płatności przy odbiorze zgodnie z umową z InPost | Zaznacz Tak jeśli metoda ma być dostępna. |
Wybierz dostępne metody płatności w aplikacji
Konfiguracja niedostępna od wersji v3.1.2.
Uwaga:
Opcja ta pojawi się dopiero po wprowadzeniu danych dostępowych do API i zapisaniu ustawień.
Do czego służy: | Jak ustawić: |
|---|---|
Określa, jakie metody płatności będą widoczne dla klienta w aplikacji InPost. | Wybierz z listy dostępne metody płatności. |
Wirtualna metoda płatności
Możesz włączyć wirtualną metodę płatności, która będzie przypisywana do zamówień z InPost Pay. Ta metoda jest niewidoczna w zwykłym koszyku.
Do czego służy: | Jak ustawić: |
|---|---|
Po włączeniu możesz rozpoznawać płatność InPost Pay w kodzie oraz w zewnętrznych wtyczkach, które wymagają zarejestrowanej metody płatności w systemie. | Aby włączyć, przejdź do zakładki InPost Pay, potem do Ustawień. Niżej, w opcjach metody płatności, zaznacz Wirtualna bramka płatności. |
Rozpoznanie poprzez klasę:Ilabs\Inpost_Pay\Lib\PaymentInpost_Pay_Virtual_Payment_Gateway
lub poprzez id:inpost_pay_virtual_payment_gateway
Status zamówienia dla zamówienia opłaconego przez InPost Pay
Do czego służy: | Jak ustawić: |
|---|---|
Określa jaki status mają mieć zamówienia, które zostaną opłacone przez InPost Pay | Wybierz z listy status jakie mają mieć zamówienia opłacone. |
Status zamówień
Do czego służy: | Jak ustawić: |
|---|---|
Określa jakie nazwy statusów mają pojawić się w aplikacji InPost Pay (kolumna po prawej) dla zamówień w Twoim sklepie (kolumna po prawej) | Zweryfikuj czy poniższe statusy odpowiadają statusom, które Twój klient otrzymuje w komunikacji dotyczącej zamówienia. |
Maksymalna liczba produktów sugerowanych
Do czego służy: | Jak ustawić: |
|---|---|
Określa maksymalną liczbę produktów, jakie zostaną zasugerowane Twojemu klientowi w aplikacji InPost do produktów jakie już ma w koszyku. Produkty sugerowane pobierane są ze standardowego mechanizmu WooCommerce. | Wpisz maksymalną liczbę produktów. |
Niestandardowa strona podziękowania (opcjonalne)
W tej sekcji możesz skonfigurować alternatywny sposób renderowania strony podziękowania (Thank You Page) po zakończeniu zakupów z InPost Pay.
Funkcja pozwala wybrać własną stronę WordPress zawierającą shortcode [inpost_thank_you], dzięki czemu komunikat podziękowania może być wyświetlany w pełnym układzie motywu, bez użycia wirtualnej strony generowanej przez wtyczkę.
Opcja jest szczególnie przydatna w motywach, które nie obsługują stron wirtualnych.
Do czego służy: | Jak ustawić: |
|---|---|
Umożliwia zastąpienie domyślnej wirtualnej strony podziękowania własną stroną WordPress z osadzonym shortcode [inpost_thank_you]. Dzięki temu treść strony może być wyświetlana w kontekście aktywnego motywu, wraz z jego szablonem, nagłówkiem i stopką. |
|
Ustawienia przekazywanych opisów
Do czego służy: | Jak ustawić: |
|---|---|
Określa czy ma być pobierany pełny opis czy opis skrócony | Wybierz “Pełny opis” lub “Krótki Opis” |
Odśwież stronę po dodaniu produktu do koszyka
Steruje przeładowaniem strony po zmianach w koszyku. Włączona opcja zapewnia, że komunikaty o dodaniu lub usunięciu produktu wyświetlają się poprawnie w sklepach, w których działają tylko po odświeżeniu strony.
Domyślnie opcja jest włączona.
Uwaga: Wyłącz tę opcję, jeżeli komunikaty w Twoim sklepie nie wymagają przeładowania strony (np. gdy komunikat o dodaniu produktu do koszyka pojawia się od razu bez odświeżania).
Format odpowiedzi
Włącza nowy, ujednolicony sposób budowania odpowiedzi dla koszyka i tworzenia zamówienia. Lepsza zgodność ze standardami WooCommerce i większa kompatybilność z innymi wtyczkami.
Uwaga: Włączaj tylko, jeśli to konieczne. Część wtyczek oczekuje danych z $_POST i wymuszenie akcji może powodować konflikty.
Włącz niestandardową odpowiedź koszyka (tylko do celów diagnostycznych)
uruchamia alternatywny (niestandardowy) payload odpowiedzi koszyka, pomocny przy diagnozie konfliktów.
domyślnie wyłączone.
używaj wyłącznie tymczasowo na środowisku testowym lub przy wsparciu technicznym InPost.
Używaj nowoczesnego formatu odpowiedzi (zalecane)
włącza nowy, ujednolicony sposób budowania odpowiedzi dla koszyka i tworzenia zamówienia. Lepsza zgodność ze standardami WooCommerce i większa kompatybilność z innymi wtyczkami.
domyślnie włączone od wersji 2.0.3.
wyłącz, jeśli po aktualizacji widzisz błędy/niezgodności w koszyku lub podczas składania zamówienia i sprawdź, czy problem ustępuje (tryb zgodny z wcześniejszym działaniem).
Wyszukiwanie użytkownika po numerze telefonu w historii zamówień
Opcja pozwala InPost Pay przeszukiwać wcześniejsze zamówienia w celu identyfikacji klienta na podstawie numeru telefonu, ale tylko wtedy, gdy nie uda się znaleźć dopasowanego adresu e-mail. Mechanizm pomaga powiązać zamówienie składane przez gościa z istniejącym użytkownikiem WordPress, jeśli ten sam numer telefonu był wcześniej użyty w sklepie.
Wyszukiwanie działa w historii zamówień i może obciążać bazę danych w sklepach z bardzo dużą liczbą zamówień. Zakres wyszukiwania jest ograniczony do zamówień z ostatnich 12 miesięcy.
Opcja jest domyślnie włączona. W sklepach z dużą historią zamówień, szczególnie powyżej 500 000 zamówień, wyszukiwanie po numerze telefonu może powodować opóźnienia lub timeouty podczas tworzenia zamówienia. Po wyłączeniu opcji goście składający zamówienie bez konta nie będą automatycznie dopasowywani do istniejącego użytkownika WordPress na podstawie numeru telefonu.
Zalecenia:
jeśli tworzenie zamówień działa poprawnie - pozostaw opcję włączoną
jeśli podczas tworzenia zamówienia występują opóźnienia lub timeouty w sklepie z dużą liczbą zamówień - wyłącz opcję i sprawdź, czy problem ustąpił
jeśli sklep korzysta ze standardowych tabel WooCommerce i ma bardzo dużą liczbę zamówień - rozważ migrację do HPOS.
Odśwież fragmenty koszyka WooCommerce po aktualizacji koszyka z aplikacji
Opcja wymusza odświeżenie fragmentów koszyka WooCommerce po każdej zmianie koszyka wykonanej z aplikacji InPost Pay. Standardowo WooCommerce odświeża elementy takie jak liczba produktów w mini koszyku czy zawartość minicarta przez własny mechanizm zdarzeń i AJAX. W niektórych motywach lub konfiguracjach sklepu mechanizm ten może nie zadziałać po każdej zmianie wykonanej z aplikacji, mimo że koszyk po stronie WooCommerce został zaktualizowany poprawnie.
Po włączeniu tej opcji wtyczka wywołuje standardowe zdarzenie WooCommerce wc_fragment_refresh po aktualizacji koszyka z aplikacji InPost Pay. Dzięki temu WooCommerce ponownie ładuje zarejestrowane fragmenty koszyka, np. licznik produktów i zawartość mini koszyka.
Opcja działa wyłącznie po aktualizacjach koszyka wykonanych z aplikacji InPost Pay i pełni rolę trybu zgodności dla sklepów, w których elementy koszyka na stronie nie odświeżają się automatycznie po zmianie ilości produktu w aplikacji.
Rekomendacje:
jeśli mini koszyk i inne elementy koszyka odświeżają się poprawnie po zmianach z aplikacji - pozostaw opcję wyłączoną
jeśli po zmianie ilości produktu w aplikacji mini koszyk nie pokazuje aktualnej liczby produktów lub zawartości - włącz opcję i sprawdź, czy problem ustąpił
jeśli problem już nie występuje i elementy koszyka odświeżają się poprawnie bez tej opcji - wyłącz ją permanentnie.
Wczesna odpowiedź aktualizacji koszyka (pominięcie hooka shutdown)
Opcja powoduje wcześniejsze zwrócenie odpowiedzi do aplikacji podczas aktualizacji koszyka wykonywanej z aplikacji mobilnej. Standardowo odpowiedź jest wysyłana dopiero na etapie shutdown, co w niektórych środowiskach może skutkować pustym body lub błędem w aplikacji przy zmianie ilości produktów. Po włączeniu tej opcji odpowiedź jest generowana wcześniej, w trakcie obsługi requestu, dzięki czemu aplikacja otrzymuje poprawne dane.
Opcja działa wyłącznie dla aktualizacji koszyka wykonywanych przez aplikację mobilną i pełni rolę trybu zgodności dla środowisk, w których standardowy mechanizm odpowiedzi działa zbyt późno.
Zalecenia:
jeśli aktualizacja koszyka po stronie aplikacji działa poprawnie - pozostaw opcję wyłączoną
jeśli aplikacja zgłasza błąd podczas aktualizacji koszyka - włącz opcję i sprawdź, czy problem ustąpił
Buforowanie wyjścia podczas tworzenia zamówienia (tryb awaryjny)
Opcja umożliwia przechwycenie i odrzucenie nieoczekiwanej treści wyjściowej generowanej przez zewnętrzne wtyczki podczas tworzenia zamówienia przez endpoint /v1/izi/order. Standardowo odpowiedź tego endpointu powinna zawierać wyłącznie poprawne dane JSON. Jeśli inna wtyczka, np. analityczna, wygeneruje dodatkowy output w trakcie obsługi żądania, może to spowodować błąd komunikacji InPost Pay lub niepoprawną odpowiedź zwracaną do aplikacji.
Po włączeniu tej opcji nieoczekiwany output zostaje przechwycony, odrzucony przed wysłaniem odpowiedzi JSON i zapisany w logach InPost Pay. Dzięki temu proces tworzenia zamówienia może zakończyć się poprawnie mimo konfliktu z zewnętrzną wtyczką.
Opcja działa wyłącznie podczas tworzenia zamówienia przez endpoint /v1/izi/order i pełni rolę awaryjnego trybu zgodności dla środowisk, w których zewnętrzna wtyczka wstrzykuje nieprawidłową treść do odpowiedzi.
Zalecenia:
jeśli tworzenie zamówień działa poprawnie - pozostaw opcję wyłączoną
jeśli podczas tworzenia zamówienia występują błędy komunikacji InPost Pay spowodowane nieoczekiwanym outputem z innej wtyczki - włącz opcję i sprawdź, czy problem ustąpił
jeśli konflikt już nie występuje i tworzenie zamówień działa poprawnie bez tej opcji - wyłącz ją permanentnie
Dodatkowe akcje WooCommerce dla zamówień i koszyka
Dodatkowe akcje umożliwiają ręczne wywołanie logiki WooCommerce wymaganej przez niektóre wtyczki (np. SalesKing) przy użyciu InPost Pay.
Włączaj dodatkowe akcje tylko jeśli to konieczne. Niektóre wtyczki mogą wymagać dodatkowych danych z $_POST lub powodować konflikty.
Lista dostępnych akcji do zaznaczenia
dla zamówień
woocommerce_checkout_order_processed
woocommerce_checkout_create_order
woocommerce_checkout_update_order_meta
woocommerce_checkout_order_created
dla koszyka
woocommerce_cart_item_set_quantity
Użytkownik może zaznaczyć, które akcje mają być wywoływane po złożeniu zamówienia.
Pozwala to zachować pełną kompatybilność z zewnętrznymi pluginami wymagającymi obecności tych hooków, bez globalnego narzucania ich wykonania.
Zgody
Sekcja służy do ustawienia zgód wyświetlanych klientom w aplikacji InPost podczas zakupów z InPost Pay.
Dodawanie:
Zgody można dodać za pomocą przycisku “+Dodaj zgodę”. Maksymalnie możesz dodać 10 zgód.
Usuwanie:
W celu usunięcia zgody naciśnij przycisk “Usuń” umieszczony przy danej zgodzie.
Dodawanie dodatkowych linków do zgód:
W celu dodania dodatkowego linku do zgody należy nacisnąć przycisk “+Dodaj dodatkowy link”. Maksymalnie w jednej zgodzie mogą być dodane 3 linki. Minimum jeden link jest wymagany.
Opis dostępnych opcji:
Adres zgody
Do czego służy: | Jak ustawić: |
|---|---|
Określa stronę, na którą zostanie przekierowany Twój klient w celu przeczytania zgody. Strony widoczne na liście to standardowe strony dostępne w Wordpress. | Wybierz jedną ze stron Twojego sklepu z listy rozwijalnej. |
Identyfikator linku
Do czego służy: | Jak ustawić: |
Jest to unikalny identyfikator Twojego odnośnika, który możesz użyć w opisie zgody . | Wprowadź unikalny identyfikator. |
Tekst linku
Do czego służy: | Jak ustawić: |
Określa wyświetlany tekst dla linku. | Wprowadź tekst np. Regulamin, Polityka Prywatności. |
Opisy widoczne w aplikacji
Do czego służy: | Jak ustawić: |
|---|---|
Określa opis wyświetlany w aplikacji | Wpisz opis, jaki ma zostać wyświetlony. Możesz podać tutaj swoje identyfikatory linków poprzedzone znakiem #, dzięki czemu twoje linki zostaną osadzone w treści zgody. |
Czy wymagane
Do czego służy: | Jak ustawić: |
|---|---|
Określa czy zgoda jest wymagana | Wpisz wymagalność zgody z listy. |
Wskazówka:
Jeśli chcesz utworzyć jeden checkbox w aplikacji służący do akceptacji więcej niż jednego dokumentu stwórz stronę, na której umieścisz odnośniki do wszystkich wymaganych zgód.
Kupony InPost Pay
Gdzie zarządzać kuponami?
Przejdź do:
Marketing → Kupony
Tam możesz natywnie tworzyć i edytować kupony, które będą dynamicznie pokazywane klientom w aplikacji InPost Pay, w zależności od warunków ich koszyka.
Widoczność kuponów w aplikacji
Aby kupon był widoczny w aplikacji InPost Pay:
Musi być aktualnie ważny (nie wygasły),
Jeżeli kupon ma ograniczenie do konkretnego maila, to aktualnie zalogowany użytkownik musi mieć e-mail zgodny z restrykcją,
Produkty w koszyku muszą spełniać wymagania kuponu (produktowe, kategorie, marki),
Wartość koszyka musi spełniać wymagania minimalnej i maksymalnej kwoty, jeśli są ustawione,
Kupon nie może być już zastosowany w koszyku,
Kupon musi mieć uzupełniony opis.
W zakładce „InPost Pay” musi być zaznaczona opcja „Udostępnij w aplikacji InPost Pay”
Kupon dostępny wyłącznie w aplikacji Inpost Pay
Wtyczka umożliwia utworzenie kuponu, który będzie dostępny wyłącznie w aplikacji InPost Pay. Aby utworzyć taki kupon, należy wybrać typ rabatu InPostPay.
Jest to rabat procentowy naliczany od wartości całego koszyka. Kupony tego typu nie są dostępne w sklepie internetowym ani w innych kanałach sprzedaży.
Uwaga: Kupony typu InPostPay nie obsługują darmowej dostawy.
Wybór kuponów wyświetlanych w aplikacji InPost Pay
W każdej wersji możesz tworzyć kupony widoczne w aplikacji InPost Pay zgodnie z warunkami widoczności. Od wersji 2.0.1.1 dodatkowo możesz samodzielnie wskazać, które kupony mają być widoczne w aplikacji - niezależnie od typu.
W tym celu:
Przejdź do edycji kuponu
Otwórz zakładkę „InPost Pay”
Zaznacz opcję „Udostępnij w aplikacji InPost Pay”
Uwaga: W aplikacji InPost Pay może być jednocześnie widocznych maksymalnie 5 kuponów.
Koszt transportu
Ta sekcja odpowiada za mapowanie form transportu oraz definiowanie dostępności i cen opcji dodatkowych transportu dla każdej strefy wysyłki osobno.
Od teraz wszystkie ustawienia dotyczące kosztów dostawy możesz konfigurować niezależnie dla każdej strefy skonfigurowanej w WooCommerce (np. Polska, Kraków, wybrane regiony). Dzięki temu klienci z różnych lokalizacji mogą widzieć różne opcje i ceny dostawy - zgodnie z Twoją polityką wysyłki. Rozwiń lub zwiń konkretne ustawienia kosztów transportu dla strefy, klikając w jej nazwę.
W celu zapewnienia transparentności i spójności doświadczenia klienta, koszty dostawy muszą być identyczne w interfejsie sklepu internetowego oraz w aplikacji. Należy skonfigurować oba systemy w taki sposób, aby prezentowały użytkownikom te same wartości opłat za dostawę dla odpowiednich metod.
Opis dostępnych opcji:
Ustawienia tej sekcji są analogiczne dla wszystkich typów wysyłki i dla wszystkich opcji
Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.
Wybierz metody dostawy
Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.
Do czego służy: | Jak ustawić: |
|---|---|
Określa, które z metod dostawy są obsługiwane przez sklep. | Włącz lub wyłącz metody za pomocą przełączników |
Mapuj z metodą wysyłki
Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.
Do czego służy: | Jak ustawić: |
|---|---|
Określa, która z dostępnych w sklepie metod wysyłki ustala ceny i zasady dla przedpłaconych metod wysyłki. Lista zawiera standardowe, dostępne w Woocommerce metody wysyłki. | Wybierz wysyłkę dostępną w Twoim sklepie z listy rozwijalnej. |
Włącz lub wyłącz opcje dostawy
Pamiętaj!
Poniższe opcje ustaw zgodnie z umową z InPost.
Do czego służy: | Jak ustawić: |
|---|---|
Określa, które z dodatkowych opcji dostawy są obsługiwane przez sklep. | Włącz obsługiwane opcje wysyłki za pomocą pola checkbox |
Sposób obliczania ceny dla dodatkowej opcji dostawy
Do czego służy: | Jak ustawić: |
|---|---|
Określa, jak będzie obliczana cena dodatkowych opcji dostawy. | Ustaw przycisk opcji obok pola „Mapuj z metodą wysyłki” jeżeli koszt wysyłki z opcją powinna obliczyć metoda wysyłki Woocommerce. Ustaw przycisk opcji obok pola „Dodatkowa prowizja” jeżeli chcesz wprowadzić wartość prowizji kwotowej dla opcji dostawy. |
Mapuj z metodą wysyłki (dla opcji dostawy)
Do czego służy: | Jak ustawić: |
|---|---|
Określa, która z dostępnych w sklepie metod wysyłki ustala ceny i zasady dla opcji dostawy. Lista zawiera standardowe, dostępne w Woocommerce metody wysyłki. | Wybierz wysyłkę dostępną w Twoim sklepie z listy rozwijalnej. |
Pamiętaj!
Jeżeli kupujący wybierze w aplikacji więcej niż 1 opcję (np. Pobranie + Paczka w weekend) wtedy w zamówieniu Woocommerce będzie widoczna metoda bazowa.
Dodatkowa prowizja
Do czego służy: | Jak ustawić: |
|---|---|
Pole dodatkowej prowizji kwotowej dla opcji dostawy doliczanej do kosztu wysyłki metody bazowej. | Wprowadź kwotę netto. Podatek będzie doliczony w zależności od ustawień zmapowanej metody bazowej. |
Dostępne od
Do czego służy: | Jak ustawić: |
|---|---|
Określa od którego dnia tygodnia, i której godziny opcja APM+PWW (Paczkomat + Paczka w weekend) jest dostępna. | Wybierz dzień i godzinę, od których opcja będzie dostępna dla Twoich klientów. |
Dostępne do
Do czego służy: | Jak ustawić: |
|---|---|
Określa do którego dnia tygodnia i której godziny opcja APM+PWW (Paczkomat + Paczka w weekend) jest dostępna. | Wybierz dzień i godzinę, do których opcja będzie dostępna dla Twoich klientów. |
Ograniczenie dostawy Paczkomatem dla paczek powyżej 25kg
Integracja z wtyczką logistyczną InPost
Do czego służy: | Jak ustawić: |
|---|---|
Ogranicza możliwość wyboru opcji dostawy "Paczkomat", jeżeli paczka waży powyżej 25kg | W panelu wtyczki logistycznej InPost zakładka "Ustawienia". |