Czym są płatności online Tpay?
Integracja z Tpay pozwala pobierać płatności od pacjentów drogą internetową - bez gotówki i terminala. Pacjent płaci wygodnie: BLIK-iem, szybkim przelewem, kartą, a przy większych kwotach może skorzystać z płatności odroczonych lub rozłożonych na raty (np. BLIK Płacę Później, PayPo, raty Pekao).
SmartDental wykorzystuje Tpay w trzech sytuacjach:
- Link do płatności w planie leczenia - wysyłany pacjentowi (SMS) lub kopiowany do wklejenia.
- Opłata rezerwacyjna przy potwierdzaniu wizyty - link do zapłaty dołączany do SMS-a z potwierdzeniem.
- Płatność kodem QR w gabinecie - pacjent skanuje kod telefonem i płaci na miejscu, bez terminala.
Po opłaceniu przez pacjenta wpłata automatycznie trafia do rozliczeń pacjenta i aktualizuje jego saldo.
W programie może być aktywny tylko jeden dostawca płatności online naraz - Tpay albo PayU. Włączenie Tpay automatycznie wyłącza PayU.
Konfiguracja Tpay
Otwórz Ustawienia → Integracja z Tpay.
Dane dostępowe otrzymasz po założeniu konta w panelu Tpay (sekcja API / integracje). Uzupełnij pola:
- Identyfikator klienta -
client_id z panelu Tpay.
- Klucz klienta -
client_secret z panelu Tpay.
- Klucz publiczny (PEM) – weryfikacja webhooka - klucz publiczny Tpay, służący do potwierdzania autentyczności powiadomień o płatnościach.
- Opłaty rezerwacyjne - lista opłat pobieranych przy potwierdzaniu wizyty. Każda pozycja to nazwa (np. „Konsultacja", „Wizyta", „Ortodoncja") i kwota w złotych. Kolejne dodajesz przyciskiem Dodaj opłatę, a usuwasz przyciskiem Usuń. Jeśli zdefiniujesz więcej niż jedną opłatę, przy wysyłce program zapyta, którą zastosować.
- Treść SMS – opłata rezerwacyjna - szablon wiadomości SMS z linkiem do zapłaty, wysyłanej pacjentowi. Możesz go dowolnie zmienić, korzystając ze znaczników (opisane niżej, w sekcji „Sposób 2: Opłata rezerwacyjna").
- Używaj środowiska Sandbox (testowego) - przełącznik trybu. Włączony = środowisko testowe Tpay (bez prawdziwych pieniędzy), wyłączony = środowisko produkcyjne (realne płatności).
Następnie:
- Kliknij Sprawdź ustawienia - program połączy się z Tpay i zweryfikuje dane logowania. Wynik pojawi się w polu Stan połączenia.
- Gdy połączenie działa, włącz przełącznik Używaj.
- Kliknij Zapisz.
Po każdej zmianie danych logowania (identyfikatora, klucza) zrestartuj aplikację. Bez restartu nowe dane nie zadziałają w terminarzu, planie leczenia ani karcie pacjenta. Program przypomni o tym po zapisie.
Wskazówka: Zanim zaczniesz przyjmować prawdziwe płatności, przetestuj integrację w trybie Sandbox. Po udanych testach wyłącz przełącznik Sandbox, ponownie kliknij Sprawdź ustawienia (już danymi produkcyjnymi) i zrestartuj aplikację.
Sposób 1: Link do płatności w planie leczenia
W karcie pacjenta, w planie leczenia, kliknij przycisk Generuj link do płatności. Otworzy się okno Generuj link do płatności:
- Kwota płatności (zł) - domyślnie podpowiada się pełna wartość planu leczenia; można ją zmienić (np. zaliczka).
- Ważność linku - jak długo link pozostaje aktywny: 7, 14, 30 lub 60 dni (domyślnie 30 dni).
- Po wygenerowaniu - co program ma zrobić z linkiem:
- Kopiuj link do schowka - wklejasz go np. do e-maila lub komunikatora,
- Wyślij SMS do pacjenta - link trafia SMS-em na numer pacjenta,
- Kopiuj + SMS - jedno i drugie.
Po zatwierdzeniu program utworzy transakcję w Tpay i wygeneruje link do płatności oraz kod QR. Pacjent otwiera link (lub skanuje kod) i płaci wybraną metodą.
Wygenerowana płatność otrzymuje status Oczekująca. Po opłaceniu jej przez pacjenta status zmienia się na Zapłacona, a wpłata jest automatycznie księgowana w rozliczeniach pacjenta i przypisywana do właściwego planu leczenia.
Status płatności sprawdzasz przyciskiem Odśwież. Jeśli pacjent właśnie zapłacił, po odświeżeniu płatność zmieni status na Zapłacona, a saldo pacjenta zaktualizuje się automatycznie.
Sposób 2: Opłata rezerwacyjna przy potwierdzaniu wizyty
Opłatę rezerwacyjną (SMS z linkiem do zapłaty) wyślesz na dwa sposoby:
- z terminarza - kliknij wizytę prawym przyciskiem i wybierz Wyślij opłatę rezerwacyjną,
- z głównego okna programu (lista umówionych wizyt) - w menu wiersza wizyty wybierz Komunikacja → Wyślij opłatę rezerwacyjną.
Jeśli w ustawieniach zdefiniowano więcej niż jedną opłatę, pojawi się okno Wybierz opłatę rezerwacyjną - zaznacz właściwą (np. „Konsultacja – 100 zł") i kliknij Wyślij. Przy jednej opłacie SMS wychodzi od razu.
Treść SMS-a ustawiasz w Ustawienia → Integracja z Tpay, w polu Treść SMS – opłata rezerwacyjna. Możesz w niej używać znaczników:
@OplataRezerwacyjna# - kwota wybranej opłaty,@NazwaOplaty# - nazwa wybranej opłaty,{PAYMENT_LINK} - miejsce, w które wstawi się link do zapłaty,- dodatkowo m.in.
@datagodzina# (data i godzina wizyty), @NazwaPlacowki#, @Lekarz#, @Pacjent#.
Przykładowa treść: „@NazwaPlacowki#: aby potwierdzić wizytę @datagodzina#, opłać rezerwację @OplataRezerwacyjna# zł: {PAYMENT_LINK}".
Pacjent klika link w SMS-ie i opłaca rezerwację. Po zaksięgowaniu wpłata jest powiązana z konkretną wizytą.
Aby SMS zmieścił się w jednej wiadomości (i był tańszy), pisz treść bez polskich znaków diakrytycznych (np. „oplac rezerwacje" zamiast „opłać rezerwację") - jeden „ogonek" przełącza SMS na dłuższe kodowanie i skraca limit znaków.
Info: To ustawienie dotyczy tylko SMS-a z opłatą rezerwacyjną. Zwykłe szablony przypomnień o wizycie konfiguruje się osobno - zobacz artykuł Potwierdzenia wizyt SMS.
Sposób 3: Płatność kodem QR w gabinecie (tylko Tpay)
To wygodna alternatywa dla terminala płatniczego - pacjent płaci telefonem na miejscu, skanując kod QR.
W karcie pacjenta, przy rozliczeniu (nowa wpłata), jako sposób płatności wybierz Płatność online (QR). Otworzy się okno Pobierz płatność – Tpay QR:
- Duży kod QR do zeskanowania telefonem przez pacjenta,
- Kwota i Opis płatności,
- Licznik czasu - kod jest ważny przez 5 minut,
- Opcjonalny checkbox Wyślij też link SMS-em na telefon pacjenta - jeśli pacjent woli otrzymać link zamiast skanować.
Pacjent skanuje kod, wybiera metodę płatności (np. BLIK) i płaci. Okno samo sprawdza status co kilka sekund - po zaksięgowaniu wpłaty pokazuje Zapłacono ✓ i zamyka się. Wpłatę zapisujesz następnie jak każde inne rozliczenie.
Jeśli pacjent nie zdąży zapłacić w ciągu 5 minut, po prostu wygeneruj kod ponownie.
Info: Płatność kodem QR w gabinecie jest dostępna wyłącznie dla Tpay. Przy aktywnym PayU ta opcja się nie pojawia.
Co dzieje się po opłaceniu
Niezależnie od sposobu (link, opłata rezerwacyjna, QR), po opłaceniu przez pacjenta:
- Płatność zmienia status na Zapłacona.
- Wpłata jest automatycznie księgowana w rozliczeniach pacjenta w prawidłowej kwocie.
- Jest powiązywana z odpowiednim planem leczenia lub wizytą.
- Saldo pacjenta aktualizuje się automatycznie.
W planie leczenia i w terminarzu status płatności odświeża się przyciskiem Odśwież. W oknie płatności QR status aktualizuje się sam.
Automatyczne potwierdzanie płatności wymaga poprawnie skonfigurowanego połączenia z Tpay. Jeśli status płatności długo pozostaje Oczekująca mimo zapłaty pacjenta, kliknij Odśwież, a w razie potrzeby sprawdź połączenie w Ustawienia → Integracja z Tpay (przycisk Sprawdź ustawienia).
Najczęstsze pytania
Czy mogę używać Tpay i PayU jednocześnie?
Nie. Aktywny może być tylko jeden dostawca. Włączenie przełącznika Używaj w oknie Tpay automatycznie wyłącza PayU.
Pacjent zapłacił, ale wpłaty nie widać - co zrobić?
Kliknij Odśwież w planie leczenia lub terminarzu. Jeśli to nie pomoże, sprawdź w Ustawienia → Integracja z Tpay, czy połączenie działa (Sprawdź ustawienia) i czy przełącznik Sandbox jest ustawiony zgodnie z używanym kontem (produkcja vs testy).
Jakimi metodami płaci pacjent?
Zależy to od Twojego konta Tpay - typowo BLIK, szybki przelew, karta oraz płatności odroczone/ratalne (BLIK Płacę Później, PayPo, raty Pekao).
Zmieniłem dane logowania i płatności przestały działać.
Po zmianie danych logowania trzeba zrestartować aplikację. Dopóki tego nie zrobisz, program korzysta z poprzednich danych.
Do czego służy tryb Sandbox?
Sandbox to środowisko testowe Tpay - płatności są symulowane, bez prawdziwych pieniędzy. Używaj go do sprawdzenia integracji przed uruchomieniem realnych płatności.
