Tpay
API

Metody Integracji

Podstawowym bytem, który obsługujemy w bramce płatniczej, jest transakcja. Przebieg płatności może różnić się w zależności od integracji i kanału płatności.

Poniżej kilka sposobów integracji, jakie możesz zrealizować w naszej bramce płatniczej.

Integracja podstawowa

Podstawowy przepływ płatności w naszym systemie wygląda następująco:

  1. Utworzenie transakcji: Pierwszym krokiem jest utworzenie nowej transakcji w systemie.
  2. Przekierowanie na Panel Transakcyjny: Następnie użytkownik zostaje przekierowany na Panel Transakcyjny, gdzie może dokonać płatności.
  3. Opłacenie Transakcji: Użytkownik opłaca transakcję na Panelu Transakcyjnym.
  4. Notyfikacja o poprawnym opłaceniu: Po pomyślnym dokonaniu płatności, system wysyła notyfikację potwierdzającą opłacenie transakcji.

Integracja on-site

Dla kilku metod płatności istnieje możliwość zrealizowania płatności bez przekierowania na Panel Transakcyjny. Nazywamy je on-site lub Level 0. W tym przypadku cały proces płatności jest obsługiwany w Twoim systemie.

Proces płatności dla tego przypadku to:

  1. Utworzenie transakcji: Rozpocznij od utworzenia nowej transakcji w systemie.
  2. Wyświetlenie formularza płatności w Twoim systemie: Następnie wyświetl formularz płatności bezpośrednio w swoim systemie.
  3. Wysłanie danych z formularza w celu opłacenia transakcji: Użytkownik wypełnia formularz na Twojej stronie, a dane są wysyłane do systemu płatności w celu dokonania transakcji.
  4. Notyfikacja o poprawnym opłaceniu: Po pomyślnym dokonaniu płatności, otrzymujesz notyfikację potwierdzającą opłacenie transakcji.

Więcej szczegółów znajdziesz w metodach płatności, gdzie ta integracja jest możliwa: (BLIK, Karty, Visa Mobile, Google Pay, Apple Pay)

Integracja dwuetapowa

System Tpay umożliwia zlecenie zwrotu do transakcji dla klienta, zanim środki zostały zaksięgowane w Panelu Akceptanta.

W przypadku dwuetapowego przyjmowania płatności wysyłamy dwa powiadomienia systemowe:

  1. Pierwsze powiadomienie systemowe informuje system sprzedawcy, że została wykonana płatność dla transakcji i w tym momencie oczekujemy na odpowiedź z systemu sprzedawcy, czy transakcję przyjąć lub zwrócić. Sprzedawca nie ustawia u nas żadnych danych, wektora czasowego ani nic innego. Integrację opiera na swoim systemie.
  2. Drugie powiadomienie systemowe wysyłamy znając już decyzję sprzedawcy, czyli jest to standardowe powiadomienie zawierające dane transakcji w tym jej status (poprawna, zwrócona itd).
Uwaga
  • Powiadomienia do transakcji są wysyłane zgodnie z harmonogramem wysyłania powiadomień. Brak odpowiedzi na ostatnie powiadomienie będzie traktowany tak, jakby Twój system odpowiedział FALSE. W rezultacie transakcja zostanie zwrócona płatnikowi.
  • Dla transakcji bez ustawionego adresu powiadomienia URL, nastąpi automatyczny zwrot po upływie 7 dni od daty płatności, jeśli transakcja dalej posiada status PAID.

Proces przyjmowania płatności dla tego przypadku dwuetapowego to:

  1. Utworzenie transakcji: Pierwszym krokiem jest utworzenie nowej transakcji w systemie.
  2. Przekierowanie na Panel Transakcyjny: Następnie użytkownik zostaje przekierowany na Panel Transakcyjny, gdzie może dokonać płatności.
  3. Opłacenie Transakcji: Użytkownik opłaca transakcję na Panelu Transakcyjnym.
  4. Notyfikacja o płatności: Pierwsze powiadomienie systemowe informuje system sprzedawcy, że została wykonana płatność dla transakcji w odpowiedzi oczekujemy informacji, czy transakcję przyjąć lub zwrócić.
  5. Notyfikacja o poprawnym opłaceniu: Po pomyślnym dokonaniu płatności, system wysyła notyfikację potwierdzającą opłacenie transakcji.
Uwaga

Tryb integracji dwuetapowej na życzenie włączy na Twoim koncie Biuro Obsługi Klienta.

Integracja rekurencyjna/cykliczna

Dla kart płatniczych istnieje możliwość zrealizowania płatności rekurencyjnych (np. abonament, raty etc.). W tym przypadku po poprawnej płatności kartą możemy zwrócić informację o tokenie płatniczym, który możesz użyć dla przyszłych płatności cyklicznych. Istnieją dwa typy płatności, w których zwracamy token.

I. Płatność z obciążeniem - token zostanie wydany po opłaceniu zwykłej transakcji kartowej:

  1. Utworzenie transakcji: Rozpocznij od utworzenia nowej transakcji w systemie.
  2. Przekierowanie na Panel Transakcyjny lub integracja on-site: Następnie płatnik zostaje przekierowany na Panel Transakcyjny, gdzie może dokonać płatności lub podczas integracji kartowej on-site oznaczasz parametr chęci otrzymania tokenu.
  3. Uwierzytelnianie 3D Secure (3DS): Płatnik uwierzytelnia transakcję w 3D Secure (3DS).
  4. Opłacenie Transakcji: Płatnik opłaca transakcję.
  5. Notyfikacja o poprawnym opłaceniu: Po pomyślnym dokonaniu płatności, otrzymujesz notyfikację potwierdzającą opłacenie transakcji, wraz z utworzonym tokenem płatniczym.
  6. Zapisanie tokenu płatniczego: Zapisujesz po swojej stronie token płatniczy dla kolejnych transakcji tą samą kartą.
  7. Płatności rekurencyjne: Procesujesz kolejne transakcje dla tej samej karty, wykorzystując otrzymany token płatniczy.

Więcej informacji znajdziesz tutaj.

II. Płatność weryfikacyjna polega na tym, że konto płatnika nie zostaje obciążone żadną kwotą, a w efekcie wydany zostaje token płatniczy:

  1. Rozpoczęcie tokenizacji: Zacznij od utworzenia nowej tokenizacji w systemie.
  2. Przekierowanie na Panel Transakcyjny: Następnie płatnik zostaje przekierowany na Panel Transakcyjny, gdzie podaje dane karty płatniczej.
  3. Uwierzytelnienie tokenizacji: Płatnik uwierzytelnia operację w 3D Secure (3DS).
  4. Notyfikacja o poprawnej tokenizacji: Po pomyślnym procesie otrzymujesz notyfikację zawierającą token płatniczy.
  5. Zapisanie tokenu płatniczego: Zapisujesz po swojej stronie token płatniczy dla kolejnych transakcji tą samą kartą.
  6. Płatności rekurencyjne: Procesujesz kolejne transakcje dla tej samej karty, wykorzystując otrzymany token płatniczy.

Więcej informacji znajdziesz tutaj.