Płatność PayPal dodaje do składania zamówienia przyciski PayPal: portfel PayPal, Pay Later, kartę bez konta, a w UE — iDEAL, BLIK, Przelewy24 i inne. Klient widzi je po potwierdzeniu zamówienia, a sklep sam pobiera dokładną kwotę i ustawia status.
Kiedy to się przyda:
- Sprzedajesz w UE, Wielkiej Brytanii lub USA — klienci są przyzwyczajeni do płacenia przez PayPal.
- Klient chce płacić w ratach — Pay Later, a sklep dostaje całą kwotę od razu.
- Klient nie ma konta PayPal — płaci kartą w oknie PayPal.
- Trzeba zwrócić pieniądze — przyciskiem w karcie zamówienia w Elbuz, bez logowania do panelu PayPal.
Od czego zacząć: „Ustawienia sklepu” → „Zamówienie i płatność” → PayPal → klucze, webhook i przełącznik „Włączony”.
Co potrafi płatność PayPal
- Pokazywać przyciski PayPal — portfel, Pay Later, karta, lokalne metody z UE.
- Testować płatność w sandbox — testowymi kontami PayPal, bez prawdziwych pieniędzy.
- Samodzielnie ustawiać status zamówienia — opłacone, oczekujące, odrzucone, zwrócone.
- Dowiadywać się o zmianach po płatności — zakończenie płatności, zwrot z panelu PayPal.
- Zwracać pieniądze z karty zamówienia — całą kwotę lub część.
Jak podłączyć PayPal
Potrzebujesz firmowego konta PayPal (typ Business, nie Personal). Elbuz nie ma wspólnych kluczy: moduł działa tylko z kluczami Twojej aplikacji PayPal.
- Utwórz aplikację PayPal i skopiuj klucze — gdzie dokładnie.
- Otwórz ekran modułu. „Ustawienia sklepu” → dział „Zamówienie i płatność” → karta PayPal.
- Wpisz klucze. Testowe — w blok „Klucze sandbox”, produkcyjne — w „Klucze live”.
- Dodaj webhook w aplikacji PayPal i wpisz jego „ID webhooka (Webhook ID)” — jak.
- Włącz przełącznik „Włączony” u góry ekranu.
- Kliknij „Zapisz”. Ustawienia od razu trafiają do sklepu.
- Sprawdź płatność w sandbox i przejdź na tryb produkcyjny — jak.
1
Karta PayPal2
Przełącznik stanu- Karta PayPal — kliknij, aby otworzyć ekran ustawień PayPal.
- Przełącznik na karcie pokazuje, czy klienci widzą tę metodę płatności i czy ostatnie zmiany dotarły do sklepu.
1
Przełącznik „Włączony”2
Tryb testowy (sandbox)3
Adres webhooka4
Zdarzenia webhooka5
Co jeszcze do skonfigurowania6
Wiersz trybu- „Włączony” — po zapisaniu pokazuje PayPal klientom.
- „Tryb testowy (sandbox)” — włączony: płatności idą do środowiska testowego PayPal z kluczami sandbox; wyłączony: prawdziwe płatności z kluczami live.
- „Adres webhooka” — wklej ten adres w aplikacji PayPal w sekcji Webhooks → Add Webhook.
- „Zdarzenia webhooka” — zdarzenia do zaznaczenia w webhooku.
- „Co jeszcze do skonfigurowania” — czego brakuje, żeby płatność działała.
- „Tryb” — który tryb działa teraz.
Bez Client ID i Secret bieżącego trybu włączony moduł się nie zapisze. Jak działa samo okno — w artykule „Ustawienia sklepu”.
PayPal pojawia się przy składaniu zamówienia tylko dla walut, które przyjmuje: USD, EUR, GBP, PLN, CZK, CHF i innych. Hrywien PayPal nie przyjmuje, a sklep nie przelicza kwot. Jeśli żadna waluta sklepu nie pasuje, po prawej pojawi się „Żadna waluta sklepu nie jest obsługiwana przez PayPal — klienci nie zobaczą PayPal”.
Walutę dodaje się w „Słowniki → Waluty i kursy” — jako aktywną, z kursem i zaznaczonym „Pokazuj na stronie”. Do sklepu trafi z następnym eksportem.
Skąd wziąć klucze i Webhook ID
Klucze wydaje strona PayPal dla programistów — developer.paypal.com, logowanie tym samym kontem firmowym.
- Otwórz Apps & Credentials. U góry jest przełącznik Sandbox / Live: każdy tryb ma własne aplikacje i klucze.
- Create App → nazwa sklepu, typ Merchant → zapisz.
- Skopiuj Client ID do pola „ID klienta (Client ID)”.
- Obok Secret key 1 kliknij Show i skopiuj go do „Klucz tajny (Secret)”.
| Blok na ekranie | Klucze której aplikacji | Kiedy działają |
|---|---|---|
| Klucze sandbox | Aplikacja w trybie Sandbox | Włączony „Tryb testowy (sandbox)”: bez prawdziwych pieniędzy |
| Klucze live | Aplikacja w trybie Live | Tryb testowy wyłączony: prawdziwe płatności klientów |
Karta kluczy bieżącego trybu jest rozwinięta i oznaczona „używane teraz”. Wymagane są tylko klucze tego trybu.
1
używane teraz2
Client ID3
Klucz tajny4
Webhook ID5
Klucze live- Klucze tego trybu są teraz używane; tylko one są wymagane.
- Client ID aplikacji PayPal (Apps & Credentials).
- Klucz tajny z tej samej strony; po zapisaniu nie jest pokazywany, widać tylko znacznik, że jest ustawiony.
- Webhook ID z sekcji Webhooks tej samej aplikacji.
- Klucze drugiego trybu; kliknij, aby rozwinąć.
Klucz tajny po zapisaniu nie jest pokazywany — w polu widać tylko „ustawiono”. Aby go zmienić, kliknij „Zastąp” i wklej nowy.
Po co webhook i jak go dodać
Webhook to powiadomienie od PayPal o tym, co stało się już po płatności. Bez niego płatność działa, ale sklep nie dowie się:
- że oczekująca płatność została zakończona lub odrzucona;
- że pieniądze zwrócono w panelu PayPal;
- że klient zapłacił i zamknął kartę, nie czekając na sklep.
- W bloku „Połączenie” skopiuj „Adres webhooka” przyciskiem „Kopiuj”.
- Na developer.paypal.com: ta sama aplikacja → Webhooks → Add Webhook. Wklej adres.
- Zaznacz zdarzenia z pola „Zdarzenia webhooka” — można je skopiować przyciskiem „Kopiuj wszystkie”. Zapisz.
- PayPal pokaże Webhook ID — wpisz go w „ID webhooka (Webhook ID)” w tym samym bloku kluczy.
- Powtórz dla drugiego trybu: w Sandbox i Live webhooki są osobne.
Dopóki Webhook ID bieżącego trybu jest pusty, po prawej wisi „Brak Webhook ID — nie dotrą zdarzenia PayPal…”.
Każde powiadomienie sklep weryfikuje w samym PayPal według Webhook ID, a o płatność jeszcze raz pyta PayPal. Podrobione powiadomienie nie zmieni zamówienia. Adres webhooka musi zaczynać się od https:// i nie może być zasłonięty hasłem do strony ani ochroną przed botami.
Jak sprawdzić w sandbox
Sandbox to testowy PayPal: bez prawdziwych pieniędzy, bez umowy i firmy.
- Na developer.paypal.com: Testing Tools → Sandbox Accounts. Jest tam już testowe konto firmowe i testowe konto osobiste dla klienta.
- Na ekranie modułu „Tryb testowy (sandbox)” jest włączony, w „Klucze sandbox” — klucze i Webhook ID. Zapisz.
- Przełącz witrynę na walutę PayPal, na przykład EUR, i złóż zamówienie z PayPal.
- Nad przyciskami będzie „Tryb testowy PayPal (sandbox): prawdziwe pieniądze nie są pobierane.” Zaloguj się testowym kontem osobistym i zapłać.
- Zamówienie w Elbuz dostanie status z pola „Opłacone”. Samą płatność widać w panelu sandbox PayPal.
- Wyłącz „Tryb testowy (sandbox)”, wypełnij „Klucze live” i zapisz.
Dopóki tryb testowy jest włączony, po prawej wisi „Włączony tryb testowy — pieniądze nie są pobierane. Wyłącz go przed sprzedażą”.
Po przejściu na live sklep sam zamyka nieopłacone próby testowe. Płatność testowa w trybie produkcyjnym nie oznaczy zamówienia jako opłaconego.
Jakie przyciski widzi klient
Przyciski rysuje sam PayPal. Blok „Przyciski w zamówieniu” wybiera ich wygląd i dozwolone metody. Czy pokazać metodę konkretnemu klientowi, decyduje PayPal: według kraju, waluty i kwoty.
1
Układ2
Pay Later3
Lokalne metody z UE4
Przycisk karty5
Formularz karty na stronie- Wygląd przycisków: warianty samego PayPal.
- Raty dla klienta, pełna kwota dla sklepu od razu.
- iDEAL, Bancontact, EPS, MyBank dla EUR; BLIK i Przelewy24 dla PLN.
- Płatność kartą bez konta PayPal.
- Pola karty bezpośrednio w sklepie, jeśli PayPal włączył Advanced Credit and Debit Card Payments.
| Pole | Co daje | Domyślnie |
|---|---|---|
| Płatność później w ratach (Pay Later) | Klient płaci PayPal w ratach, sklep dostaje całą kwotę od razu. Dostępne tylko w krajach, gdzie PayPal to oferuje, na przykład UK, DE, FR, ES, IT, US | Włączone |
| Lokalne metody z UE | Osobne przyciski lokalnych metod: w euro — iDEAL, Bancontact, EPS, MyBank; w złotych — BLIK i Przelewy24 | Włączone |
| Przycisk karty | „Debit or Credit Card”: płatność kartą bez konta PayPal, bez osobnej umowy | Włączone |
| Formularz karty na stronie | Pola karty bezpośrednio w sklepie, z 3-D Secure, gdy wymaga go bank. Potrzebna jest usługa Advanced Credit and Debit Card Payments na Twoim koncie PayPal. Bez niej formularz się nie pojawi, a przycisk karty zostanie | Wyłączone |
„Układ”, „Kolor”, „Kształt” i „Tekst na przycisku” to warianty samego PayPal. Pionowo — wszystkie metody jedna pod drugą, poziomo — dwa przyciski obok siebie.
Język przycisków to główny język sklepu: angielski, polski, niemiecki, francuski, hiszpański, włoski lub rosyjski. PayPal nie ma ukraińskiego — dla niego przyciski są po angielsku.
Jak płaci klient i dla jakich zamówień
Przy składaniu zamówienia metoda nazywa się „PayPal”. Po potwierdzeniu zamówienia pojawiają się przyciski, klient wybiera metodę i płaci w oknie PayPal.
| Co się stało | Co widzi klient |
|---|---|
| Zapłacił | Stronę udanego zamówienia |
| Zamknął okno PayPal | „Płatność anulowana. Wybierz metodę płatności jeszcze raz.” |
| Bank odrzucił kartę | PayPal proponuje inną metodę w tym samym oknie |
| Zmienił koszyk w innej karcie | „Kwota zamówienia się zmieniła. Naciśnij przycisk PayPal jeszcze raz.” Starej kwoty PayPal nie pobierze |
| Przyciski się nie załadowały | „Nie udało się załadować PayPal…” — najczęściej przeszkadza blokowanie reklam |
Kwotę płatności liczy sklep: to bieżąca kwota zamówienia w walucie wybranej przez klienta. Dla portfela i Pay Later PayPal nie pyta o adres dostawy — jest już w zamówieniu.
Dla jakich zamówień pokazywać
- „Strefa geograficzna” — PayPal tylko dla klientów z adresem w tej strefie; „Wszystkie strefy” — dla wszystkich.
- „Minimalna kwota zamówienia” — PayPal pojawia się od tej kwoty w walucie bazowej sklepu. Puste lub
0— zawsze. - „Kolejność sortowania” — miejsce na liście płatności, mniejsza liczba stoi wyżej.
Statusy zamówienia
Status ustawia sam sklep i właśnie ten status widzisz w Elbuz. Szczegóły płatności — w panelu PayPal. Jakie statusy ustawiać, wybierasz w bloku „Statusy zamówienia”.
1
Opłacone2
Oczekujące3
Odrzucona4
Zwrócono- Ustawiany, gdy PayPal pobrał pieniądze.
- PayPal wstrzymał płatność; moduł sam ustawi później „Opłacone”.
- PayPal odrzucił oczekującą płatność.
- Ustawiany po pełnym zwrocie.
| Pole | Kiedy jest ustawiany | Domyślnie |
|---|---|---|
| Opłacone | PayPal pobrał pieniądze. Klient dostaje zwykły e-mail o zamówieniu | „W realizacji” |
| Oczekujące | PayPal przyjął płatność, ale ją wstrzymał: eCheck, weryfikacja, lokalna metoda z późnym potwierdzeniem | „Oczekujące” |
| Odrzucona | PayPal odrzucił oczekującą płatność | „Odrzucone” |
| Zwrócono | Klientowi zwrócono całą kwotę | „Zwrócono środki” |
Dopóki klient nie zapłaci, zamówienie pozostaje niepotwierdzone. Ponowna próba płatności nie tworzy dodatkowego zamówienia. Z „Oczekujące” do „Opłacone” lub „Odrzucona” zamówienie przechodzi samo dzięki webhookowi albo po „Odśwież status” w karcie zamówienia.
Kiedy status się nie zmienia
- Inna kwota. Koszyk zmieniono akurat w chwili płatności. Pieniądze są w panelu PayPal, a zamówienie nie jest opłacone: zwróć płatność albo dosprzedaj różnicę.
- Druga płatność. Zamówienie jest już opłacone, a w panelu PayPal są za nie dwie płatności: zwróć nadmiarową.
- Płatność testowa w trybie produkcyjnym. Płatność z sandbox nie oznaczy zamówienia jako opłaconego.
Zwrot i status płatności w karcie zamówienia
Zamówienie ze strony trafia do dokumentów „Zamówienie klienta” w Elbuz ze sposobem płatności „PayPal”. W jego karcie jest blok „Płatność w PayPal”: stan płatności, kwota, ile pobrano, ile zwrócono i ile jeszcze można zwrócić. Niżej — wszystkie próby płatności.
Przyciski — tylko te, które są teraz dostępne dla zamówienia:
| Przycisk | Co robi |
|---|---|
| Zwróć środki | Zwraca klientowi całą kwotę lub część. Pole kwoty jest już wypełnione pozostałą kwotą: aby zwrócić wszystko, zostaw proponowaną kwotę |
| Odśwież status | Pobiera stan płatności z PayPal, jeśli webhook nie dotarł |
Przed zwrotem program prosi o potwierdzenie z ostrzeżeniem „Tej operacji nie można cofnąć.”. Status zamówienia zmienia się tak samo jak po powiadomieniu PayPal.
Pełny zwrot ustawia status z pola „Zwrócono”. Po częściowym status zostaje, a zwróconą kwotę widać w bloku „Płatność w PayPal”. Klient nie dostaje e-maila o zwrocie.
Sklep nie odpowiedział — pojawi się „Nie wiadomo, czy operacja przeszła. Kliknij «Powtórz» — pieniądze nie zostaną przesunięte drugi raz”. „Powtórz” powtarza tę samą operację, a ponowne kliknięcie „Zwróć środki” to już nowy zwrot.
Zwracać pieniądze może tylko użytkownik z uprawnieniem „Operacje płatności: zwrot, blokada, kredyt” — domyślnie właściciel. „Odśwież status” jest dostępny dla każdego, kto widzi zamówienie.
Zwrotu można dokonać też w panelu PayPal: płatność → Refund, cała kwota lub część. Zamówienie dowie się o tym przez webhook, jeśli Webhook ID jest wypełniony.
Gdy przez PayPal były już zamówienia, nagłówek ekranu modułu pokazuje je za 30 dni: liczbę, kwotę, średnią wartość zamówienia i udział anulowanych lub zwróconych.
Scenariusze
AGD: pralka na raty w Niemczech
Pralka kosztuje 900 EUR, a klient nie chce płacić całości od razu. Włącz EUR w walutach, zostaw „Płatność później w ratach (Pay Later)”, „Układ” — pionowo. Klient wybiera Pay Later, a zamówienie samo staje się opłacone.
Elektronika: laptop bez konta PayPal
Klient nie chce zakładać konta PayPal. „Przycisk karty” zostaje włączony — pod PayPal będzie „Debit or Credit Card”. Jeśli PayPal udostępnił Ci Advanced Credit and Debit Card Payments, włącz „Formularz karty na stronie”.
Słuchawki do Holandii, Belgii i Polski
Klienci są tam przyzwyczajeni do iDEAL, Bancontact i BLIK. Włącz „Lokalne metody z UE” i waluty EUR oraz PLN. Klient z Holandii widzi iDEAL, z Belgii — Bancontact, z Polski płacący w złotych — BLIK i Przelewy24.
Odzież: zwrot pieniędzy za jeden rozmiar
Klient zamówił kurtkę w dwóch rozmiarach i jedną zwraca. W karcie zamówienia kliknij „Zwróć środki” i wpisz cenę jednej kurtki. Status zamówienia pozostanie opłacony, zwrot widać w bloku „Płatność w PayPal”.
Pamiątki: PayPal tylko za granicę i od 30 USD
W „Strefa geograficzna” wybierz strefę z potrzebnymi krajami. „Minimalna kwota zamówienia” — 30 USD przeliczone na walutę bazową sklepu. PayPal widzą tylko klienci z zagranicy z koszykiem od tej kwoty.
Co zrobić, gdy płatność nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Klient nie widzi PayPal przy składaniu zamówienia | Moduł jest wyłączony, brak kluczy bieżącego trybu, ceny są w walucie, której PayPal nie przyjmuje (na przykład w hrywnach), kwota jest mniejsza od minimalnej lub adres nie należy do strefy geograficznej | Sprawdź „Włączony”, klucze, walutę witryny, „Minimalna kwota zamówienia” i „Strefa geograficzna” |
| Metoda jest, a przyciski się nie pojawiają | Blokowanie reklam u klienta albo błąd w Client ID | Wklej Client ID jeszcze raz. Sprawdź w innej przeglądarce |
| Klient widzi „Nie udało się rozpocząć płatności PayPal” | Klucze z innego trybu (Sandbox zamiast Live) lub z innej aplikacji | Wpisz klucze aplikacji właśnie tego trybu, który działa teraz |
| Płatność ma status „Oczekujące” i się nie zmienia | Webhook nie dociera: brak Webhook ID, inny adres, brakuje zdarzeń lub adres jest zasłonięty ochroną strony | Kliknij „Odśwież status” w karcie zamówienia. Potem sprawdź webhook w aplikacji PayPal według bloku „Połączenie” |
| Brak Pay Later lub lokalnej metody | PayPal pokazuje je tylko dla określonych krajów, walut i kwot | Sprawdź, czy przełącznik jest włączony. Resztą zarządza PayPal |
| „Sklep nie przyjął ustawień” lub „Sklep nie przyjął części wartości — zobacz zaznaczone pola” | Sklep nie odpowiedział albo odrzucił poszczególne pola | Popraw zaznaczone pola i zapisz. Jeśli żadne pole nie jest zaznaczone, zmiany pójdą z następnym eksportem |
Najczęstsze pytania
Czy sklep z Ukrainy może przyjmować PayPal?
Moduł działa z każdym firmowym kontem PayPal, a warunki konta określa PayPal. Ceny w witrynie muszą być w dolarach, euro lub innej walucie PayPal: hrywien PayPal nie przyjmuje.
Co się stanie, jeśli wyłączę moduł?
PayPal zniknie ze składania zamówienia. Klucze i ustawienia zostają zachowane: po ponownym włączeniu wszystko jest na miejscu.
Czy można wysłać klientowi z Elbuz link do płatności PayPal?
Nie. Link do płatności z karty zamówienia działa z innymi serwisami: Płatność przez link.
Jak zwrócić klientowi pieniądze za PayPal?
W karcie zamówienia w Elbuz kliknij „Zwróć środki” w bloku „Płatność w PayPal”. E-mail o zwrocie do klienta nie jest wysyłany.
Na liście „Strefa geograficzna” nie ma potrzebnej strefy — co zrobić?
Strefę, na przykład „Kraje UE”, tworzy wsparcie Elbuz. Potem wybierz ją w bloku „Gdzie pokazywać”.
Czy można zmienić nazwę metody przy składaniu zamówienia?
Tak, przez wsparcie Elbuz. Na ekranie modułu nie ma takiego pola.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Ustawienia sklepu → „Zamówienie i płatność” → PayPal
- Uprawnienia
- okno „Ustawienia sklepu” w „Uprawnieniach grup”
- Przygotuj
- firmowe konto PayPal, aplikacje Sandbox i Live, walutę PayPal w sklepie
Powiązane tematy
- Jeśli chcesz zrozumieć, jak działa okno ustawień sklepu — Ustawienia sklepu.
- Jeśli sprzedajesz na Litwę, Łotwę lub do Estonii — Jak przyjmować płatności Paysera w sklepie.
- Jeśli trzeba dodać walutę sklepu — Waluty i kursy.
- Jeśli trzeba obsłużyć opłacone zamówienie w Elbuz — Zamówienie klienta.
