Easy Digital Downloads posiada wbudowaną integrację z PayPal. Ta bramka wykorzystuje najnowsze rozwiązanie PayPal Checkout, korzystając z inteligentnych przycisków i okna modalnego „Zapłać przez PayPal”, które utrzymuje użytkowników na Twojej stronie przez cały proces płatności. Niniejsza dokumentacja zawiera wszystko, co musisz wiedzieć o zarządzaniu konfiguracją PayPal.
Aktualizacja z innej bramki PayPal? Zobacz nasze notatki dotyczące aktualizacji.
UWAGA: Ta integracja PayPal wymaga certyfikatu SSL. Jeśli jeszcze go nie masz, zapoznaj się z naszym artykułem na temat konfiguracji SSL.
Konfiguruj PayPal
1. Połącz się ze swoim kontem PayPal
Będziesz potrzebować konta PayPal, aby akceptować płatności za pomocą tej bramki. Jeśli jeszcze go nie masz, otrzymasz opcję utworzenia go podczas procesu wdrażania.
Zaloguj się do swojego panelu administracyjnego WordPress i przejdź do Pobrane » Ustawienia » Płatności » PayPal. Zobaczysz przycisk do połączenia z PayPal w bieżącym trybie Twojego sklepu (sandbox lub na żywo).
Kliknij przycisk, aby otworzyć okno modalne PayPal. Zostaniesz poproszony o podanie adresu e-mail i kraju. Postępuj zgodnie z krokami, aby zalogować się na istniejące konto lub utworzyć nowe.
Ważne: Musisz mieć włączone wyskakujące okienka w przeglądarce, aby strona PayPal mogła otworzyć się w oknie modalnym. Jeśli nie widzisz okna modalnego, sprawdź ustawienia wyskakujących okienek w przeglądarce, zamknij przeglądarkę i spróbuj ponownie. Jeśli okno wyskakujące nadal się nie pojawia, możesz spróbować z przeglądarką Chrome.
Jeśli napotkasz błąd podczas połączenia z PayPal i problem będzie się utrzymywał, może to być spowodowane regułami serwera uniemożliwiającymi pojawienie się okna modalnego połączenia. Może to objawiać się jako błąd związany z funkcją `hash_equals`. Aby to rozwiązać, Ty lub Twój hosting może być konieczne dostosowanie `Cross-Origin-Opener-Policy`. Jeśli wartość to „same-origin”, może to spowodować ten problem.
Jeśli łączysz się w trybie testowym, będziesz musiał zalogować się przy użyciu danych logowania do swojego konta sandbox. Jeśli jeszcze nie masz konta PayPal sandbox, zapoznaj się z naszym artykułem na temat tworzenia konta.
Po wykonaniu wszystkich kroków powinieneś zobaczyć ten komunikat o sukcesie:
Upewnij się, że klikniesz przycisk, aby powrócić do swojego sklepu. Jeśli nie klikniesz tego przycisku, nie będziemy w stanie zakończyć procesu wdrażania i będziesz musiał zacząć od nowa.
2. Sprawdź status swojego konta
W ustawieniach administracyjnych EDD obszar „Status połączenia” sprawdzi Twoje połączenie z PayPal. Istnieją trzy możliwości:
Sukces
Twoje konto zostało pomyślnie połączone, jesteś gotowy do akceptowania płatności, a EDD utworzyło webhook w Twoim imieniu. Więcej o webhooku możesz przeczytać w sekcji webhook.
Sukces, z ostrzeżeniem dotyczącym webhooka
Oznacza to, że Twoje konto PayPal zostało pomyślnie połączone i możesz zacząć przyjmować płatności. Jednak EDD nie udało się utworzyć webhooka w Twoim imieniu. Nie jest to coś, czym musisz się martwić w środowisku lokalnym, ale jeśli zdarzy się to na Twojej aktywnej stronie, skontaktuj się z pomocą techniczną EDD. Więcej o tym, do czego służy webhook, możesz przeczytać w sekcji webhook.
Błąd
Możesz również otrzymać komunikat o błędzie podobny do tego. Większość błędów w „Statusie płatności” oznacza, że coś w Twoim koncie PayPal nie jest gotowe do przyjmowania płatności. Oznacza to, że musisz skontaktować się z obsługą klienta PayPal lub wykonać coś w swoim koncie PayPal, na przykład potwierdzić swój adres e-mail.
Po poprawieniu wszelkich błędów kliknij „Sprawdź ponownie status płatności”, aby ponownie zweryfikować swoje konto w PayPal. Wszystkie błędy muszą zostać rozwiązane, zanim będziesz mógł zacząć akceptować płatności.
3. Włącz bramkę PayPal
Po połączeniu upewnij się, że bramka jest włączona w ogólnych ustawieniach bramki:
Powtórz w trybie na żywo
Jeśli początkowo połączysz się w trybie testowym, będziesz musiał powtórzyć ten proces połączenia, gdy przełączysz swój sklep na tryb na żywo.
Webhook
Easy Digital Downloads automatycznie spróbuje utworzyć webhooka w Twoim imieniu. Webhook służy przede wszystkim do przekazywania działań, które mają miejsce w panelu PayPal, z powrotem do EDD. Na przykład: jeśli zwrócisz płatność w PayPal, EDD to wykryje i automatycznie zaktualizuje status płatności w EDD dla Ciebie.
Webhooks nie są wymagane do przetwarzania płatności, ale są zalecane dla najbardziej kompletnej integracji.
Sprawdzanie statusu webhooka
Możesz sprawdzić status swojego webhooka w dowolnym momencie, przechodząc do Pobrane » Ustawienia » Płatności » PayPal. Status webhooka będzie wymieniony wraz z zarejestrowanymi zdarzeniami.
Przycisk „Synchronizuj webhook” po prostu ponownie sprawdzi status webhooka i zarejestruje wszelkie brakujące zdarzenia. Zazwyczaj nie musisz klikać tego przycisku, chyba że:
- Zmieniłeś adres URL swojej witryny; lub
- Widzisz komunikat ostrzegawczy o tym, że webhook nie jest w pełni skonfigurowany, lub ostrzeżenie o brakujących zdarzeniach.
Adres zwrotny IPN
Easy Digital Downloads pozwoli Ci teraz używać zapasowej usługi IPN, która obsługuje wszelkie scenariusze, w których zdarzenie Webhook może nie zostać dostarczone do Twojej witryny.
Aby skonfigurować IPN, musisz zalogować się na swoje konto PayPal i najechać kursorem na ikonę koła zębatego w prawym górnym rogu ekranu, a następnie wybrać Ustawienia konta
Kliknij Powiadomienia po lewej stronie ekranu, a następnie kliknij Aktualizuj obok Natychmiastowe powiadomienia o płatnościach.
Jeśli wcześniej nie miałeś włączonego IPN, zobaczysz przycisk Wybierz ustawienia IPN. Na stronie ustawień IPN dodaj adres URL swojej witryny w formacie: https://twojastrona.com/?edd-listener=eppe
Zastąp twojastrona.com w linku swoim rzeczywistym adresem URL witryny.
Zaznacz pole Odbieraj wiadomości IPN (Włączone), a następnie kliknij Zapisz.
To już wszystko! Będzie to teraz działać jako zapasowe rozwiązanie dla głównego Webhooka, którego używa konfiguracja PayPal podczas łączenia Twojego konta.
PayPal Commerce Pro
PayPal Commerce Pro to płatne rozszerzenie, które pozwala klientom płacić kartą kredytową lub debetową oraz alternatywnymi metodami płatności (w zależności od kraju), takimi jak Venmo, Apple Pay i Google Pay, bezpośrednio na Twojej stronie, zamiast przekierowywania klientów na stronę PayPal.
Po zainstalowaniu i aktywowaniu w ustawieniach PayPal, znajdujących się w Downloads » Settings » Payments » PayPal, pojawi się nowe ustawienie „Enable Advanced Credit and Debit Card Payments”.
Po włączeniu przyciski „Debit or Credit Card” i „Pay Later” (jeśli są obsługiwane przez Twoje konto PayPal) pojawią się na stronie realizacji zakupu, obok przycisku PayPal.
Doświadczenie płatności
Ta brama płatności wykorzystuje nowoczesne przyciski płatności PayPal. Zamiast zwykłego przycisku „Kup”, Twoi klienci zobaczą to na końcu formularza realizacji zakupu:
Po kliknięciu przycisku otwiera się okno modalne na PayPal.com, proszące użytkownika o zalogowanie się do jego konta PayPal. Klient może dokończyć cały proces zakupu bez opuszczania Twojej strony.
Integracja płatności cyklicznych
Ta brama PayPal ma pełne wsparcie dla rozszerzenia Recurring Payments. Zapoznaj się z dokumentacją konfiguracji Recurring Payments PayPal, aby uzyskać instrukcje konfiguracji.
Obsługa przeglądarek
Wsparcie jest gwarantowane dla następujących przeglądarek stacjonarnych. W przypadku przeglądarek nieznajdujących się na tej liście przyciski mogą nadal działać, ale kompatybilność nie jest gwarantowana.
- Chrome w wersji 41 i nowszej
- Firefox w wersji 43 i nowszej
- Safari w wersji 8 i nowszej
- Opera w wersji 12 i nowszej
- Edge w wersji 14 i nowszej
- * Internet Explorer w wersji 11 i nowszej
* Uwaga: Chociaż przyciski powinny działać w IE11, musimy załadować kilka polyfilli, aby zapewnić kompatybilność. Aby zapewnić najlepsze wrażenia podczas realizacji zakupu, zalecamy używanie nowocześniejszej przeglądarki. Jeśli wolisz nie ładować polyfilli dla IE11, możesz je wyłączyć, dodając ten niestandardowy kod do swojej witryny:
add_filter( 'edd_load_ie11_polyfills', '__return_false' );
Jeśli dodasz ten fragment kodu, brama PayPal nie będzie działać w IE11.
Więcej informacji o wymaganiach przeglądarki PayPal Checkout można znaleźć na stronie wsparcia przeglądarek PayPal.
Tworzenie konta PayPal Sandbox
PayPal Sandbox pozwala na skonfigurowanie kont testowych, które mogą być używane do testowania pełnego procesu zakupu w Easy Digital Downloads z bramką PayPal. Nie są naliczane żadne rzeczywiste opłaty i możesz z niego korzystać tak długo, jak chcesz, ponieważ są to konta testowe naśladujące rzeczywisty przepływ PayPal.
Aby utworzyć konto sandbox, odwiedź https://developer.paypal.com i kliknij Login lub Signup , jeśli nie masz jeszcze skonfigurowanego konta PayPal. Możesz zalogować się na swoje istniejące konto PayPal, jeśli je posiadasz.
Po zalogowaniu wykonaj poniższe kroki, aby utworzyć konto Sandbox
- Przejdź do Narzędzia testowe > Konta Sandbox.
- Kliknij „Utwórz konto”.
- Wybierz „Business”, wybierz kraj konta i kliknij „Create Account”.
- Kliknij ponownie „Create Account”, a tym razem wybierz „Personal” jako typ konta.
Powyższe kroki utworzą konto Merchant, którego będziesz używać do połączenia w EDD, oraz konto Personal, którego będziesz używać podczas procesu Checkout do symulacji płatności.
Na stronie Sandbox Accounts możesz kliknąć konto, które chcesz wyświetlić/edytować, i możesz wyświetlić domyślne hasło, które zostało ustawione podczas tworzenia, lub ustawić własne hasło.
Skąd mam wiedzieć, że jestem w trybie testowym?
Aby upewnić się, że Twoja witryna działa w trybie testowym, przejdź do Downloads » Settings » Payments, i zaznacz pole Test Mode na górze strony.
Pamiętaj
Zanim przejdziesz na żywo ze swoją witryną, wyłącz tryb testowy, w przeciwnym razie żadna z Twoich sprzedaży nie będzie ważna. Może być wymagane połączenie z Twoim kontem PayPal na żywo po dezaktywacji trybu testowego.
Aktualizacja z innych bramek PayPal
Aktualizacja do nowej bramki PayPal polega po prostu na połączeniu, wykonaniu powyższych kroków konfiguracji, a następnie wyłączeniu starej bramki.
Jeśli wcześniej korzystałeś z jednej z naszych starych integracji PayPal, takich jak PayPal Standard, PayPal Express, PayPal Pro lub PayPal Payments Advanced, zostaniesz poproszony o przejście na tę nową bramkę po zaktualizowaniu do wersji Easy Digital Downloads 2.11.
Jak działa aktualizacja?
Dopóki nie połączysz się z nową bramką, płatności będą nadal przetwarzane przez Twoją witrynę przy użyciu istniejącej bramki, którą wybrałeś. Kiedy połączysz się z nową integracją PayPal, powinieneś połączyć się przy użyciu tego samego konta PayPal, którego używałeś wcześniej. Po zakończeniu procesu połączenia i włączeniu nowej bramki płatności zaczną być przetwarzane za pośrednictwem nowej integracji PayPal. Pamiętaj, aby wyłączyć starą bramkę, aby aktywna była tylko nowa.
W samym PayPal nie zauważysz żadnej różnicy. Płatności będą nadal przychodzić w ten sam sposób, co wcześniej. Zaktualizowano tylko doświadczenie płatności na Twojej stronie.
A co z płatnościami cyklicznymi?
Jeśli korzystasz z naszego rozszerzenia Recurring Payments, możesz bezpiecznie przejść na nową bramkę PayPal bez wpływu na istniejące subskrypcje. Stare subskrypcje będą nadal przetwarzane i odnawiane jak zwykle. Jednak:
- Po skonfigurowaniu nowej bramki możesz odznaczyć starą bramkę z listy włączonych bramek płatności.
- Dla PayPal Express i Pro musisz zachować starą konfigurację PayPal IPN (Dokumentacja Express / Pro IPN), ponieważ subskrypcje utworzone za pomocą starej bramki będą nadal używać IPN, aby EDD wiedziało o płatnościach odnowienia. PayPal Standard nie polega na IPN, ponieważ adres URL jest na stałe ustawiony w IPN. Jeśli nie używasz swojego konta PayPal z wieloma sklepami, zalecamy ustawienie go na wypadek, gdyby PayPal zmienił funkcjonalność w przyszłości (Dokumentacja Standard IPN), ale nie jest to wymagane.
- Jeśli używasz PayPal Express lub PayPal Pro, musisz zachować ten wtyczkę aktywowaną. Bramka sama w sobie nie powinna być włączona (Pobrane pliki » Ustawienia » Płatności), ale wtyczka powinna być. Ma to na celu zapewnienie, że bramka będzie nadal przetwarzać stare IPN, zgodnie z opisem w kroku 2.
Uwaga: Używasz Aelia Currency Switcher?
PayPal będzie musiał zostać ponownie dodany w Ustawieniach Bram Płatności Aelia dla walut obsługiwanych na Twojej stronie. W przeciwnym razie PayPal nie będzie już dostępną bramką przy kasie.
Czy muszę zaktualizować do nowej integracji?
Wszystkie stare integracje PayPal zostaną wycofane. Nie będą już otrzymywać aktualizacji w przyszłości. Ponadto, wiele starych integracji jest również wycofywanych po stronie PayPal i reprezentuje starsze doświadczenia związane z płatnościami.
Stare integracje powinny nadal działać w EDD 2.x, ale zalecamy przejście na nową bramkę przed wersją 3.0, ponieważ stare rozszerzenia PayPal nie będą aktualizowane, aby były zgodne z wersją 3.0.
Często zadawane pytania
Widzę SANDHILLS DEVELOPMENT, LLC podczas procesu połączenia, czy tak powinno być?
Tak, Easy Digital Downloads jest produktem SANDHILLS DEVELOPMENT, LLC. Zgadzasz się połączyć swoje konto PayPal ze swoim sklepem Easy Digital Downloads (produktem SANDHILLS DEVELOPMENT, LLC). Niestety, PayPal wymaga użycia nazwy firmy zamiast nazwy naszego produktu.
Czy mogę połączyć się z PayPal za pomocą konta osobistego?
Do połączenia EDD z PayPal wymagane jest konto biznesowe. Nie możesz połączyć EDD z osobistym kontem PayPal. Jeśli nie masz konta biznesowego, możesz utworzyć oddzielne konto biznesowe i mieć wiele kont PayPal, jeśli nie chcesz, aby Twoje konto osobiste stało się kontem biznesowym.
Dlaczego na mojej stronie płatności pojawia się komunikat „Nieoczekiwany błąd uwierzytelniania”?
Jest to prawdopodobnie spowodowane nieprawidłowym połączeniem PayPal z Twoim sklepem. Sprawdź status w sekcji Pobrane pliki » Ustawienia » Płatności » PayPal. Chcesz również potwierdzić, że Twoje aktywne konto PayPal nie jest połączone z EDD w Trybie Testowym, a Twoje konto PayPal Sandbox nie jest połączone z Twoim aktywnym połączeniem PayPal (połączenie z PayPal z wyłączonym Trybem Testowym).
Dlaczego PayPal nie może połączyć się z EDD?
Może to być spowodowane kilkoma problemami.
– Spróbuj połączyć się za pomocą innej przeglądarki lub urządzenia.
– Potwierdź, że kraj, z którym powiązane jest Twoje konto PayPal, znajduje się na liście obsługiwanych krajów, wymienionych w rozwijanym polu podczas procesu połączenia.
– Potwierdź, że Twoje konto PayPal jest w pełni aktywne. Możliwe, że PayPal ma zaległe działania, które musisz wykonać. Poszukaj powiadomień na swoim koncie PayPal i/lub skontaktuj się z pomocą techniczną PayPal, aby potwierdzić, że Twoje konto jest aktywne.
Czy mogę dodać lub usunąć przyciski Pay in 3 lub Pay in 4?
PayPal Commerce Pro jest wymagany, aby przycisk Pay in 3 lub Pay in 4 pojawił się na Twojej stronie. Jeśli przycisk się pojawi i chcesz go wyłączyć, możesz to zrobić w ustawieniach EDD PayPal.
Możesz również obsługiwać określoną liczbę płatności za pomocą naszego rozszerzenia Recurring Payments.
Dlaczego nie wyświetla się płatność gościnna przez PayPal?
Podczas płatności za pośrednictwem strony płatności na PayPal.com czasami istnieje możliwość płatności kartą kredytową bez logowania się do PayPal. Jest to znane jako tryb płatności „gościnnej” lub opcjonalne konto PayPal. Zobacz instrukcje PayPal tutaj, aby włączyć lub wyłączyć. Oto jak włączyć ustawienie opcjonalnego konta PayPal:
- Najedź kursorem na swoje imię w prawym górnym rogu.
- Kliknij Ustawienia konta w menu rozwijanym.
- Kliknij Płatności internetowe w sekcji „Produkty i usługi” po lewej stronie strony.
- Kliknij Zaktualizuj obok „Preferencje witryny”.
- Wybierz Włączone w sekcji „Opcjonalne konto PayPal”.
Czy potrzebuję SSL, jeśli używam PayPal?
Tak, potrzebujesz włączonego SSL na swojej stronie internetowej, nawet jeśli płatności są przetwarzane poza witryną przez PayPal.
Klienci nie są przekierowywani z powrotem na moją stronę po dokonaniu płatności.
Kiedy ludzie płacą przez PayPal, oczekują, że zostaną przekierowani z powrotem na Twoją stronę po dokonaniu płatności. Jeśli to nie działa poprawnie, opcja automatycznego powrotu prawdopodobnie musi być włączona w Twoim profilu PayPal.
Zaloguj się na swoje konto PayPal i przejdź do ustawień profilu.
W ustawieniach kliknij Preferencje witryny.
Tam będziesz mieć opcję włączenia automatycznego powrotu.
W powyższym przykładzie jest wyłączone. Aby je włączyć, wybierz przycisk radiowy Włącz, a następnie w polu poniżej upewnij się, że podałeś adres, na który chcesz przekierować swoich klientów.
