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. Dodaj adres IP serwera heyhey w Przelewy24

Przelewy24 odpowiada tylko serwerom, których adres IP jest dodany do dozwolonych w konfiguracji API. Zrób ten krok przed kliknięciem przycisku połączenia w heyhey. Bez niego Przelewy24 odrzuci połączenie nawet przy poprawnych kluczach.

1. W heyhey otwórz Sprzedaż → Płatności i znajdź kartę Przelewy24. Adres IP serwera heyhey jest widoczny nad polami formularza.
2. Skopiuj go i w panelu Przelewy24 wróć do Moje dane → Ustawienia, sekcja Dane API i konfiguracja.
3. Dodaj adres do dozwolonych adresów IP i zapisz zmianę.
4. Wróć do heyhey i przejdź do następnego kroku.

To adres serwera heyhey, nie komputera kupującego ani Twojego domowego internetu. Nie zgaduj go na podstawie domeny strony i nie kopiuj IP z przypadkowego poradnika. Jeśli mimo dodania adresu połączenie jest odrzucane, napisz do pomocy heyhey.

4. 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, sprawdź jeszcze raz krok 3 (adres IP), zamiast wielokrotnie zmieniać poprawne klucze.

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 ma status Nieopłacone, 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.