Tpay

Tpay obsługuje BLIK (w tym płatności powtarzalne) oraz karty. Konfiguracja: Ustawienia organizacji → Integracje płatności → Tpay. Poniższe kroki są tożsame z instrukcją w panelu Zevio.

Konfiguracja płatności Tpay

1. Powiadomienia (webhook i e-mail)

W Panelu Akceptanta przejdź do Ustawienia → Powiadomienia.

  • URL do powiadomień: W sekcji „URL do powiadomień” wklej poniższy adres i zapisz. Tpay będzie wysyłał na ten adres Zevio informacje o rejestracji płatności.
  • URL powiadomień o tokenie: W sekcji „URL powiadomień o tokenie” wklej ten sam adres. Jest potrzebny przy tokenizacji karty (trial, wznowienie subskrypcji, zmiana karty) oraz przy aktualizacjach statusu tokenu.
  • Powiadomienia e-mail: W sekcji „Powiadomienia e-mail” ustaw typ wysyłanego powiadomienia na „Brak”. Zevio obsługuje powiadomienia do klientów; możesz je włączyć lub wyłączyć w ustawieniach organizacji.
Adres webhooka generuje Zevio dla organizacji (kopiowalny w modalu instrukcji). Wklej ten sam URL w obu polach powiadomień Tpay.

2. Dane dostępowe

Przy rejestracji przez Zevio client ID jest zapisywany automatycznie. Jeśli Tpay wyśle nowe dane dostępowe albo zmienisz je w Panelu Akceptanta, zaktualizuj client secret (oraz opcjonalnie klucz RSA Cards API) w Zevio: Integracje płatności → Tpay → Dane dostępowe. Nieprawidłowy secret uniemożliwi BLIK i kartę.

  • Pola: tpayClientId, tpayClientSecret
  • Opcjonalnie klucz publiczny RSA Cards API (Integracje → API → Cards API w panelu Tpay) - zbieranie kart na checkout Zevio bez pełnego redirectu
  • Po zmianie secretu w Tpay zaktualizuj go w Zevio - inaczej BLIK i karta przestaną działać

3. Wybór operatora płatności

Po aktywacji konta Tpay i konfiguracji powiadomień wybierz Tpay jako operator płatności kartą i/lub BLIK w ustawieniach organizacji (sekcja Operator płatności). Dopiero wtedy płatności będą kierowane przez Tpay.

Aktywacja konta (nowa rejestracja)

Konto merchanta zostało utworzone w Tpay. Na Twój adres email został wysłany link rejestracyjny. Kliknij poniższy przycisk, aby przejść do aktywacji konta.

Metody: BLIK i karta przez Tpay.

Testy sandbox (skrót)

Ustawienia organizacji → Dostawcy płatności → Aktywuj konto Tpay. Po rejestracji wybierz Tpay dla BLIK i/lub kart.

  • BLIK: kod BLIK zaczynający się od 777 (lub inny 777xxx).
  • Rejestracja Płatności powtarzalnej BLIK: kwoty z końcówką .08-.15 (np. 10.08, 19.14).
  • Karty: sukces.
  • Oferta z subskrypcją: użyj karty lub BLIK. Apple Pay i Google Pay w subskrypcji działają tylko ze Stripe.
Pełna lista kodów i scenariuszy: notebook sandbox w panelu oraz dokumentacja środowiska testowego Tpay.

Gdzie w panelu

  • /dashboard/settings/organization → Integracje płatności → Tpay
  • Sekcja Operator płatności - wybór Tpay dla karty i/lub BLIK

Aktywacja konta Tpay

Najpierw zapoznaj się z treścią, aby potwierdzić

1. Rejestracja i pierwsze logowanie

Aby umożliwić wykonywanie płatności, aktywuj konto w Panelu Akceptanta Tpay - link aktywacyjny znajdziesz w przycisku powyżej lub otrzymasz go e-mailem - oraz uzupełnij wymagane dane sprzedawcy w swoim koncie Tpay. Dane muszą być zgodne z danymi firmy użytymi przy rejestracji w Zevio. Ukończenie weryfikacji konta jest wymagane do przyjmowania płatności i dodania rachunku wypłat.

2. Weryfikacja sprzedawcy

Po zalogowaniu do PA kliknij „Zweryfikuj konto” i wypełnij formularz. Formularz ma kilka kroków - wypełniaj je po kolei; aby przejść do kolejnego kroku, uzupełnij wszystkie pola oznaczone jako wymagane w kroku bieżącym.

2.1. Podstawowe informacje (dane firmy)

Uzupełnij dane firmy. Możesz dodać adres www strony oraz adres do korespondencji. Dla podmiotów z Polski dane wczytują się automatycznie z Bazy REGON; pozostałe podmioty uzupełniają dane ręcznie.

2.2. Dane osobowe - reprezentanci i beneficjent

Reprezentant: podaj dane osób uprawnionych do reprezentacji rejestrowanego przez Ciebie podmiotu: w przypadku jednoosobowej działalności gospodarczej - dane przedsiębiorcy; przy spółce cywilnej - dane wszystkich wspólników; w pozostałych przypadkach - dane osób uprawnionych do reprezentacji zgodnie z ustalonymi dla Twojego podmiotu zasadami reprezentacji (np. określone w KRS). Pamiętaj o dodaniu skanów lub zdjęć dokumentów tożsamości wskazanych reprezentantów (pole pod danymi). Gdy spółka - załącz oświadczenie o beneficjencie rzeczywistym.

Równolegle Dział AML sprawdza zawartość i działanie strony sprzedażowej (m.in. regulamin, polityka prywatności, opisy produktów).

2.3. Wymagane dokumenty (wyświetlany warunkowo)

Ten krok nie jest obowiązkowy dla wszystkich. W części przypadków system może wymagać załączenia Oświadczenia o Beneficjentach Rzeczywistych lub Oświadczenia o Zajmowaniu Eksponowanych Stanowisk Politycznych - wzór pobierasz przyciskiem „Pobierz” w tym kroku. Przejście dalej możliwe dopiero po załączeniu wymaganego pliku. Jeśli oświadczenie nie jest wymagane, przejdziesz od razu do kroku 2.4. Dla podmiotów zagranicznych system może wymagać dokumentów rejestrowych w tłumaczeniu (min. na język angielski, tłumaczenie przysięgłe lub urzędowo poświadczone).

2.4. Wniesienie opłaty aktywacyjnej

Po uzupełnieniu wszystkich wymaganych danych wykonaj opłatę aktywacyjną - to równoznaczne z przekazaniem danych do weryfikacji. Opłata jest bezzwrotna. W tym kroku akceptowane są także OGŚUP (aktualna treść na stronie Tpay). Kliknij „Wykonaj opłatę aktywacyjną” - zostaniesz przekierowany do Panelu Płatności w celu wykonania przelewu. Do zaksięgowania przelewu w PA przycisk „Zweryfikuj konto” nadal będzie widoczny (po kliknięciu - komunikat o oczekiwaniu na zaksięgowanie); po zaksięgowaniu przycisk zniknie.

Potwierdzenie oświadczenia

Potwierdź oświadczenie, aby przejść do ostatniego kroku.

Oświadczam, że jestem osobą uprawnioną do zawarcia umowy z Tpay oraz akceptuję Ogólne warunki świadczenia usług płatniczych (OGŚUP).

Dział AML rozpatruje sprawy w kolejności napływania; nie ma możliwości przyspieszenia przez handlowych ani BOK. Po pozytywnej weryfikacji konto ma status „Aktywny”; tryb testowy pozostaje włączony - aby przyjmować realne płatności, wyłącz go w PA → Ustawienia → Tryb testowy. Na e-mail przyjdzie informacja o pozytywnej weryfikacji. Moment poprawnego zweryfikowania konta jest momentem zawarcia Umowy o Świadczenie Usług Płatniczych.

W panelu Zevio przed wyłączeniem trybu testowego Tpay musisz potwierdzić zapoznanie się z tą instrukcją aktywacji (checkboxy w modalu).

Szczegółowe scenariusze sandbox

Ustawienia organizacji → Dostawcy płatności → Aktywuj konto Tpay. Po rejestracji wybierz Tpay dla BLIK i/lub kart.

BLIK

  • kod BLIK zaczynający się od 777 (lub inny 777xxx).
  • zakres kodów testowych BLIK.
  • Rejestracja Płatności powtarzalnej BLIK: kwoty z końcówką .08-.15 (np. 10.08, 19.14).
  • Płatność może zakończyć się sukcesem, mimo że BLIK nie zostanie zapisany do Płatności powtarzalnych BLIK (limity testowe na kod).
  • Kody 999***: co 15 min usuwane są najstarsze zapisy, utrzymywane jest 20 najnowszych.
  • Kody 777*** z kwotą z końcówką .08 (np. 15.08) pozostają aktywne co najmniej tydzień.
  • sandbox Zevio, wszyscy operatorzy BLIK: symulacja banku bez wsparcia Płatności powtarzalnych BLIK. Gdy flaga „Uruchom manualne Płatności powtarzalne BLIK, gdy bank nie jest obsługiwany” jest włączona (refuseNoPayId: false), płatność przechodzi jako jednorazowy BLIK z ręcznymi Płatnościami powtarzalnymi BLIK; inaczej Zevio zaproponuje ofertę zastępczą lub ręczne wpisanie kodu.
  • 495.00 PLN + dowolny kod 777***: symulacja banku bez Płatności powtarzalnych BLIK.

Karty

  • Tylko numery testowe. Dowolne imię i nazwisko, przyszła data ważności, CVV 3 cyfry.
  • sukces.
  • Wynik weryfikacji 3D Secure zależy od groszy kwoty: .01 bez dodatkowego kroku, .03 i .05 różne scenariusze, .06 odrzucenie, inne kwoty - dodatkowe potwierdzenie.
  • Wymuszone błędy przy kwotach: 500.00, 501.00, 503.00 (karta i portfel); 504.00 przy płatności zapisaną kartą.

Apple Pay / Google Pay

  • Przekierowanie do Tpay. Apple Pay w Safari, Google Pay w Chrome / na Androidzie. Karta w portfelu nie jest obciążana.
  • Apple Pay: Safari na iPhone/iPad/Mac z kartą w Wallet → potwierdź na Tpay → sukces.
  • Google Pay: Chrome lub Android, dołącz do grupy testowej googlepay-support-tpay, dodaj kartę testową → potwierdź na Tpay → sukces.
  • Kwoty 500.00, 501.00, 503.00 PLN - wymuszony błąd (jak przy kartach).
  • Oferta z subskrypcją: użyj karty lub BLIK. Apple Pay i Google Pay w subskrypcji działają tylko ze Stripe.
dokumentacja środowiska testowego Tpay: https://support.tpay.com/sprzedawca/srodowisko-testowe-sandbox