0
Popularne pytania: Jak aktywować licencje wtyczek WP Desk,

PayU – WooCommerce

Szczegóły

  • Działa z

    WooCommerce 3.1.0 - 3.5.x

  • Ostatnia aktualizacja

    15.11.2018

  • Historia wersji

    Zobacz changelog

Ważne 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

Instalacja

Instrukcja instalacji →

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.

konfiguracja-payu-krok-1

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.

konfiguracja-payu-krok-2

Krok 3 – Klucze konfiguracyjne

Skopiuj klucze konfiguracyjne i przejdź do konfiguracji wtyczki w ustawieniach zamówień WooCommerce.

PayU WooCommerce - dodawanie sklepu, klucze konfiguracji
PayU WooCommerce – dodawanie sklepu, klucze konfiguracji

Konfiguracja wtyczki

Przejdź do menu WooCommerce → 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.

Integracja WooCommerce PayU – konfiguracja opisu bramki

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.

Integracja WooCommerce PayU - konfiguracja dostępów, REST API
Integracja WooCommerce PayU – konfiguracja dostępów, REST API

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.

Integracja WooCommerce PayU – konfiguracja dostępów

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.

WooCommerce PayU Raty – konfiguracja

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.

Konto Sandbox możesz założyć na stronie PayU. Na tej samej stronie następnie możesz się zalogować.

Rejestracja w PayU Sandbox

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.
Panel Sandbox PayU
Strona Sandbox PayU to klon strony produkcyjnej

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

Dane publicznego punktu płatności - PayU Sandbox

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.

Włącz tryb testowy - PayU

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:

PayU w koszyku - tryb testowy

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

Płatność testowa 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.

Płatność testowa kartą - PayU

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

Karty dla Sandbox PayU

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

Płatność bankowa w PayU Sandbox

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

Symulator płatności PayU Sandbox

W tym miejscu możesz wybrać, czy płatność ma zostać autoryzowana, czy też odrzucona.

Po pozytywnej autoryzacji w swoim panelu administratora WooCommerce 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

WooCommerce Subscriptions

Wtyczka PayU integruje się z wtyczką WooCommerce 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 WooCommerce → Ustawienia → Zamówienia → PayU → Płatności cykliczne.

PayU WooCommerce - Ustawienia płatności cyklicznych
PayU WooCommerce – Ustawienia płatności cyklicznych

W podsumowaniu zamówienia WooCommerce 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.

PayU WooCommerce - Widget płatności cyklicznej
PayU WooCommerce – Widget płatności cyklicznej

Płatności manualne

Wtyczka WooCommerce 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 WooCommerce → 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.

PayU WooCommerce - Płatności manualne WCS
PayU WooCommerce – Płatności manualne WCS

Pozostałe funkcje integracji z WooCommerce Subscriptions

Wtyczka PayU obsługuje większość opcji udostępnionych przez WooCommerce 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 WooCommerce z numerem transakcji PayU i kwotą subskrypcji.
PayU WooCommerce - notatka zamówienia dla płatności cyklicznej
PayU WooCommerce – notatka zamówienia dla płatności cyklicznej

Automatyczne zwroty transakcji PayU

Wtyczka obsługuje automatyczne zwroty w zamówieniach WooCommerce.

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.

Integracja WooCommerce PayU – automatyczne zwroty
Integracja WooCommerce PayU – automatyczne zwroty

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

Integracja WooCommerce PayU – automatyczne zwroty, realizacja
Integracja WooCommerce PayU – automatyczne zwroty, realizacja

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

Integracja WooCommerce PayU – automatyczne zwroty, notatka
Integracja WooCommerce PayU – automatyczne zwroty, notatka

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: