Integracja z Planet Pay

W celu poprawnego skonfigurowania bramki płatności Planet Pay niezbędne jest podanie kluczy konfiguracyjnych dostarczanych przez support Planet Pay po podpisaniu umowy.

Niezbędne klucze to:

Identyfikator merchanta (mid)
Secret - Tajny klucz
Klucz do podpisywania notyfikacji

Konfiguracja adresów URL (formularz „Lista sklepów Akceptanta")

Przy uruchamianiu bramki Planet Pay klient otrzymuje do wypełnienia formularz „Lista sklepów Akceptanta" (Załącznik nr 2 do Umowy akceptacji płatności online). Poza danymi sklepu i metodami płatności zawiera cztery pola adresów URL, przez które Planet Pay komunikuje się z instancją VnetLPR.

Zasada: domena to zawsze adres instancji klienta (https://nazwa-klienta.vnetcloud.pl) i różni się między wdrożeniami; ścieżki są stałe dla każdej instancji. Budowa adresu i wersja demo: zob. Konwencja adresów (deep-linki).

Pole na formularzu	Wartość	Metoda
Adres albo Adres Url Sklepu Przyjmującego Płatności	`https://nazwa-klienta.vnetcloud.pl`	—
Adres Url do Notyfikacji	`https://nazwa-klienta.vnetcloud.pl/integrations/planet/notifications/payment`	POST
Adres Url do Powrotu	`https://nazwa-klienta.vnetcloud.pl/integrations/planet/success`	GET
Adres Url do Powrotu - Błąd	`https://nazwa-klienta.vnetcloud.pl/integrations/planet/error`	GET

Znaczenie pól:

Adres Url Sklepu Przyjmującego Płatności — bazowy adres instancji, bez ścieżki (odpowiednik „adresu strony").
Adres Url do Notyfikacji — kanał serwer → serwer; Planet Pay przekazuje tu status transakcji. To jedyne wiarygodne źródło informacji o płatności — na jego podstawie aplikacja finalizuje transakcję, niezależnie od tego, czy klient wróci przeglądarką.
Adres Url do Powrotu — przekierowanie przeglądarki klienta po udanej płatności (warstwa UX, nie potwierdzenie zapłaty).
Adres Url do Powrotu - Błąd — przekierowanie przeglądarki przy płatności nieudanej lub anulowanej.

Uwagi techniczne

Notyfikacja obsługiwana jest metodą POST, oba powroty (sukces i błąd) metodą GET.
Aplikacja oczekuje parametru paymentId w adresie powrotu, np. …/integrations/planet/success?paymentId=… — służy do identyfikacji transakcji po powrocie klienta.

Błąd 405 na adresie notyfikacji to zachowanie poprawne

Wejście na Adres Url do Notyfikacji z poziomu przeglądarki zwraca błąd 405 (Method Not Allowed) — i tak ma być. Endpoint notyfikacji, zgodnie z dokumentacją API Planet Pay, obsługuje wyłącznie metodę POST; przeglądarka wysyła GET, stąd 405. Nie jest to usterka ani błąd konfiguracji — poprawność tego adresu weryfikuje realny ruch POST z Planet Pay, a nie otwarcie w przeglądarce.

Możliwe jest uruchomienie integracji w trybie testowym. Wymaga to podania odpowiednich kluczy z konta sandbox Planet Pay.