Jak połączyć PayU z heyhey

PayU połączysz z heyhey przez punkt płatności REST API. To konfiguracja Twojego sklepu w PayU, z której kopiujesz cztery wartości do panelu heyhey. Nie potrzebujesz terminala, dodatkowej wtyczki ani programisty.

Poniżej przejdziesz od przygotowania konta do sprawdzenia, czy kupujący rzeczywiście otrzymał produkt. Sam napis „Połączono” potwierdza konfigurację konta, ale nie zastępuje testu zakupu.

1. Przygotuj konto i stronę sprzedaży

Przygotuj konto sprzedawcy PayU oraz dostęp do jego ustawień. Uzupełnij dane i dokumenty wymagane przez operatora. Aktywacja konta i poszczególnych usług odbywa się w PayU, heyhey nie może wykonać jej za Ciebie.

Przygotuj też opublikowaną stronę produktu. Jej adres przyda się podczas konfiguracji sklepu u operatora. Możesz użyć strony w domenie heyhey lub podłączonej własnej domeny. Dane sprzedawcy i informacje o ofercie powinny odpowiadać temu, co zgłaszasz do PayU.

Otwórz w drugiej karcie Sprzedaż → Płatności w heyhey, czyli ustawienia operatorów płatności. Odszukaj kartę PayU.

2. Odszukaj sklep i punkt REST API w PayU

1. Zaloguj się do Panelu Menedżerskiego PayU.
2. Otwórz Płatności online → Moje sklepy. W angielskiej wersji są to Online Payments → My Shops.
3. Wybierz sklep przypisany do swojej strony. Jeśli konfigurujesz nową stronę, dodaj odpowiedni sklep i uzupełnij jego adres oraz walutę.
4. Otwórz Punkty płatności / POS wybranego sklepu.
5. Wybierz punkt REST API (Checkout). Jeśli musisz utworzyć nowy punkt, wybierz ten typ integracji, nie Classic API.
6. Odszukaj dane konfiguracyjne tego punktu.

POS oznacza tutaj punkt płatności online. Nie chodzi o fizyczny terminal. Ścieżkę i rozróżnienie typów punktów opisuje oficjalny przewodnik po panelu PayU.

3. Skopiuj cztery wartości do heyhey

Wszystkie dane muszą pochodzić z tego samego punktu płatności i tego samego środowiska. Nie łącz identyfikatora sklepu testowego z sekretem sklepu produkcyjnego.

Nazwy parametrów są również opisane w dokumentacji API PayU. Nie musisz wykonywać żadnych zapytań do API, heyhey obsługuje je za Ciebie.

1. Uzupełnij kolejno cztery pola na karcie PayU.
2. Sprawdź, czy podczas kopiowania nie dodały się spacje ani nowa linia.
3. Ustaw właściwy tryb, testowy albo produkcyjny.
4. Kliknij Połącz PayU.
5. Zaczekaj na wynik i sprawdź status karty.

Jeśli widzisz błąd danych, wróć do konfiguracji POS i porównaj każde pole osobno. Zmiana tylko jednego klucza na klucz z innego punktu nie naprawi połączenia.

4. Sprawdź odbieranie płatności i ich potwierdzenia

heyhey przekazuje PayU adres powiadomień przy tworzeniu transakcji. Powiadomienie to automatyczna wiadomość między systemami, dzięki której zamówienie może zostać oznaczone jako opłacone. W tym formularzu nie musisz samodzielnie tworzyć adresu webhooka ani wklejać adresu swojej strony głównej.

W ustawieniach POS sprawdź także automatyczny odbiór płatności dla używanych metod. Jeśli odbierasz je ręcznie, samo rozpoczęcie płatności nie oznacza jeszcze zakończonej sprzedaży. Nie udostępniaj płatnego produktu na podstawie samego powrotu klienta z PayU, sprawdź końcowy status zamówienia.

Drugi klucz MD5 służy w tej integracji do sprawdzania powiadomień. Dlatego błędna wartość może powodować problem z aktualizacją zamówienia nawet wtedy, gdy klient dotarł do ekranu płatności.

5. Wybierz metody dostępne dla kupujących

Dla tej integracji przygotuj sprzedaż w PLN. Dostępność metod zależy od Twojego konta PayU i aktywacji usług przez operatora. Nie każda metoda z oferty PayU musi być automatycznie widoczna w Twoim koszyku.

Jeżeli masz aktywowane karty w PayU, zaznacz odpowiadającą im opcję w heyhey. Ten przełącznik nie aktywuje usługi po stronie operatora. Kiedy masz również Stripe, sprawdź w koszyku, przez którego operatora obsługiwane są karty, zamiast zakładać, że zmiana jednej opcji przełącza całą sprzedaż.

Przy kilku polskich operatorach możesz wskazać domyślnego na karcie operatora. Wybór dotyczy obsługi przelewów; dostępność BLIK-a jest rozpatrywana osobno. BLIK nie wymaga osobnego konta sprzedawcy poza obsługującym go operatorem.

Jeśli sprzedajesz subskrypcję, potwierdź z PayU dostępność wymaganej obsługi płatności cyklicznych kartą. Jednorazowy udany zakup nie wystarcza do sprawdzenia kolejnych obciążeń abonamentu.

6. Przetestuj zakup od początku do końca

Środowisko Sandbox służy do prób bez rzeczywistej sprzedaży. Potrzebujesz danych z testowego konta i testowego POS PayU. Włączenie przełącznika w heyhey nie zamienia kluczy produkcyjnych w testowe.

1. Połącz dane testowe z włączonym Sandbox.
2. Otwórz stronę opublikowanego produktu z ceną w PLN.
3. Przejdź do koszyka i wybierz metodę obsługiwaną przez PayU.
4. Dokończ scenariusz płatności w środowisku testowym operatora.
5. Sprawdź transakcję w PayU i status w Sprzedaż → Zamówienia w heyhey.
6. Sprawdź e-mail po zakupie oraz możliwość otwarcia kupionego materiału lub kursu.
7. Jeśli sprzedajesz abonament, osobno sprawdź utworzenie subskrypcji i jej dalszą obsługę.

Przed sprzedażą prawdziwym klientom podłącz komplet danych produkcyjnych i wyłącz Sandbox. Następnie sprawdź rzeczywisty zakup niewielkiej kwoty. To prawdziwa transakcja, podlegająca zasadom i opłatom operatora. Testów nie wykonuj na koszyku, z którego w tym samym czasie korzystają klienci.

Najczęstsze problemy

Co po połączeniu

W PayU zarządzasz rozliczeniami i wypłatami, a w heyhey produktami, zamówieniami i dostępem klientów. Nie usuwaj działających kluczy bez przygotowania nowych, szczególnie gdy obsługujesz subskrypcje.

Jeśli potrzebujesz pomocy, napisz do heyhey. Podaj numer zamówienia, identyfikator transakcji PayU, przybliżony czas i informację, czy był to test. Nie wysyłaj client_secret ani drugiego klucza MD5.