WP Desk Care - zadbaj o swój biznes online!

Sprawdzona opieka techniczna dla Twojego sklepu

Przelewy24 – WooCommerce

Instalacja

Instrukcja instalacji →

Aktywacja Subskrypcji

Aktywacja subskrypcji →

Aktualizacja

Instrukcja aktualizacji →

Ważne informacje

  • Aby używać tej bramki musisz mieć konto firmowe w Przelewy24. Jeśli jeszcze nie masz konta, sprawdź jak obniżyć prowizje Przelewy24 →
  • Wspierane waluty: PLN, EUR, GBP, UAH, USD, RON, CZK. Obsługa walut musi być włączona na koncie Przelewy24.

Konfiguracja bramki płatności

Przejdź do menu: WooCommerce → Ustawienia → Płatności → Przelewy24.

Ogólne ustawienia

Przelewy24 WooCommerce - Ustawienia Główne
Przelewy24 WooCommerce – Ustawienia Zamówienia

Włącz/Wyłącz – włącz lub wyłącz bramkę płatności w WooCommerce. Umożliwia to wyłączenie bramki płatności bez potrzeby wyłączania wtyczki.

Tytuł – nazwa metody płatności widoczna dla klienta przy składaniu zamówienia.

Opis – opis metody płatności widoczna dla klienta przy składaniu zamówienia.

Wybór API

Wybierz API – wtyczka obsługuje dwa rodzaje API:

  • WebService – starszy protokół, umożliwia dokonywanie płatności i zmianę statusu zamówienia na Nieudane.
  • Rest API – nowoczesny protokół, wybierz go jeśli planujesz w przyszłości obsługiwać płatności cykliczne. Nieopłacone zamówienia pozostają przy statusie Oczekujące na płatność.
Jeśli posiadasz starsze konto Przelewy24, na twoim koncie nie jest aktywowany kanał Rest API. Zgłoś się do pomocy technicznej Przelewy24, aby uzyskać dostęp do Rest API. Na nowych kontach Rest API jest aktywowane automatycznie.

Dane konta Przelewy24

Przelewy24 WooCommerce - Uzupełnij dane konta
Przelewy24 WooCommerce – Dane Konta

ID sprzedawcy – wpisz swój numer klienta w Przelewy24 uzyskany podczas rejestracji konta.

POS ID (opcjonalnie) – opcjonalnie wpisz identyfikator POS – nie jest on wymagany do działania płatności.

Klucz CRC – wpisz klucz CRC, który znajdziesz w panelu Przelewy24.

Secret ID – wprowadź klucz do raportów skopiowany z panelu Przelewy24. Używaj tylko w przypadku korzystania z Rest API. Pamiętaj o uzupełnieniu pola Adres IP 1 w panelu (poniżej).

Panel Przelewy24

Uzupełnij dane z panelu Przelewy24 dostępne w zakładce “Moje dane”.

Przelewy24 WooCommerce - Dane konta
Przelewy24 WooCommerce – ID Sprzedawcy

Znajdziesz tam ID sprzedawcy, klucz CRC i klucz do raportów (we wtyczce nazywany Secret ID).

Aby obsługiwać płatności Rest API, pamiętaj o uzupełnieniu klucza do raportów (we wtyczce nazywanego Secret ID) i wprowadzeniu znaku % w polu Adres IP 1:

Tryb testowy Sandbox Przelewy24

Przelewy24 WooCommerce - Sandbox
Przelewy24 WooCommerce – Tryb Testowy Sandbox

Wtyczka umożliwia przetestowanie płatności. Dzięki temu można przejść cały proces zakupu i płatności, ale bez pobierania pieniędzy z konta.

Scenariusze możliwe do sprawdzenia w trybie testowym:

  • Włączony (zaakceptuj płatność)
  • Tryb testowy: błędna autoryzacja
  • Tryb testowy: niezgodność kwoty transakcji
  • Tryb testowy: przekroczony limit czasu
  • Tryb testowy: nieprawidłowa kwota przelewu

Aby przetestować bramkę płatności Przelewy24:

  1. Włącz tryb testowy w ustawieniach wtyczki, możesz wybrać czy płatność będzie poprawna, czy błędna.
  2. Jeśli włączasz tryb testowy, musisz podać inne dane do konfiguracji płatności w ustawieniach wtyczki (ID sprzedawcy i klucz CRC), zarejestruj konto sandbox Przelewy24 i podaj te dane.
  3. Po zakończeniu testów, wyłącz tryb testowy i zmień dane (ID sprzedawcy i klucz CRC) w ustawieniach wtyczki na konto produkcyjne Przelewy24.

Przelewy24 Blik

Do funkcjonowania płatności z Blikiem niezbędne jest funkcjonowanie wtyczki w trybie REST API. Płatność BLIK wymaga aby kupujący wprowadził kod w checkoucie. Jedyne co następnie należy zrobić to zatwierdzić płatność na urządzeniu  mobilnym.

Jeśli po aktywowaniu usługi BLIK na koncie Przelewy24, płatności nie przechodzą, zgłoś się do supportu Przelewy24 w celu upewnienia się, że kanał płatności 181 jest odblokowany.

Przelewy24 Blik  – zaznacz tę opcję jeśli chcesz, aby klienci Twojego sklepu mogli płacić za produkty z wykorzystaniem mechanizmu płatności Blik.

Tytuł – określ nazwę metody płatności, która będzie prezentowana kupującym w checkoucie tuż przed złożeniem zamówienia.

Opis – opis bramki płatności, którą którą klient widzi przy składaniu zamówienia.

Płatności cykliczne Przelewy24

Nowość od wersji 3.1.0 Wtyczka umożliwia realizację płatności cyklicznych (rekurencyjnych). W takim scenariuszu kupujący podaje dane swojej karty płatniczej tylko raz, a system automatycznie obciąża jego kartę w wybranych okresach.

Dane karty płatniczej nie są przechowywane w sklepie WooCommerce. W sklepie WooCommerce przechowywany jest jedynie token, na podstawie którego nie da się odtworzyć danych karty płatniczej. Za bezpieczeństwo transakcji odpowiada system Przelewy24

Płatności cykliczne w ramach płatności za subskrypcje działają w integracji z wtyczką WooCommerce Subscriptions. Ta wtyczka jest wymagana do uruchomienia płatności cyklicznych. Metoda płatności Płatność cykliczna Przelewy24 będzie dostępna tylko dla produktów-subskrypcji utworzonych przy użyciu WooCommerce Subscriptions.

Płatności rekurencyjne

Ważne! Skontaktuj się z supportem Przelewy24 w celu aktywacji płatności cyklicznych na Twoim koncie.

W zgłoszeniu prześlij poniższą listę metod jakie powinny być aktywowane na koncie produkcyjnym oraz testowym:

/api/v1/paymentMethod/blik/chargeByAlias
/api/v1/paymentMethod/blik/chargeByCode
/api/v1/paymentMethod/blik/getAliasesByEmail/{email}
/api/v1/card/info/{orderId}
/api/v1/card/charge
/api/v1/transaction/refund
/api/v1/transaction/register
/api/v1/transaction/reject
/api/v1/transaction/verify

Przejdź do ustawień wtyczki i aktywuj płatności cykliczne:

Do aktywacji płatności cyklicznych wymagane jest korzystanie z REST API.

Na tym ekranie masz również możliwość edycji tytułu i opisu metody płatności, którą zobaczą kupujący w sklepie.

Po wyborze metody płatności Płatności cykliczne Przelewy24, kupujący zostanie przekierowany do strony Przelewy24 w celu realizacji pierwszej transakcji.

Regulamin Przelewy24 nakazuje kupującym akceptację regulaminu, dlatego pierwszym krokiem jest kliknięcie przycisku Zapłać:

Następnie kupujący podaje dane karty płatniczej:


Po zatwierdzeniu, klient powinien dodatkowo zatwierdzić transakcję, jeśli karta ma włączoną weryfikację 3-D Secure. Karta zostaje zapisana w systemie Przelewy24 i jest dostępna do kolejnych transakcji w ramach realizacji odnowień zgodnie z ustawieniami subskrypcji.

Moje konto

Kupujący ma możliwość podglądu kilku ostatnich cyfr karty z poziomu strony Moje konto w celu identyfikacji użytej karty płatniczej:

W sekcji Moje konto jest też możliwość zarządzania subskrypcją:

  • anulowania i wznowienia subskrypcji
  • ręcznej płatności za kolejny okres
  • zmiany metody płatności
  • zmiany danych karty płatniczej w systemie Przelewy24

Zmiana karty płatniczej i darmowy okres próbny

Ze względu na ograniczenia techniczne po stronie Przelewy24, wtyczka w niestandardowy sposób obsługuje sytuacje takie jak:

  • dodanie karty płatniczej w ramach pierwszej transakcji darmowego okresu próbnego subskrypcji
  • dodanie nowej karty płatniczej w ramach aktualizacji metody płatności

W powyższych przypadkach, karta płatnicza kupującego zostanie obciążona kwotą 1 zł, a po chwili zostanie wydana dyspozycja zwrotu kwoty 1 zł. Dzięki temu karta zostanie prawidłowo zapisana w systemie i będzie można z niej korzystać przy kolejnych płatnościach.

Aktywacja usługi płatności cyklicznych w systemie Przelewy24

Uruchomienie usługi płatności cyklicznych w systemie Przelewy24 to oddzielny proces, który wymaga podpisania odpowiedniej umowy z operatorem płatności. Aby przejść ten proces, skontaktuj z opiekunem klienta Przelewy24 i poproś go o aktywację usługi.

Do aktywacji usługi płatności cyklicznych na produkcji potrzebne są:

  1. Podpisanie umowy na usługę
  2. Pierwsza płatność abonamentowa (abonament miesięczny)

Automatyczne zwroty transakcji Przelewy24

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.

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

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

Dostęp do usług

Jeśli posiadasz konto w Przelewy24 od dawna, na twoim koncie mogą nie być aktywne usługi umożliwiające realizację płatności rekurencyjnych. W takim przypadku podczas realizacji płatności otrzymasz błąd 401. Skontaktuj się z opiekunem klienta Przelewy24 i poproś go o aktywację poniższych usług na twoim koncie:

1. /api/v1/transaction/reject
2. /api/v1/card/charge
3. /api/v1/card/info/{orderId}

Najczęstsze pytania i problemy

Czy do przyjmowania płatności jest potrzebna pełna aktywacja konta?

Tak, do przyjmowania płatności jest wymagana aktywacja konta. Po założeniu konta w Przelewy24 nie jest ono automatycznie aktywowane. Aktywacja konta wymaga podpisania umowy z Przelewy24 oraz przejście procesu weryfikacji.

Jeśli konto nie jest jeszcze w pełni aktywne przy próbie płatności może pojawić się następujący komunikat:

Nieaktywne konto partnera Przelewy24
Nieaktywne konto partnera

W takim przypadku należy najpierw zakończyć formalności z Przelewy24, a dopiero po otrzymaniu informacji o pełnej aktywacji konta, uruchomić płatności Przelewy24 w sklepie.

Integracja z WooCommerce One Page Checkout

Jeśli używasz wtyczki WooCommerce One Page Checkout do prawidłowego działa Przelewy24 wymagane jest dodanie kodu skrótowego (shortcode). Wystarczy, że na stronie obsługującej One Page Checkout wkleisz kodu skrótowy (shortcode) [przelewy24_payment].

Preferencje plików cookies

Inne

Inne niekategoryzowane pliki cookie to te, które są analizowane i nie zostały jeszcze przypisane do żadnej z kategorii.

Niezbędne

Niezbędne
Niezbędne pliki cookie są absolutnie niezbędne do prawidłowego funkcjonowania strony. Te pliki cookie zapewniają działanie podstawowych funkcji i zabezpieczeń witryny. Anonimowo.

Reklamowe

Reklamowe pliki cookie są stosowane, by wyświetlać użytkownikom odpowiednie reklamy i kampanie marketingowe. Te pliki śledzą użytkowników na stronach i zbierają informacje w celu dostarczania dostosowanych reklam.

Analityczne

Analityczne pliki cookie są stosowane, by zrozumieć, w jaki sposób odwiedzający wchodzą w interakcję ze stroną internetową. Te pliki pomagają zbierać informacje o wskaźnikach dot. liczby odwiedzających, współczynniku odrzuceń, źródle ruchu itp.

Funkcjonalne

Funkcjonalne pliki cookie wspierają niektóre funkcje tj. udostępnianie zawartości strony w mediach społecznościowych, zbieranie informacji zwrotnych i inne funkcjonalności podmiotów trzecich.

Wydajnościowe

Wydajnościowe pliki cookie pomagają zrozumieć i analizować kluczowe wskaźniki wydajności strony, co pomaga zapewnić lepsze wrażenia dla użytkowników.