Przejdź do treści
Dokumentacja Integracja płatności: Tpay
Płatności

Integracja płatności: Tpay

Architektura płatności: dostawcy za interfejsem, przebieg transakcji, weryfikacja powiadomień, tokenizacja karty i obciążenia cykliczne.

Zakres

Płatności obsługuje Tpay (Krajowy Integrator Płatności S.A.), polski operator nadzorowany przez KNF. Rozliczenia idą w złotych. Obsługiwane są trzy przypadki: zakup pakietu tokenów, plan opłacony z góry oraz subskrypcja cykliczna z zapisaną kartą.

Metody płatności: BLIK, karty Visa i Mastercard, szybkie przelewy pay-by-link.

Przebieg płatności jednorazowej

  1. Klient zatwierdza zamówienie w panelu.
  2. System wylicza kwotę w złotych i zakłada zapis transakcji ze statusem oczekującym.
  3. Klient trafia na stronę płatności operatora i płaci wybraną metodą.
  4. Operator zwrotnie potwierdza płatność bezpośrednio do systemu, kanałem serwer-serwer.
  5. Dopiero to potwierdzenie uruchamia skutek: tokeny trafiają na konto albo plan zostaje aktywowany.

Ekran zamówienia planu z kwotą w złotych i warunkami płatności

Powrót przeglądarki klienta i potwierdzenie od operatora to dwie niezależne ścieżki. Skutek księgujemy wyłącznie na podstawie potwierdzenia operatora, nigdy na podstawie tego, że przeglądarka wróciła na stronę sukcesu. Dzięki temu przerwane połączenie ani zamknięta karta nie powodują zgubionej płatności, a spreparowany powrót nie da nikomu darmowego planu.

Weryfikacja potwierdzeń

Każde potwierdzenie od operatora jest sprawdzane dwiema niezależnymi metodami zanim cokolwiek zostanie zaksięgowane: podpisem wyliczanym ze wspólnego sekretu oraz podpisem kryptograficznym w nagłówku żądania.

Weryfikacja działa fail-closed: brak sekretu albo niezgodny podpis oznacza odrzucenie, a nie „przepuść na wszelki wypadek". Powtórzone potwierdzenie tej samej płatności jest nieszkodliwe, bo przetwarzanie jest idempotentne — skutek księguje się dokładnie raz, niezależnie od tego, ile razy operator powtórzy powiadomienie.

Subskrypcje

Przy pierwszej płatności kartą operator zapisuje kartę po swojej stronie i przekazuje wyłącznie token, czyli identyfikator bez numeru karty. Numer karty nigdy nie trafia do systemu ani do bazy. Sam token jest u nas dodatkowo szyfrowany.

Kolejne okresy obciążane są w trybie transakcji inicjowanej przez sprzedawcę, bez udziału klienta. Wymaga to osobnej zgody po stronie operatora, włączanej na koncie sprzedawcy.

Odnowienia i windykacja miękka

Raz na dobę uruchamia się przegląd subskrypcji. W jednym przebiegu:

  • obciążane są karty subskrypcji, którym minął termin,
  • wykonywane są zaplanowane obniżenia planu,
  • prowadzona jest windykacja miękka nieudanych płatności.

Nieudane obciążenie nie kończy subskrypcji od razu. Ponowienia następują po 1, 3 i 5 dniach, a po każdej próbie klient dostaje wiadomość. Dopiero wyczerpanie prób kończy subskrypcję i cofa konto do planu darmowego.

Faktury i zwroty

Faktura wystawiana jest elektronicznie i wysyłana na adres przypisany do konta. Zwrot środków przy uznanej reklamacji następuje w ciągu 14 dni, tą samą metodą płatności, którą klient zapłacił; przy płatności kartą środki wracają na tę samą kartę.

Ograniczenia

  • Potwierdzenie płatności bywa opóźnione po stronie operatora. Plan aktywuje się wtedy z kilkuminutowym poślizgiem, automatycznie, bez interwencji.
  • Płatność przelewem tradycyjnym aktywuje usługę dopiero po zaksięgowaniu wpłaty, co zależy od banków, nie od systemu.
  • Subskrypcje cykliczne wymagają zgody operatora na obciążenia inicjowane przez sprzedawcę. Bez niej płatności jednorazowe i roczne działają, a automatyczne odnowienia nie.
Wolisz krótką instrukcję? Zajrzyj do Centrum pomocy albo napisz na kontakt@kompasfirm.pl.