# Integracja płatności: Tpay

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

Opublikowano: 2026-08-01 · Aktualizacja: 2026-09-16
Źródło: https://kompasfirm.pl/dokumentacja/platnosci-integracja-tpay

---
## 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](/img/help/platnosci/04-checkout-subskrypcja.png)

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. Zasada jest zachowawcza: jeżeli cokolwiek w potwierdzeniu się nie zgadza, płatność nie zostaje uznana. Wolimy zablokować wątpliwą transakcję niż przepuścić ją „na wszelki wypadek".

Powtórzone potwierdzenie tej samej płatności jest nieszkodliwe: skutek księguje się dokładnie raz, niezależnie od tego, ile razy operator powtórzy powiadomienie. Klient nie zostanie obciążony dwa razy za to samo.

## 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ą automatycznie, bez udziału klienta, na podstawie zgody udzielonej przy pierwszej płatności.

## Odnowienia i nieudane płatności

W dniu terminu karta zostaje obciążona, a zaplanowane wcześniej obniżenia planu wchodzą w życie. Wszystko dzieje się automatycznie, klient dostaje potwierdzenie na e-mail.

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.