↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak przyjmować płatności PayPal w sklepie

    7 min czytaniaZaktualizowano

    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

    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.

    1. Utwórz aplikację PayPal i skopiuj klucze — gdzie dokładnie.
    2. Otwórz ekran modułu. „Ustawienia sklepu” → dział „Zamówienie i płatność” → karta PayPal.
    3. Wpisz klucze. Testowe — w blok „Klucze sandbox”, produkcyjne — w „Klucze live”.
    4. Dodaj webhook w aplikacji PayPal i wpisz jego „ID webhooka (Webhook ID)” — jak.
    5. Włącz przełącznik „Włączony” u góry ekranu.
    6. Kliknij „Zapisz”. Ustawienia od razu trafiają do sklepu.
    7. Sprawdź płatność w sandbox i przejdź na tryb produkcyjny — jak.
    Dział „Zamówienie i płatność” w „Ustawieniach sklepu” z kartami modułów, w tym PayPal
    1Karta PayPal
    2Przełącznik stanu
    1. Karta PayPal — kliknij, aby otworzyć ekran ustawień PayPal.
    2. Przełącznik na karcie pokazuje, czy klienci widzą tę metodę płatności i czy ostatnie zmiany dotarły do sklepu.
    Zmaksymalizowane okno modułu PayPal z blokiem „Połączenie” i kartami bocznymi
    1Przełącznik „Włączony”
    2Tryb testowy (sandbox)
    3Adres webhooka
    4Zdarzenia webhooka
    5Co jeszcze do skonfigurowania
    6Wiersz trybu
    1. „Włączony” — po zapisaniu pokazuje PayPal klientom.
    2. „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.
    3. „Adres webhooka” — wklej ten adres w aplikacji PayPal w sekcji Webhooks → Add Webhook.
    4. „Zdarzenia webhooka” — zdarzenia do zaznaczenia w webhooku.
    5. „Co jeszcze do skonfigurowania” — czego brakuje, żeby płatność działała.
    6. „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.

    1. Otwórz Apps & Credentials. U góry jest przełącznik Sandbox / Live: każdy tryb ma własne aplikacje i klucze.
    2. Create App → nazwa sklepu, typ Merchant → zapisz.
    3. Skopiuj Client ID do pola „ID klienta (Client ID)”.
    4. Obok Secret key 1 kliknij Show i skopiuj go do „Klucz tajny (Secret)”.
    Blok na ekranieKlucze której aplikacjiKiedy działają
    Klucze sandboxAplikacja w trybie SandboxWłączony „Tryb testowy (sandbox)”: bez prawdziwych pieniędzy
    Klucze liveAplikacja w trybie LiveTryb 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.

    Rozwinięta karta „Klucze sandbox” i zwinięta karta „Klucze live”
    1używane teraz
    2Client ID
    3Klucz tajny
    4Webhook ID
    5Klucze live
    1. Klucze tego trybu są teraz używane; tylko one są wymagane.
    2. Client ID aplikacji PayPal (Apps & Credentials).
    3. Klucz tajny z tej samej strony; po zapisaniu nie jest pokazywany, widać tylko znacznik, że jest ustawiony.
    4. Webhook ID z sekcji Webhooks tej samej aplikacji.
    5. 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.
    1. W bloku „Połączenie” skopiuj „Adres webhooka” przyciskiem „Kopiuj”.
    2. Na developer.paypal.com: ta sama aplikacja → Webhooks → Add Webhook. Wklej adres.
    3. Zaznacz zdarzenia z pola „Zdarzenia webhooka” — można je skopiować przyciskiem „Kopiuj wszystkie”. Zapisz.
    4. PayPal pokaże Webhook ID — wpisz go w „ID webhooka (Webhook ID)” w tym samym bloku kluczy.
    5. 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.

    1. Na developer.paypal.com: Testing Tools → Sandbox Accounts. Jest tam już testowe konto firmowe i testowe konto osobiste dla klienta.
    2. Na ekranie modułu „Tryb testowy (sandbox)” jest włączony, w „Klucze sandbox” — klucze i Webhook ID. Zapisz.
    3. Przełącz witrynę na walutę PayPal, na przykład EUR, i złóż zamówienie z PayPal.
    4. Nad przyciskami będzie „Tryb testowy PayPal (sandbox): prawdziwe pieniądze nie są pobierane.” Zaloguj się testowym kontem osobistym i zapłać.
    5. Zamówienie w Elbuz dostanie status z pola „Opłacone”. Samą płatność widać w panelu sandbox PayPal.
    6. 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.

    Blok „Przyciski w zamówieniu” z układem, kolorem, kształtem, tekstem i czterema przełącznikami
    1Układ
    2Pay Later
    3Lokalne metody z UE
    4Przycisk karty
    5Formularz karty na stronie
    1. Wygląd przycisków: warianty samego PayPal.
    2. Raty dla klienta, pełna kwota dla sklepu od razu.
    3. iDEAL, Bancontact, EPS, MyBank dla EUR; BLIK i Przelewy24 dla PLN.
    4. Płatność kartą bez konta PayPal.
    5. Pola karty bezpośrednio w sklepie, jeśli PayPal włączył Advanced Credit and Debit Card Payments.
    PoleCo dajeDomyś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, USWłączone
    Lokalne metody z UEOsobne przyciski lokalnych metod: w euro — iDEAL, Bancontact, EPS, MyBank; w złotych — BLIK i Przelewy24Włączone
    Przycisk karty„Debit or Credit Card”: płatność kartą bez konta PayPal, bez osobnej umowyWłączone
    Formularz karty na stroniePola 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 zostanieWyłą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łoCo 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”.

    Blok „Statusy zamówienia” z czterema polami statusów
    1Opłacone
    2Oczekujące
    3Odrzucona
    4Zwrócono
    1. Ustawiany, gdy PayPal pobrał pieniądze.
    2. PayPal wstrzymał płatność; moduł sam ustawi później „Opłacone”.
    3. PayPal odrzucił oczekującą płatność.
    4. Ustawiany po pełnym zwrocie.
    PoleKiedy jest ustawianyDomyślnie
    OpłaconePayPal pobrał pieniądze. Klient dostaje zwykły e-mail o zamówieniu„W realizacji”
    OczekującePayPal przyjął płatność, ale ją wstrzymał: eCheck, weryfikacja, lokalna metoda z późnym potwierdzeniem„Oczekujące”
    OdrzuconaPayPal odrzucił oczekującą płatność„Odrzucone”
    ZwróconoKlientowi 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:

    PrzyciskCo robi
    Zwróć środkiZwraca klientowi całą kwotę lub część. Pole kwoty jest już wypełnione pozostałą kwotą: aby zwrócić wszystko, zostaw proponowaną kwotę
    Odśwież statusPobiera 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 widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo