Jak podłączyć PayPal do sklepu internetowego?

Podłączenie PayPal do sklepu internetowego polega na utworzeniu aplikacji REST API, pobraniu danych Client ID i Secret oraz wpisaniu ich w ustawieniach płatności sklepu. Do uruchomienia sprzedaży potrzebujesz firmowego konta PayPal i konfiguracji w trybie Live.

Czego potrzebujesz przed startem?

Przed rozpoczęciem integracji przygotuj:

• Aktywne konto firmowe PayPal Business.
• Dostęp do panelu administratora sklepu internetowego.
• Sklep gotowy do sprzedaży, z aktywnymi produktami, dostawą i podstawowymi ustawieniami zamówień.

Współczesne integracje sklepu z PayPal korzystają z REST API. Nie wybieraj danych NVP/SOAP, chyba że konkretna, starsza wtyczka lub system wyraźnie wymaga tego interfejsu.

Jak wygenerować dane API w PayPal?

Client ID i Secret utworzysz w panelu PayPal Developer. Najpierw możesz pracować w środowisku Sandbox, a po zakończeniu testów przełączyć integrację na Live.

1. Zaloguj się na stronie developer.paypal.com przy użyciu konta powiązanego z firmowym PayPal.
2. Otwórz sekcję My Apps & Credentials.
3. Wybierz środowisko Live, jeśli przygotowujesz dane do rzeczywistych płatności. Sandbox służy wyłącznie do testów.
4. W sekcji REST API apps kliknij Create App.
5. Wpisz nazwę aplikacji, na przykład nazwę sklepu, i zatwierdź utworzenie przyciskiem Create App.
6. Skopiuj wyświetlone wartości Client ID oraz Secret. Secret może być ukryty, dlatego użyj opcji pokazania klucza, jeśli jest dostępna.

Najczęstszy błąd polega na pobraniu danych z Sandbox i wklejeniu ich do produkcyjnej konfiguracji sklepu. Dane testowe nie autoryzują rzeczywistych transakcji.

Jak wprowadzić dane PayPal do sklepu?

Nazwy zakładek mogą się różnić zależnie od platformy sklepowej, ale ustawień szukaj w sekcji metod, bramek lub płatności online.

1. Zaloguj się do panelu administracyjnego sklepu.
2. Przejdź do ustawień płatności i otwórz listę metod lub bramek płatniczych.
3. Wybierz PayPal, a następnie kliknij opcję konfiguracji albo dodania metody.
4. Wklej Client ID i Secret w odpowiednie pola formularza.
5. Wybierz tryb produkcyjny Live, jeśli korzystasz z danych wygenerowanych dla rzeczywistych płatności.
6. Włącz metodę, zapisz konfigurację bramki, a następnie zapisz ustawienia całego sklepu.

Niektóre platformy pozwalają w tym samym miejscu włączyć dodatkowe przyciski płatności. Ich dostępność zależy od konfiguracji konta, kraju, urządzenia klienta i decyzji PayPal:

• Płatność z salda konta PayPal może być dostępna dla klientów zalogowanych do portfela.
• Karty Visa, Mastercard lub American Express mogą pojawić się jako osobna opcja płatności.
• BLIK i lokalne metody płatności nie muszą być dostępne w każdym sklepie ani dla każdej transakcji.
• Dodatkowe metody mogą prowadzić klienta przez więcej niż jeden etap autoryzacji.

Na co uważać przed uruchomieniem?

Nie publikuj klucza Secret. Traktuj go jak dane uwierzytelniające do systemu płatności. Nie umieszczaj go w kodzie widocznym dla użytkownika, repozytorium publicznym ani wiadomości wysyłanej osobom postronnym.

Przed udostępnieniem PayPal klientom wykonaj testową transakcję. Sprawdź, czy płatność przechodzi, zamówienie otrzymuje prawidłowy status, a sklep nie oznacza go jako opłaconego przed potwierdzeniem z PayPal.

Jeśli test nie działa, sprawdź przede wszystkim:

• Czy aplikacja w PayPal Developer została utworzona w tym samym środowisku co konfiguracja sklepu.
• Czy Client ID i Secret zostały skopiowane bez dodatkowych spacji.
• Czy konto PayPal Business jest aktywne i ma uzupełnione wymagane dane.
• Czy platforma sklepu nie wymaga osobnego włączenia powiadomień lub obsługi statusów płatności.

Co sprawdzić po integracji?

Po zapisaniu konfiguracji przypisz PayPal do dostępnych metod dostawy. Sama aktywacja bramki nie zawsze wystarcza, aby metoda pojawiła się w koszyku. Wybierz konkretną dostawę, przejdź do podsumowania zamówienia i sprawdź widoczność PayPal zarówno na komputerze, jak i na urządzeniu mobilnym.

Jeżeli pojawiają się błędy autoryzacji API albo sklep nie odbiera potwierdzeń płatności, porównaj tryb Sandbox lub Live, dane aplikacji i ustawienia platformy. Przy utrzymujących się problemach potrzebna może być pomoc administratora sklepu lub dostawcy integracji.