¶ PayPal - płatność online z automatycznym potwierdzeniem zamówienia
PayPal w Hummerce to płatność online, w której klient płaci kontem PayPal na stronie PayPal, a sklep automatycznie pobiera środki i oznacza zamówienie jako opłacone - także wtedy, gdy klient nie wróci do sklepu po zapłacie. Integracja korzysta z aktualnego interfejsu PayPal (Orders API v2), więc nie zależy od starszego mechanizmu, który PayPal wycofuje. To podstawowa metoda płatności dla sklepów sprzedających za granicę.
Stan na wersję Hummerce 2.34 (ostatnie zmiany w module: 2.34.39), aktualizacja 2026-09-28.
¶ Korzyści i zastosowania
- Mniej zamówień "zawieszonych" jako nieopłacone - sklep sam pobiera środki za płatności zatwierdzone przez klienta, nawet gdy klient nie wrócił do sklepu.
- Mniej ręcznego sprawdzania w panelu PayPal, czy klient zapłacił - status w sklepie uzgadnia się z PayPal automatycznie.
- Porzucone płatności kończą się po 3 godzinach jako błąd - obsługa wie, które zamówienia wymagają kontaktu lub anulowania.
- Klient płaci w walucie zamówienia - wygodne dla sklepów z wieloma walutami i sprzedażą zagraniczną.
- Strona PayPal z nazwą marki sklepu i w języku klienta.
- Zgodność z aktualnym sposobem integracji PayPal - brak ryzyka, że płatności przestaną działać po wyłączeniu starego mechanizmu przez PayPal.
- Szczegółowy zapis komunikacji z PayPal - szybsze wyjaśnianie reklamacji płatności.
¶ Zasady działania
- Klient wybiera PayPal w koszyku i składa zamówienie. Sklep zakłada płatność w PayPal na kwotę zamówienia w jego walucie i po kilku sekundach przekierowuje klienta na stronę PayPal.
- Na stronie PayPal klient loguje się i zatwierdza płatność. Strona PayPal wyświetla się w języku zamówienia, jeśli ten język ma przypisany kod PayPal. W przeciwnym razie - po angielsku.
- Środki są pobierane od razu po zatwierdzeniu - bez osobnej autoryzacji i późniejszego obciążenia.
- Po powrocie do sklepu klient widzi stronę potwierdzenia zamówienia ze statusem płatności.
- Status płatności w sklepie:
- oczekuje - od złożenia zamówienia do pobrania środków,
- zapłacone - środki pobrane,
- anulowane - PayPal anulował płatność,
- błąd - PayPal odrzucił pobranie środków albo płatność nie została dokończona w ciągu 3 godzin.
- Synchronizacja w tle - co 5 minut sklep sprawdza w PayPal wszystkie płatności, które nadal oczekują:
- płatność zatwierdzona przez klienta, ale jeszcze nie pobrana (np. klient zamknął przeglądarkę przed powrotem do sklepu) - sklep sam pobiera środki i oznacza płatność jako zapłaconą,
- płatność opłacona w PayPal, ale nieoznaczona w sklepie - zostaje oznaczona jako zapłacona,
- płatność niedokończona po 3 godzinach od złożenia zamówienia - zostaje oznaczona jako błąd.
- Klient przerywa płatność na stronie PayPal - wraca do sklepu na stronę błędu zamówienia. Płatność czeka do końca 3-godzinnego okna (klient może jeszcze zapłacić), potem zostaje oznaczona jako błąd.
- Po nieudanej płatności klient może ją powtórzyć albo zmienić formę płatności - według ustawień powtarzania i zmiany płatności (Płatności).
- Na stronie zamówienia klient ma przycisk "Sprawdź status płatności" - pokazuje aktualny status bez odświeżania całej strony.
¶ Przebieg płatności
¶ Przejście ze starej integracji
- Stara integracja (konfiguracja adresem e-mail konta PayPal) zostaje w platformie - sklepy, które jej używają, działają bez zmian do czasu przejścia.
- Zamówienia opłacone starą integracją nie zmieniają się.
- Przejście wymaga wdrożenia (sekcja Wdrożenie) i przygotowania przez sklep aplikacji w panelu deweloperskim PayPal - sam adres e-mail konta już nie wystarcza.
- Ustawienie kodowania znaków w profilu PayPal, wymagane przez starą integrację, nie jest już potrzebne.
- Zalecamy przejście - PayPal wycofuje mechanizm, z którego korzysta stara integracja.
¶ Wersja
- Od wersji 2.34 - w starszych wersjach dostępna jest tylko poprzednia integracja (konfiguracja adresem e-mail konta PayPal).
- Ostatnie zmiany w module: wersja 2.34.39 (w linii 2.35 - od początku tej wersji).
¶ Zależności
- Konto firmowe PayPal sklepu. Konto zakłada i weryfikuje sklep we własnym zakresie.
- Aplikacja w panelu deweloperskim PayPal (PayPal Developer, sekcja aplikacji REST API). Sklep przekazuje z niej:
- Client ID i Client Secret dla środowiska produkcyjnego (Live),
- opcjonalnie Client ID i Client Secret dla środowiska testowego (Sandbox) - do testów przed uruchomieniem.
- Dane dostępowe przekazuje się bezpiecznym kanałem, nie w treści zgłoszenia.
- Waluty sklepu muszą być obsługiwane przez PayPal i włączone na koncie PayPal sklepu.
- Płatność "PayPal" na liście płatności sklepu, powiązana z dostawami (Sposoby dostawy - przegląd).
- Regulamin sklepu z informacją o płatności PayPal - aktualizuje sklep.
¶ Wdrożenie
- Wymaga wdrożenia - moduł nie włącza się sam po aktualizacji. Zakres:
- włączenie modułu w konfiguracji sklepu (także przy przejściu ze starej integracji),
- wpisanie danych aplikacji PayPal, nazwy marki, adresów powrotu i anulowania oraz języków strony PayPal,
- założenie lub przestawienie płatności PayPal na liście płatności i powiązanie jej z dostawami,
- test płatności w środowisku testowym PayPal (zapłata, rezygnacja, brak powrotu do sklepu),
- przełączenie na środowisko produkcyjne i płatność kontrolna.
- Minimalny szacowany czas:
- szablon BS5 - od 3 h,
- szablon BS4 - od 3 h (strona przekierowania jest w obu szablonach).
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- czy sklep od razu przekazuje komplet danych (testowe i produkcyjne) - brak danych testowych wydłuża testy,
- liczba walut i języków do sprawdzenia,
- dopasowanie wyglądu strony przekierowania i komunikatów do sklepu,
- wersja sklepu - sklep na wersji starszej niż 2.34 wymaga najpierw aktualizacji (wycena osobno).
¶ Ograniczenia
- Brak zwrotów z panelu sklepu - zwrot pieniędzy (pełny i częściowy) wykonuje się w panelu PayPal, a status w sklepie oznacza się ręcznie.
- Tylko jednorazowe pobranie całej kwoty - bez autoryzacji z późniejszym obciążeniem, płatności częściowych, subskrypcji i płatności cyklicznych.
- Do PayPal trafia tylko kwota i waluta - bez numeru zamówienia, opisu i listy produktów. W panelu PayPal transakcję powiązuje się z zamówieniem po kwocie, dacie i identyfikatorze płatności PayPal.
- Sklep nie korzysta z powiadomień PayPal (webhook) - status aktualizuje się przy powrocie klienta i przez synchronizację co 5 minut.
- Płatność niedokończona w ciągu 3 godzin zostaje oznaczona jako błąd - zamówienia nie anuluje się automatycznie, decyzję podejmuje obsługa.
- Język strony PayPal trzeba przypisać do każdego języka sklepu - bez tego strona PayPal wyświetla się po angielsku.
- Domyślne polskie komunikaty strony przekierowania są bez polskich znaków - warto je poprawić w edytorze komunikatów.
- Jedno konto PayPal na sklep.
- Opłaty i prowizje PayPal, limity konta i spory z klientami (chargeback) obsługuje sklep w PayPal.
- Nie weryfikujemy konfiguracji pod kątem zgodności z prawem - regulamin, informacja o płatnościach i obowiązki wobec PayPal leżą po stronie sklepu.
¶ Potencjał rozwoju
- Zwrot płatności (pełny i częściowy) z panelu sklepu, powiązany z modułem zwrotów.
- Obsługa powiadomień PayPal (webhook) - natychmiastowa zmiana statusu bez czekania na synchronizację.
- Przekazywanie numeru zamówienia, opisu i listy produktów do PayPal.
- Przycisk PayPal i szybka płatność bezpośrednio w koszyku (PayPal Checkout, Pay Later).
- Płatność kartą bez konta PayPal na stronie PayPal.
- Obsługa walut bez części ułamkowej.
- Automatyczne anulowanie lub przypomnienie o zamówieniu z nieudaną płatnością PayPal.
¶ Najczęstsze pytania
Czy klient musi wrócić do sklepu, żeby zamówienie zostało oznaczone jako opłacone?
Nie. Sklep synchronizuje status płatności z PayPal co 5 minut i pobiera środki automatycznie, nawet gdy klient zamknie przeglądarkę po zatwierdzeniu płatności.
Czy mogę zrobić zwrot płatności PayPal z panelu sklepu?
Nie. Zwrot pieniędzy (pełny i częściowy) wykonuje się w panelu PayPal, a status w sklepie trzeba oznaczyć ręcznie.
Ile trwa wdrożenie płatności PayPal?
Od 3 h - zarówno dla szablonu BS5, jak i BS4. Czas rośnie, gdy trzeba dopasować wygląd strony przekierowania albo sprawdzić dodatkowe waluty i języki.
Czy PayPal obsługuje płatności ratalne lub subskrypcje?
Nie. Integracja pobiera jednorazowo całą kwotę zamówienia - bez autoryzacji z późniejszym obciążeniem i bez płatności cyklicznych.
Czy stara integracja PayPal (adresem e-mail) nadal działa?
Tak, zostaje w platformie i sklepy mogą jej używać bez zmian - ale PayPal wycofuje mechanizm, na którym się opiera, więc zalecamy przejście na aktualną integrację.
Czy PayPal działa dla sklepów z wieloma walutami?
Tak, o ile waluty sklepu są obsługiwane przez PayPal i włączone na koncie PayPal sklepu.
¶ Powiązane
- Płatności - przegląd - konfiguracja pozostałych metod płatności i powiązanie z dostawami.
- Zwroty - odstąpienie od umowy
- InPost Pay - inna płatność online dostępna w standardzie Hummerce.
- Na hummerce.com: Platforma B2C, Integracja PayPal.
Chcesz zobaczyć, jak płatność PayPal może działać w Waszym sklepie? Umów bezpłatną prezentację.
¶ Szczegóły konfiguracji
¶ Dostęp w panelu
- Konfiguracja w panelu: Konfiguracja -> Ustawienia, grupa PayPal:
- Client ID, Client Secret - dane aplikacji PayPal,
- Środowisko - Testowe (Sandbox) albo Produkcyjne; domyślnie testowe, przed uruchomieniem trzeba je przełączyć,
- Nazwa marki - nazwa sklepu na stronie PayPal; domyślnie "Shop", do zmiany,
- URL powrotu z PayPal - adres powrotu po zapłacie (adres sklepu +
/do/paypalReturn), - URL anulowania z PayPal - adres powrotu po rezygnacji (adres sklepu +
/do/orderError).
- Ustawienia techniczne w tej samej grupie: Interwał synchronizacji (min) (domyślnie 5), Logowanie szczegółowe, Timeout połączenia (ms), Liczba powtórzeń.
- Lista płatności: Konfiguracja -> Płatności - płatność PayPal z typem płatności online PayPal; tam też opisy sukcesu, błędu i ostrzeżenia oraz ustawienia powtarzania i zmiany płatności.
- Zamówienie w panelu: zakładka Płatności - próby płatności, ich statusy i ostatni status odczytany z PayPal.
- Zadanie w tle: "Synchronizacja płatności PayPal".
¶ Komunikaty sklepu
Teksty strony przekierowania zmienia się w edytorze komunikatów. Opisy sukcesu, błędu i ostrzeżenia po płatności ustawia się w płatności PayPal na liście płatności (Płatności). Wartości domyślne są po polsku (bez polskich znaków) i po angielsku.
¶ Strona przekierowania do PayPal
| Klucz | Wartość domyślna |
|---|---|
payment.msg.onlinePayments.paypal.info |
Zostaniesz przekierowany na strone PayPal w celu dokonania platnosci. |
payment.msg.onlinePayments.paypal.submit |
Zaplac przez PayPal |
payment.msg.onlinePayments.paypal.autoRedirect |
Zostaniesz automatycznie przekierowany za 3 sekundy... |
¶ Sprawdzanie statusu płatności - wspólne dla płatności online
| Klucz | Wartość domyślna |
|---|---|
msg.orderInfo.payment.checkStatus.btn |
Sprawdź status płatności |
msg.orderInfo.payment.checkStatus.checking |
Sprawdzam status |
msg.orderInfo.payment.checkStatus.noChange |
Status płatności nie zmienił się. Spróbuj ponownie za chwilę lub skontaktuj się z obsługą sklepu. |