Niezbędne informacje
- Musisz mieć konto w PayU. Sprawdź jak zaoszczędzić prawie 200 zł na rejestracji →
- Ta bramka płatności działa tylko jeśli waluta jest ustawiona na Polski Złoty.
- Do działania wtyczki wymagana jest wersja PHP 5.6 lub wyższa.
- Od czerwca 2018 wtyczka wymaga protokołu TLS 1.2, który jest wspierany przez biblioteki cURL w wersji 7.34.0 lub wyższej. Wersję cURL sprawdzisz w statusie systemu, a zaktualizować ją możesz u swojego hostingodawcy
- Minimalna kwota transakcji dla płatności manualnych to 0,50 zł.
Instalacja
Konfiguracja konta PayU
Krok 1 – Stwórz sklep
Możesz pominąć ten krok, jeśli masz już dodany sklep.
W panelu PayU przejdź do menu Moje sklepy i kliknij przycisk Dodaj sklep.
- Wybierz lub wpisz adres sklepu.
- Wpisz nazwę sklepu.
- Opcjonalnie wpisz opis sklepu (opis nie jest używany przy działaniu wtyczki).
- Waluta powinna być ustawiona na PLN, żeby wtyczka działała.

Krok 2 – Stwórz punkt płatności
REST API
- Wybierz typ punktu płatności: REST API.
- Wpisz nazwę punktu płatności.
Classic API
Protokół Classic API nie jest już rozwijany i wszelkie nowe usługi są udostępniane poprzez REST API. Prosimy o jak najszybszą zmianę konfiguracji wtyczki na REST API, ponieważ Classic API zostanie usunięty w jednej z najbliższych aktualizacji.
- Wybierz typ punktu płatności: Classic API.
- Wpisz nazwę punktu płatności.
- Kodowanie danych ustaw na UTF-8.
- Zabezpieczenia sig-a są aktualnie wymuszane.
- Wpisz następujące adresy zamieniając „strona.pl” na domenę pod którą znajduje się Twój sklep internetowy lub po prostu skopiuj adresy z ustawień wtyczki:
- Adres powrotu – błąd: http://strona.pl/?wc-api=WC_Gateway_Payu&sessionId=%sessionId%&orderId=%orderId%&errorId=%error%
- Adres powrotu – poprawnie: http://strona.pl/?wc-api=WC_Gateway_Payu&sessionId=%sessionId%&orderId=%orderId%
- Adres raportów: http://strona.pl/?wc-api=WC_Gateway_Payu&sessionId=%sessionId%&orderId=%orderId%
Bardzo ważne jest to czy podasz adres www.strona.pl (z „www”) czy strona.pl (bez „www”). Upewnij się, że podajesz adres taki jak jest skonfigurowany w ustawieniach WordPressa w menu Ustawienia → Ogólne.

Krok 3 – Klucze konfiguracyjne
Skopiuj klucze konfiguracyjne i przejdź do konfiguracji wtyczki w ustawieniach zamówień TStore.

Konfiguracja wtyczki
Przejdź do menu TStore → Ustawienia → Płatności → PayU.
Włącz bramkę płatności i ustaw Tytuł oraz Opis bramki, który będzie widoczny w formularzu zamówienia.

REST API
Jeśli wybrałeś REST API uzupełnij dane z panelu PayU dostępne po założeniu punktu płatności:
- Wpisz Id punktu płatności (pos_id),
- Wpisz Drugi klucz (MD5),
- Wpisz Protokół OAuth – client_id,
- Wpisz Protokół OAuth – client_secret.
Tryb testowy – aby przetestować działanie wtyczki możesz skorzystać z serwisu testowego PayU (Sandbox). Więcej informacji na temat trybu testowego znajdziesz w dalszej części tej dokumentacji.

Classic API
Protokół Classic API nie jest już rozwijany i wszelkie nowe usługi są udostępniane poprzez REST API.
Jeśli wybrałeś Classic API uzupełnij dane z panelu PayU dostępne po założeniu punktu płatności:
- Wpisz Id punktu płatności (pos_id),
- Wpisz Klucz (MD5) i Drugi klucz (MD5),
- Wpisz Klucz autoryzacji płatności (pos_auth_key)
- Zaznacz opcję Zabezpieczaj moje transakcje/Sprawdzaj poprawność sig-a (to ustawienie jest aktualnie wymuszane przez PayU).
Tryb testowy – aby przetestować działanie wtyczki możesz skorzystać z serwisu testowego PayU (Sandbox). Więcej informacji na temat trybu testowego znajdziesz w dalszej części tej dokumentacji.

Raty PayU
Płatność za pomocą rat będzie możliwa tylko jeśli usługa jest dostępna na twoim koncie PayU. Skontaktuj się z BOK PayU w celu aktywacji usługi.
Zaznaczenie opcji PayU Raty Raty stworzy nową metodę płatności w formularzu zamówienia PayU Raty. Jeśli korzystasz z wtyczki Aktywne płatności pamiętaj aby skonfigurować obsługiwane metody wysyłki.

Tryb testowy
Konfiguracja trybu testowego
Aby przetestować działanie wtyczki możesz skorzystać z serwisu testowego PayU (Sandbox). Możesz skorzystać z publicznego konta testowego lub założyć własne. Aby uaktywnić na nim testowe płatności cykliczne, należy wysłać prośbę o ich aktywację do działu technicznego PayU [email protected], w treści maila podając Id punktu płatności (pos_id) z konta sandbox.
Konto Sandbox możesz założyć na stronie PayU. Na tej samej stronie następnie możesz się zalogować.

Serwis Sandbox PayU wygląda w taki sam sposób jak serwis produkcyjny PayU. Za pomocą tego samego panelu administratora musisz utworzyć sklep testowy by uzyskać dane dostępowe takie jak:
- ID punktu płatności
- Klucz MD5
- i inne.

Jeśli nie chcesz zakładać konta w Sandbox PayU, możesz skorzystać z danych publicznego punktu płatności:

Posiadanie własnego konta Sandbox daje Ci możliwość wglądu w transakcje i statystyki z poziomu panelu Sandbox.
Kolejnym krokiem w konfiguracji trybu testowego, jest ustawienie go na ekranie konfiguracyjnym wtyczki.

Zaznacz opcję Włącz tryb testowy (Sandbox) oraz wprowadź dane punktu płatności. Wtyczka obsługuje tryb testowy Sandbox zarówno dla REST API, jak i Classic API.
Gotowe!
Przeprowadzenie testowej transakcji
Dodaj dowolny produkt do koszyka. Przejdź do strony zamówienia. Wybierz PayU jako metodę płatności:

Po przejściu do realizacji zamówienia zostaniesz przekierowany do strony bramki płatności PayU.

Wybierz płatność kartą lub płatność przelewem on-line. W przypadku wyższej kwoty zamówienia pojawi się tutaj również opcja płatności ratalnej.
Po wyborze płatności kartą Twoim oczom ukaże się pole do wprowadzenia danych karty.

Wygląda ono dokładnie tak, jak w wersji produkcyjnej. W tym miejscu możesz skorzystać z predefiniowanych kart dla środowiska Sandbox:

W przypadku wyboru płatności bankowej, pojawi się okno z wyborem banku:

Po wyborze któregoś z banków zostaniesz przekierowany do symulatora płatności:

W tym miejscu możesz wybrać, czy płatność ma zostać autoryzowana, czy też odrzucona.
Po pozytywnej autoryzacji w swoim panelu administratora TStore znajdziesz opłacone zamówienie, które złożyłeś testowo.
Płatności cykliczne PayU
Płatności cykliczne PayU polegają na cyklicznym obciążaniu karty płatniczej. Klient musi podać dane karty tylko przy pierwszej transakcji, więc jest to idealne rozwiązanie dla wszelkich typów abonamentów i subskrypcji. Płatności cykliczne będą obsługiwane tylko jeśli usługa jest dostępna na twoim koncie PayU. Skontaktuj się z BOK PayU w celu aktywacji usługi. Pamiętaj, aby wypełnić wymogi dotyczące bezpieczeństwa określone przez PayU
TStore Subscriptions
Wtyczka PayU integruje się z wtyczką TStore Subscriptions, dzięki której możliwe jest stworzenie produktów subskrypcji i opłacania za pomocą PayU. Nie jest wymagana dodatkowa konfiguracja po stronie ustawień wtyczki PayU, która będzie domyślnie udostępniała metodę płatności PayU Subskrypcje.
Płatności automatyczne
Domyślnie podczas realizacji zamówienia na produkt subskrypcję, dostępna będzie metoda płatności PayU Subskrypcje.
Możesz edytować tytuł metody oraz opis metody w ustawieniach wtyczki w menu TStore → Ustawienia → Płatności → PayU → Płatności cykliczne.

W podsumowaniu zamówienia TStore po wybraniu metody płatności PayU Subskrypcje zostanie wyświetlony widget PayU do przesłania danych karty płatniczej klienta.Dane karty nie są zapisywane w sklepie. Widget jest obsługiwany przez PayU i służy jedynie do przesłania danych karty, aby w odpowiedzi otrzymać token. Do kolejnych płatności wykorzystywany będzie zapisany token klienta.
Po zakończeniu subskrypcji i jej odnowieniu płatność zostanie zrealizowana automatycznie za pomocą zapisanego tokena klienta.

Odnowienie subskrypcji dla płatności cyklicznych zadziała dla:
- subskrypcji bez darmowego okresu próbnego – płatność kartą bez zabezpieczenia 3DS
- subskrypcji bez darmowego okresu próbnego – płatność kartą z zabezpieczeniem 3DS
W przypadku, gdy karta ma autoryzację 3DS nie zadziała odnowienie dla subskrypcji z darmowym okres próbnym.
Płatności manualne
Wtyczka TStore Subscriptions umożliwia również manualne opłacanie zamówień przez klienta. W przypadku tej opcji klient może dokonać płatności w standardowy sposób za pomocą płatności online PayU. Po każdym odnowieniu subskrypcji klient będzie musiał ponownie opłacać zamówienie.
Aby udostępnić płatności online PayU przejdź do menu TStore → Ustawienia → Subscriptions → Renewals. Po zaznaczeniu opcji Accept Manual Renewals w podsumowaniu zamówienia dostępne będą dwie metody płatności: standardowe płatności PayU oraz płatności cykliczne PayU Subskrypcje.

Pozostałe funkcje integracji z TStore Subscriptions
Wtyczka PayU obsługuje większość opcji udostępnionych przez TStore Subscriptions oraz PayU Płatności cykliczne:
- przekierowanie na stronę banku dla kart wymagających autoryzacji 3DS (3-D Secure),
- subskrypcje testowe (trial) – obciążenie karty klienta po upływie okresu testowego,
- powtórne opłacenie nieudanej transakcji przez klienta,
- możliwość zmiany przez klienta metody płatności dla subskrypcji na PayU,
- notatki w zamówieniu TStore z numerem transakcji PayU i kwotą subskrypcji.

Automatyczne zwroty transakcji PayU
Wtyczka obsługuje automatyczne zwroty w zamówieniach TStore. Zwroty dostępne są tylko poprzez protokół REST API.
W edycji zamówienia kliknij przycisk Zwrot aby przejść do procedury zwrotu zamówienia lub jego części.

Zwróć wybrane produkty lub część kwoty zamówienia, a następnie kliknij przycisk Zwróć przez PayU.

W serwisie PayU zostanie utworzony zwrot transakcji, a w notatkach do zamówienia pojawi się informacja o utworzonym zwrocie i jego numerze ID.

Cloudflare
Instalacja CDN (Content Delivery Network) Cloudflare może zakłócać działanie w zakresie odbierania przez sklep raportów o statusach transakcji. W takiej sytuacji proponujemy dwie zmiany w panelu Cloudflare:
- Wyłącz weryfikację user-agent. Zobacz jak to zrobić →
- Dodaj IP PayU do listy zaufanych adresów (185.68.12.10; 185.68.12.11; 185.68.12.12; 185.68.12.26; 185.68.12.27; 185.68.12.28). Zobacz jak to zrobić →