Integracja płatności online: Przelewy24, PayU i Stripe w Twojej aplikacji
Okno płatności da się dodać szybko. Trudniejsze jest to, co dzieje się po kliknięciu „zapłać”: przelew potwierdzony po godzinie, płatność odrzucona, zwrot po tygodniu.
Autor: Szymon Łakomy. Aktualizacja:
Jak powinien wyglądać obieg płatności
- Aplikacja tworzy zamówienie ze statusem „oczekuje na płatność” i zapisuje unikalny identyfikator transakcji.
- Klient przechodzi do bramki albo płaci w osadzonym oknie dostawcy.
- Bramka wysyła potwierdzenie na adres aplikacji, a aplikacja weryfikuje jego podpis.
- Dopiero poprawnie zweryfikowane potwierdzenie zmienia status zamówienia i uruchamia dalszy proces.
- Powrót klienta na stronę z wynikiem jest tylko informacją, nie dowodem płatności.
- Kolejne zdarzenia, czyli zwrot, spór albo odrzucenie, aktualizują zamówienie tym samym kanałem.
Statusy, które trzeba obsłużyć
| Sytuacja | Co powinno się stać |
|---|---|
| Płatność udana | zmiana statusu, dokument sprzedaży i wiadomość do klienta |
| Płatność odrzucona | zamówienie zostaje otwarte, klient może spróbować ponownie lub wybrać inną metodę |
| Brak potwierdzenia przez dłuższy czas | zadanie sprawdza status w bramce i wygasza zamówienie po ustalonym terminie |
| Potwierdzenie przychodzi dwa razy | drugie jest ignorowane, nie powstaje drugi dokument ani druga wysyłka |
| Kwota inna niż w zamówieniu | zamówienie trafia do ręcznej weryfikacji |
| Zwrot | status zamówienia i dokument korygujący zmieniają się razem ze zwrotem |
Zaliczki, raty i płatności cykliczne
Każdy z tych scenariuszy ma własne reguły: kiedy zaliczka wraca, kiedy przepada i kto o tym decyduje. Reguły ustala regulamin firmy, a integracja je stosuje. Płatności cykliczne wymagają zgody klienta na kolejne obciążenia i obsługi nieudanych prób. Zaliczki przy terminach opisuję szerzej na stronie system rezerwacji online.
Bezpieczeństwo, na którym nie oszczędzam
- dane karty nie przechodzą przez serwer aplikacji, obsługuje je okno lub formularz dostawcy,
- klucze i sekrety są tylko po stronie serwera, osobne dla testów i produkcji,
- podpis każdego potwierdzenia jest sprawdzany, zanim cokolwiek zmieni się w zamówieniu,
- przepływ przechodzi test w środowisku testowym bramki, z danymi testowymi dostawcy,
- dziennik zdarzeń płatniczych pozwala odtworzyć sprawę zgłoszoną po miesiącu.
Wymagania zgodności zależą od wybranego modelu integracji i dostawcy. To nie jest porada prawna ani audyt zgodności.
Wybór bramki i zakres prac
Nie porównuję tu prowizji, bo stawki i warunki zależą od umowy oraz obrotu i się zmieniają. Przy wyborze patrzę na co innego: czy bramka obsługuje metody, których oczekują Twoi klienci, czy zwroty i płatności cykliczne są dostępne przez API, jak wygląda dokumentacja i środowisko testowe oraz czy obsługuje waluty, jeśli sprzedajesz za granicę.
W gotowym sklepie, na przykład na WooCommerce, bramkę często włącza się wtyczką, a własna integracja jest potrzebna przy nietypowym procesie lub własnej aplikacji. Podłączenie bramki wyceniam po rozmowie. Przekazanie statusu płatności do programu do faktur to osobny, typowy zakres, od około 800 zł netto, opisany na stronie automatyzacja fakturowania.
Najczęstsze pytania
Czy dane kart klientów będą przechodziły przez moją aplikację?
Nie powinny. Dane karty wpisuje się w oknie lub formularzu dostawcy bramki, a aplikacja dostaje tylko wynik transakcji i identyfikator. Dokładny sposób zależy od wybranego modelu integracji.
Skąd aplikacja wie, że płatność doszła?
Z potwierdzenia wysłanego przez bramkę na adres aplikacji i zweryfikowanego podpisem. Samo wejście klienta na stronę z podziękowaniem nie wystarcza, bo ten adres da się otworzyć ręcznie.
Czy mogę obsługiwać kilka bramek naraz?
Tak, jeśli klienci mają wybór metod. Każda bramka ma własny format potwierdzeń, więc aplikacja sprowadza je do jednego wewnętrznego statusu, a reszta procesu wygląda tak samo.
Kto odpowiada za zgodność z przepisami?
Regulamin, zgody i zasady zwrotów ustala firma, najlepiej z prawnikiem. To nie jest porada prawna. Ja dbam o to, żeby aplikacja stosowała te zasady konsekwentnie i zostawiała ślad zdarzeń.
Powiązane strony
Chcesz przyjmować płatności w swojej aplikacji?
Napisz, jakie metody płatności są potrzebne i jak dziś wygląda proces zamówienia. Odpowiem z propozycją.