Jak połączyć Przelewy24 z heyhey

Przelewy24 połączysz z heyhey, wpisując Merchant ID, POS ID, klucz CRC i klucz API. Dane znajdziesz na swoim koncie sprzedawcy Przelewy24. Połączenie pozwala przyjmować płatności za produkty sprzedawane w heyhey i przypisywać wpłaty do właściwych zamówień.

W tej instrukcji konfigurujesz bezpośrednie połączenie z Przelewy24. To inna konfiguracja niż włączenie metody Przelewy24 w Stripe. Jeżeli chcesz rozliczać tę metodę przez Stripe, przejdź do instrukcji połączenia Stripe.

1. Przygotuj konto Przelewy24

Przygotuj konto sprzedawcy i dostęp do panelu Przelewy24. Uzupełnij wymagane dane działalności, rachunku oraz strony sprzedaży i wykonaj kroki weryfikacji wskazane przez operatora. Sam login nie gwarantuje jeszcze możliwości przyjmowania wszystkich rodzajów płatności.

Przygotuj opublikowany produkt z ceną w PLN i sprawdź jego stronę. Jeżeli dopiero tworzysz ofertę, najpierw uzupełnij tytuł, cenę oraz sposób otrzymania produktu. Łatwiej zweryfikujesz połączenie, mając gotowy przykład zakupu.

W drugiej karcie otwórz Sprzedaż → Płatności w heyhey, czyli ustawienia operatorów. Znajdź kartę Przelewy24.

2. Znajdź identyfikatory i klucze

1. W panelu Przelewy24 otwórz Moje dane → Ustawienia.
2. Odszukaj sekcję Dane API i konfiguracja.
3. Przygotuj klucz CRC oraz klucz API.
4. Sprawdź identyfikator sprzedawcy, czyli Merchant ID. Przelewy24 wskazuje go jako identyfikator używany do logowania, znajdziesz go również w danych otrzymanych po rejestracji.
5. Jeśli konto ma osobny identyfikator punktu płatności, przygotuj także POS ID.

Ścieżkę w panelu i lokalizację tych danych opisuje oficjalna pomoc Przelewy24. Klucze nie są hasłem do panelu, nie wpisuj hasła zamiast CRC lub API.

3. Uzupełnij formularz w heyhey

Wklej wartości dokładnie, bez cudzysłowów i dodatkowych spacji. Jeżeli POS ID różni się od Merchant ID, nie pomijaj go. Gdy nie wiesz, który punkt przypisano do Twojej integracji, sprawdź to w panelu operatora przed zapisaniem.

Kliknij Połącz Przelewy24 i sprawdź wynik. Po prawidłowym połączeniu karta pokazuje status Połączono. Jeśli pojawi się błąd dostępu do API, przejdź do kroku o adresie IP, zamiast wielokrotnie zmieniać poprawne klucze.

4. Sprawdź dozwolony adres IP

W konfiguracji API Przelewy24 może być wymagane dopuszczenie adresu IP serwera wykonującego połączenia. Dla heyhey jest to adres serwera heyhey, nie komputera kupującego ani Twojego domowego internetu.

1. Odszukaj adres IP wskazany na karcie Przelewy24 w heyhey, jeśli jest wyświetlany.
2. Dodaj go do dozwolonych adresów w konfiguracji API Przelewy24 i zapisz zmianę.
3. Ponów połączenie lub test płatności.

Jeśli adres nie jest widoczny albo blokada uniemożliwia już pierwsze połączenie, poproś pomoc heyhey o aktualny adres do konfiguracji Przelewy24. Nie zgaduj go na podstawie domeny strony i nie kopiuj IP z przypadkowego poradnika. Ten poradnik celowo nie zawiera stałego numeru, ponieważ infrastruktura może się zmieniać.

5. Jak zamówienie otrzymuje status opłaconego

heyhey przekazuje adres potwierdzeń do Przelewy24 podczas tworzenia transakcji. Przelewy24 informuje pod tym adresem o wyniku płatności, a heyhey sprawdza dane transakcji i aktualizuje zamówienie.

Nie musisz samodzielnie wpisywać adresu webhooka w formularzu połączenia heyhey. Nie zastępuj go adresem strony produktu ani strony z podziękowaniem.

To rozróżnienie pomaga przy diagnozie: przekierowanie kupującego na stronę po zakupie nie jest dowodem otrzymania potwierdzenia wpłaty. Jeżeli w panelu operatora widać sukces, a w heyhey zamówienie nadal oczekuje, trzeba sprawdzić weryfikację transakcji i powiadomienie. Nie rozwiązuj tego przez ponowne obciążanie klienta.

6. BLIK, przelewy i karty

BLIK jest metodą płatności obsługiwaną przez operatora. Do korzystania z niej nie zakładasz osobnego konta o nazwie BLIK.

Opcja BLIK Level 0 w heyhey dotyczy wpisywania kodu BLIK bezpośrednio w koszyku. Włącz ją tylko wtedy, gdy Przelewy24 aktywowało tę usługę na Twoim koncie. Bez niej klient może korzystać z przebiegu wymagającego przekierowania do operatora, jeśli metoda jest dostępna. Brak aktywacji Level 0 nie oznacza automatycznie braku każdej płatności BLIK.

Obsługa kart również wymaga gotowości konta u operatora. Przełącznik kart w heyhey nie zastępuje aktywacji w Przelewy24. Jeśli sprzedajesz abonament, sprawdź z operatorem wymagania dotyczące płatności cyklicznych kartą i przetestuj subskrypcję osobno.

Przy kilku połączonych polskich operatorach sprawdź, który jest domyślny. Wybór wpływa na obsługę przelewów, natomiast dostępność BLIK-a jest sprawdzana osobno. Nie trzeba odłączać innych operatorów, żeby najpierw sprawdzić konfigurację.

7. Przeprowadź test zakupu

Do prób używaj konta i danych środowiska testowego Przelewy24 z włączonym Sandbox w heyhey. Przełącznik nie tworzy konta testowego i nie przenosi do niego kluczy z produkcji.

1. Połącz komplet danych testowych i upewnij się, że tryb jest włączony.
2. Otwórz stronę produktu w osobnym oknie przeglądarki.
3. Przejdź do koszyka, podaj adres e-mail, który możesz sprawdzić, i wybierz płatność przez Przelewy24.
4. Dokończ scenariusz płatności testowej.
5. Porównaj transakcję u operatora ze statusem w Sprzedaż → Zamówienia w heyhey.
6. Sprawdź wiadomość zakupową, pobieranie materiału lub dostęp do kursu.
7. Jeśli korzystasz z BLIK Level 0 albo subskrypcji, wykonaj dodatkowy test odpowiedniej funkcji.

Przed uruchomieniem sprzedaży wstaw dane produkcyjne i wyłącz Sandbox. Sprawdź rzeczywisty zakup na małą kwotę, uwzględniając zasady rozliczania i ewentualnego zwrotu u operatora. Nie przełączaj działającego koszyka na testy w trakcie zakupów klientów.

Najczęstsze problemy

Rozliczenia i pomoc

Wpłaty i wypłaty sprawdzasz na swoim koncie Przelewy24. Zamówienia oraz dostęp klientów znajdziesz w heyhey. Zmiana konta operatora nie przenosi automatycznie rozliczeń ani istniejących subskrypcji.

Do zgłoszenia problemu dołącz numer zamówienia heyhey, identyfikator transakcji Przelewy24, czas próby i treść komunikatu bez danych poufnych. Nie wysyłaj klucza CRC ani API. Pomoc heyhey może wtedy sprawdzić konkretną próbę zamiast prosić Cię o ponowne przechodzenie całej konfiguracji.