Jak połączyć Tpay z heyhey

Tpay podłączysz do heyhey przy użyciu Client ID i Secret z Open API. Dzięki temu płatności Twoich kupujących są obsługiwane na Twoim koncie Tpay. Nie potrzebujesz własnego serwera, wtyczki do WordPressa ani wiedzy programistycznej.

Konfiguracja ma dwa ważne etapy: połączenie konta i ustawienie powiadomień o wpłatach. Przejdź oba, a na końcu sprawdź zakup produktu od początku do końca.

1. Przygotuj konto sprzedawcy

Przygotuj aktywne konto Tpay i dostęp do Panelu Akceptanta. Wykonaj wymagane przez operatora kroki rejestracji i aktywacji. Jeśli dopiero zaczynasz, samo utworzenie loginu nie musi jeszcze oznaczać zgody na przyjmowanie wszystkich rodzajów płatności.

W heyhey otwórz Sprzedaż → Płatności, czyli ustawienia operatorów. Odszukaj kartę Tpay. Na czas konfiguracji pozostaw panel Tpay otwarty w drugiej karcie.

Do zwykłej sprzedaży w tej integracji przygotuj produkt z ceną PLN. BLIK jest metodą płatności, a Tpay operatorem, który ją obsługuje. Nie zakładasz dodatkowego konta „BLIK”.

2. Wygeneruj klucze Open API

1. W panelu Tpay wybierz Integracja → API.
2. Odszukaj sekcję Klucze do nowego Open API.
3. Dodaj nowy klucz, najlepiej przeznaczony tylko dla heyhey.
4. Skopiuj wygenerowane Client ID i Secret. Zapisz sekret w bezpiecznym menedżerze haseł, ponieważ panel może pokazać go tylko przy utworzeniu.

Tpay ma także starsze mechanizmy API. Do formularza heyhey potrzebujesz właśnie Open API, a nie numeru konta sprzedawcy i klucza ze starej integracji. Ścieżkę tworzenia potwierdza instrukcja Tpay dotycząca dostępu do API.

3. Połącz Tpay w heyhey

1. Wklej Client ID do pola na karcie Tpay.
2. Wklej Secret do pola poufnego. Nie dopisuj cudzysłowów ani spacji.
3. Ustaw tryb odpowiadający skopiowanym danym.
4. Kliknij Połącz Tpay.
5. Sprawdź, czy karta pokazuje Połączono.

Dane testowe i produkcyjne nie są zamienne. Jeżeli testujesz, korzystaj z konta i danych testowych Tpay. Przed udostępnieniem płatności klientom przejdź na dane produkcyjne i wyłącz Sandbox.

4. Ustaw powiadomienia o zapłacie

Po połączeniu karta Tpay w heyhey pokazuje adres powiadomień. To adres, pod który Tpay wysyła wynik transakcji. Nie jest linkiem dla klienta ani adresem Twojej strony głównej.

1. Skopiuj cały adres powiadomień z karty Tpay w heyhey.
2. W panelu Tpay przejdź do Ustawienia → Powiadomienia.
3. Włącz możliwość nadpisania adresu powiadomienia, jeśli korzystasz z adresu przekazywanego przez heyhey dla transakcji. Alternatywnie wpisz dokładny adres z heyhey jako adres powiadomień dla tej konfiguracji.
4. Zapisz ustawienia i wróć do testowania zakupu.

Jeśli używasz tego samego konta Tpay w innym sklepie, nie zastępuj bez sprawdzenia jego adresu powiadomień. Możliwość nadpisania pozwala przekazywać odpowiedni adres dla danej transakcji. Przy bardziej złożonym koncie poproś Tpay lub heyhey o sprawdzenie ustawień.

Dokumentacja powiadomień Tpay wyjaśnia nadpisywanie adresu i wymóg użycia końcowego URL bez przekierowania. Skopiuj więc adres z heyhey w całości, razem z https://, zamiast samodzielnie budować go z nazwy domeny.

5. Sprawdź karty, BLIK i inne metody

Połączenie konta nie uruchamia automatycznie każdej usługi dostępnej w ofercie Tpay. Karty, Apple Pay i Google Pay mogą wymagać dodatkowej aktywacji przez operatora.

Jeżeli Tpay potwierdził włączenie kart na Twoim koncie, zaznacz odpowiednią opcję na karcie Tpay w heyhey i zapisz. Ten przełącznik informuje heyhey o gotowości konta, sam nie zawiera umowy ani nie aktywuje usługi w Tpay.

Gdy masz podłączonych kilku polskich operatorów, na ich kartach pojawia się możliwość wybrania domyślnego. Pierwsze poprawnie podłączone konto zostaje domyślnym, jeśli nie było wcześniejszego wyboru. Wybrany operator wpływa na obsługę przelewów; dostępność BLIK-a na stronie jest sprawdzana osobno. Dlatego po zmianie domyślnego operatora sprawdź obie metody w koszyku.

Subskrypcje wymagają odpowiednio aktywowanej obsługi płatności cyklicznych kartą. Udany jednorazowy BLIK nie jest potwierdzeniem gotowości cyklicznych obciążeń.

6. Sprawdź pełny zakup

1. Otwórz opublikowany produkt z włączoną sprzedażą i ceną w PLN.
2. Wejdź do koszyka jako kupujący, najlepiej w osobnym oknie.
3. Wybierz BLIK albo przelew i dokończ płatność zgodnie z wybranym trybem.
4. Sprawdź transakcję w Tpay, a następnie zamówienie w Sprzedaż → Zamówienia w heyhey.
5. Sprawdź wiadomość zakupową i dostęp do produktu na adresie użytym w koszyku.
6. Przy aktywowanych kartach wykonaj także oddzielny test tej metody.

Płatność jest prawidłowo sprawdzona dopiero wtedy, gdy zgadza się stan po obu stronach. Powrót kupującego na stronę nie zastępuje powiadomienia o wpłacie.

Najczęstsze problemy

Pomoc i późniejsze zmiany

Pieniądze i wypłaty sprawdzasz w panelu Tpay, a zakup i dostęp do produktu w heyhey. To dwa widoki tej samej sprzedaży, dlatego do zgłoszenia warto dołączyć numer transakcji Tpay i numer zamówienia heyhey.

Przed usunięciem klucza lub odłączeniem konta sprawdź aktywne subskrypcje. Odłączenie integracji nie jest równoznaczne z ich prawidłowym anulowaniem. Jeśli konfiguracja wymaga pomocy, napisz do heyhey, bez przesyłania Secret.