Dyrektor e-commerce przynosi na spotkanie tabelkę: trzech operatorów płatności, trzy stawki prowizji. Najtańszy jest o 0,3 punktu procentowego niższy od obecnego, więc przy obrocie 2 milionów złotych miesięcznie oszczędność wynosi około 6 tysięcy złotych miesięcznie. Decyzja zapada w kwadrans. Pół roku później księgowość ręcznie uzgadnia wpłaty, bo raport rozliczeniowy nowego operatora podaje kwoty netto zbiorczo za dzień, bez identyfikatora zamówienia. Zespół wdrożeniowy łata podwójne zamówienia, które pojawiają się, gdy powiadomienie o płatności przychodzi dwa razy. Obsługa klienta nie umie zrobić częściowego zwrotu płatności BLIK z panelu. Oszczędność z tabelki nadal jest na papierze, ale nikt już nie wie, ile kosztowało jej uzyskanie.

Ten scenariusz jest ilustracyjny, ale jego elementy są typowe. Ten artykuł jest dla CTO i dyrektorów e-commerce, którzy wybierają operatora płatności dla sklepu internetowego, aplikacji SaaS albo platformy B2B i mają tę integrację zbudować lub przebudować. Teza jest taka: prowizja jest najmniej ważnym kryterium wyboru bramki płatności, o ile oferty mieszczą się w podobnym przedziale. O całkowitym koszcie płatności decydują trzy inne rzeczy: model integracji, który ustala zakres Twojej odpowiedzialności za bezpieczeństwo danych kart, jakość rozliczeń i zwrotów po stronie operatora oraz to, czy Twoja aplikacja traktuje asynchroniczne powiadomienia jako źródło prawdy. Drugą część tezy łatwiej podważyć: nie warto od startu budować obsługi kilku operatorów. Lepiej jeden operator i integracja zaprojektowana tak, by można go było wymienić.

Dlaczego porównanie bramek płatności po wysokości prowizji prowadzi do złego wyboru?

Bo prowizja jest jedyną liczbą, którą łatwo porównać, a nie jedyną, która ma znaczenie. Tabela z procentami nie pokazuje opłat stałych za transakcję, kosztu zwrotów i chargebacków, przewalutowania, terminu wypłaty środków ani tego, ile godzin miesięcznie zespół finansów poświęci na uzgadnianie wpłat. Nie pokazuje też kosztu, który pojawia się raz, ale jest duży: integracji, testów, zgodności z PCI DSS i ewentualnej migracji do innego operatora.

Porównaj dwie wielkości na przykładzie z wstępu. Różnica 0,3 punktu procentowego przy obrocie 2 milionów złotych miesięcznie to około 72 tysięcy złotych rocznie. To realne pieniądze. Ale jeśli raport rozliczeniowy nie pozwala na automatyczne uzgodnienie wpłat i księgowość poświęca na to połowę etatu, a zespół wdrożeniowy przez kwartał naprawia obsługę powiadomień, oszczędność łatwo topnieje. Jeszcze ważniejsze jest ryzyko, którego nie widać w kosztach miesięcznych: zamówienie wysłane bez zapłaty, zwrot zrobiony dwa razy, transakcje odrzucane przez bank wydawcy, bo integracja źle obsługuje silne uwierzytelnianie.

Prowizja ma znaczenie wtedy, gdy oferty różnią się znacząco albo gdy wolumen jest tak duży, że dziesiąte części punktu procentowego przekładają się na koszt zespołu. Wtedy warto negocjować i porównywać modele cenowe, o czym niżej. Ale kolejność decyzji powinna być odwrotna niż zwykle: najpierw ustal, którzy operatorzy spełniają wymagania funkcjonalne, prawne i integracyjne, a dopiero potem porównuj ich ceny na Twoim miksie transakcji.

Jest też argument strategiczny. Operator płatności nie jest dostawcą, którego zmienia się co roku. Jego identyfikatory transakcji trafiają do Twojej bazy danych, jego tokeny kart do profili klientów, jego raporty do systemu księgowego, a jego panel do codziennej pracy obsługi klienta. Im głębiej operator wrośnie w aplikację, tym droższa będzie jego zmiana. Wybór na podstawie samej prowizji to więc często wybór na lata, zrobiony na podstawie kryterium, które może się zmienić przy pierwszej renegocjacji cennika.

Kim są operatorzy płatności i czym różnią się ich modele działania?

W rozmowie o płatnościach te same słowa oznaczają różne rzeczy, więc warto je uporządkować. Bramka płatności w potocznym znaczeniu to usługa, która przyjmuje dane płatności od klienta i przekazuje je dalej do autoryzacji. Agent rozliczeniowy (acquirer) to podmiot, który ma umowę z organizacjami kartowymi i rozlicza transakcje kartowe na rzecz sprzedawcy. Operator płatności lub agregator w polskim e-commerce zwykle łączy obie role i dokłada do nich metody lokalne: BLIK, szybkie przelewy (pay-by-link), płatności odroczone. Na polskim rynku działają m.in. PayU, Przelewy24, Tpay, Autopay, PayPro czy usługi bankowe, a na rynku międzynarodowym m.in. Stripe, Adyen i PayPal.

Różnica między modelami ma konsekwencje praktyczne. W modelu agregatora sprzedawca podpisuje jedną umowę i dostaje wiele metod płatności przez jedno API, ale środki trafiają najpierw na rachunek operatora, który wypłaca je zgodnie z harmonogramem. W modelu bezpośredniego acquiringu sprzedawca ma osobną umowę z agentem rozliczeniowym, często lepszą cenę przy dużym wolumenie i większą kontrolę nad danymi transakcji, ale musi sam zebrać metody lokalne i zwykle przechodzi dłuższą weryfikację. Są też platformy dla marketplace’ów, które obsługują podział płatności między wielu sprzedawców i weryfikację tych sprzedawców.

Pierwsze pytanie przy każdym operatorze dotyczy jego statusu prawnego. Operator, który przyjmuje środki klientów i przekazuje je sprzedawcy, świadczy usługi płatnicze i potrzebuje zezwolenia, w Polsce zwykle jako krajowa instytucja płatnicza nadzorowana przez KNF, albo paszportu z innego państwa Unii. Status sprawdzisz w rejestrze usług płatniczych prowadzonym przez KNF albo w centralnym rejestrze Europejskiego Urzędu Nadzoru Bankowego. To nie formalność: od statusu operatora zależy ochrona środków klientów w razie jego problemów i to, z jakim nadzorem będziesz mieć do czynienia przy sporze.

Drugie pytanie dotyczy tego, czy Twoja firma sama nie staje się podmiotem świadczącym usługi płatnicze. Platforma, która przyjmuje pieniądze od kupujących i przekazuje je sprzedawcom, łatwo przekracza granicę między sprzedawcą a pośrednikiem. Jeśli budujesz marketplace albo aplikację, w której pieniądze przepływają między użytkownikami, ustal z prawnikiem model przepływu środków, zanim wybierzesz operatora, bo od tego zależy, jakiego produktu u niego potrzebujesz. Dla firm z sektora finansowego dochodzą wymagania nadzorcze wobec samego wyboru dostawcy, które opisaliśmy w artykule o tym, co DORA i PSD2 zmieniają w wyborze dostawcy oprogramowania dla finansów.

Jakie metody płatności musi obsłużyć aplikacja sprzedająca w Polsce?

Zacznij od danych o Twoich klientach, a nie od listy funkcji operatora. Ale jeśli sprzedajesz konsumentom w Polsce, jedna metoda jest obowiązkowa. Według raportu „10 lat BLIKNĘŁO”, przygotowanego przez EY dla Polskiego Standardu Płatności i opublikowanego w marcu 2025 roku, liczba aktywnych użytkowników BLIKA wyniosła na koniec 2024 roku 18,5 miliona, czyli 58 na 100 osób w wieku 15+, a liczba transakcji przekroczyła w 2024 roku 2,4 miliarda. Płatności BLIK w internecie osiągnęły w 2024 roku 173 miliardy złotych, a już w 2023 roku odpowiadały za około połowę wartości handlu internetowego w Polsce. Ten sam raport przywołuje badanie Gemiusa z 2024 roku, według którego BLIK jest najczęściej wybieraną formą płatności dla 51% kupujących online, a szybkie przelewy dla 22%. W sprzedaży B2B płatność często jest częścią portalu klienta B2B, gdzie obok kart dochodzą faktury i limity kupieckie.

Wniosek dla integracji: BLIK nie jest jedną z wielu ikon na stronie płatności, tylko główną ścieżką, która powinna działać najlepiej. Warto sprawdzić, czy operator pozwala wpisać kod BLIK bezpośrednio na stronie sklepu, bez przekierowania, jak obsługuje sytuację, w której klient nie potwierdzi płatności w aplikacji banku w wyznaczonym czasie, i czy obsługuje nowsze usługi. Raport wymienia dwie: BLIK Płacę Później, czyli płatność odroczoną do 30 dni dla zakupów do 4000 zł, oraz płatności powtarzalne BLIK, rozbudowane pod koniec 2024 roku, w których użytkownik ustala termin i kwotę regularnej płatności bez każdorazowej autoryzacji kodem. Dla aplikacji subskrypcyjnych ta druga funkcja zmienia rachunek: dotąd płatność cykliczna w Polsce oznaczała w praktyce kartę.

Druga grupa to szybkie przelewy z listą banków, nadal ważne dla części klientów i dla płatności o wyższej wartości. Trzecia to karty, w tym portfele Apple Pay i Google Pay, które dla klienta wyglądają jak osobna metoda, a technicznie są płatnością kartą z tokenem urządzenia. Karty są niezbędne, gdy sprzedajesz za granicę, gdy potrzebujesz płatności cyklicznych z kartą zapisaną w profilu klienta albo gdy klient płaci kartą firmową. Czwarta to płatności odroczone i raty, które warto rozważyć przy wyższej wartości koszyka. W sprzedaży B2B dochodzi często przelew tradycyjny z odroczonym terminem i faktura, które w ogóle nie przechodzą przez bramkę płatności, ale muszą trafić do tego samego modelu stanów zamówienia.

Jeśli sprzedajesz za granicę, lista się zmienia: w Holandii kluczowy jest iDEAL, w Belgii Bancontact, w wielu krajach polecenie zapłaty SEPA. Zanim więc porównasz operatorów, spisz metody, które są dla Ciebie konieczne, ważne i miłe do posiadania, z uzasadnieniem w danych. Zbyt długa lista metod na stronie płatności nie zwiększa konwersji automatycznie, za to zwiększa liczbę ścieżek do przetestowania i rodzajów zwrotów do obsłużenia.

Z czego naprawdę składa się koszt płatności i jak porównać oferty operatorów?

Koszt płatności to suma kilku opłat, z których prowizja procentowa jest tylko najbardziej widoczna. Przy kartach dochodzi do tego struktura, którą warto rozumieć, zanim zaczniesz negocjacje. Każda transakcja kartowa zawiera opłatę interchange płaconą bankowi wydawcy karty, opłatę schematu dla organizacji kartowej i marżę agenta rozliczeniowego lub operatora. Rozporządzenie (UE) 2015/751 ogranicza opłatę interchange dla konsumenckich kart debetowych do 0,2% wartości transakcji, a dla kart kredytowych do 0,3%. Limity nie obejmują kart firmowych ani kart wydanych poza Europejskim Obszarem Gospodarczym, dlatego udział takich kart w Twoim obrocie mocno wpływa na rzeczywisty koszt.

Stąd dwa modele cenowe. W modelu stawki łącznej (blended) operator podaje jedną stawkę dla wszystkich kart i bierze na siebie różnice między nimi. W modelu interchange++ płacisz rzeczywistą opłatę interchange, rzeczywistą opłatę schematu i osobno uzgodnioną marżę operatora. Stawka łączna jest prostsza do budżetowania, interchange++ jest przejrzystszy i przy dużym udziale tanich kart debetowych zwykle korzystniejszy. To samo rozporządzenie w art. 9 zobowiązuje agentów rozliczeniowych do podawania opłat oddzielnie dla różnych kategorii i marek kart, chyba że sprzedawca na piśmie poprosi o stawkę łączną, a w art. 12 do przekazywania po każdej transakcji informacji o opłacie dla sprzedawcy i opłacie interchange osobno. Masz więc prawo wiedzieć, za co płacisz.

Przy metodach lokalnych, takich jak BLIK czy szybkie przelewy, struktura jest prostsza, ale stawki bywają inne niż dla kart i różnią się między operatorami. Celowo nie podajemy tu stawek konkretnych operatorów: cenniki się zmieniają, a przy większym wolumenie stawki są negocjowane indywidualnie, więc publiczny cennik mówi niewiele o tym, ile zapłacisz Ty.

Składnik kosztuCo sprawdzić w ofercieKiedy ma największe znaczenie
Prowizja procentowaOsobno dla BLIK, przelewów, kart konsumenckich, firmowych i spoza EOGZawsze; najbardziej przy wysokiej średniej wartości koszyka
Opłata stała za transakcjęCzy dotyczy wszystkich metod, także zwrotówPrzy niskiej wartości koszyka i mikropłatnościach
Model cenowy kartStawka łączna czy interchange++, raportowanie zgodne z art. 9 i 12 rozporządzenia 2015/751Przy dużym udziale kart i wolumenie
ZwrotyOpłata za zwrot, zwrot prowizji od pierwotnej transakcji, zwroty częściowePrzy wysokim odsetku zwrotów (moda, elektronika)
ChargebackiOpłata za spór, narzędzia do odpowiedzi, progi programów monitorującychPrzy sprzedaży cyfrowej i towarach o wysokim ryzyku nadużyć
PrzewalutowanieMarża kursowa, waluty rozliczenia, rachunki walutowePrzy sprzedaży zagranicznej
Wypłata środkówTermin (dni robocze), opłata za wypłatę, minimalna kwota, rezerwaPrzy napiętym kapitale obrotowym
Opłaty stałeAbonament, minimum miesięczne, opłata za uruchomieniePrzy małym lub sezonowym obrocie
Koszt po Twojej stronieUzgadnianie wpłat, obsługa sporów, utrzymanie integracjiZawsze; najczęściej pomijany

Jak porównać oferty uczciwie? Weź swój rzeczywisty miks transakcji z ostatnich 6–12 miesięcy: liczbę i wartość płatności dla każdej metody, udział kart zagranicznych i firmowych, liczbę zwrotów i sporów. Poproś każdego operatora o wycenę na tych danych, a nie na przykładzie z cennika. Dla nowej aplikacji bez historii zbuduj trzy scenariusze wolumenu i sprawdź, jak zmienia się koszt w każdym z nich. Dopiero wtedy różnice między ofertami stają się porównywalne i widać, czy oszczędność na prowizji nie jest zjadana przez opłatę stałą albo przewalutowanie.

Jak rozliczenia i raporty operatora wpływają na pracę finansów?

To kryterium, o którym CTO dowiaduje się zwykle od dyrektora finansowego, i to za późno. Operator przyjmuje płatności przez cały dzień, ale wypłaca je na Twój rachunek zbiorczo, po potrąceniu prowizji, zwrotów i ewentualnych chargebacków. Księgowość musi wtedy odpowiedzieć na pytanie, które zamówienia składają się na przelew, który właśnie wpłynął. Jeśli raport rozliczeniowy operatora tego nie mówi, ktoś odpowiada na to pytanie ręcznie.

Dlatego przed wyborem operatora poproś o przykładowe pliki rozliczeniowe i sprawdź w nich kilka rzeczy. Czy każda pozycja zawiera Twój identyfikator zamówienia, a nie tylko identyfikator operatora? Czy raport pokazuje kwotę brutto, prowizję i kwotę netto osobno dla każdej transakcji? Czy zwroty i chargebacki są widoczne jako osobne pozycje z odniesieniem do pierwotnej płatności? Czy jest identyfikator wypłaty, który łączy raport z przelewem na wyciągu bankowym? Czy raport jest dostępny przez API, czy tylko do pobrania z panelu? Odpowiedzi na te pytania decydują, czy uzgadnianie wpłat da się zautomatyzować.

Drugi temat to termin wypłaty. Różnica między wypłatą następnego dnia roboczego a wypłatą tygodniową to kapitał obrotowy, który przy dużym obrocie ma swoją cenę. Część operatorów może też zatrzymywać rezerwę, czyli część środków na poczet przyszłych zwrotów i sporów, szczególnie u nowych sprzedawców lub w branżach o podwyższonym ryzyku. Zapytaj o to wprost i zapisz warunki w umowie.

Trzeci temat to integracja z systemem księgowym lub ERP. Aplikacja powinna zapisywać dane płatności tak, żeby system finansowy mógł je uzgodnić bez udziału zespołu deweloperskiego: identyfikator transakcji operatora, metodę płatności, kwoty, walutę, datę rozliczenia, identyfikator wypłaty. Jeśli budujesz produkt SaaS z abonamentami, dochodzi do tego logika rozliczeń, faktur i niezapłaconych odnowień, którą opisaliśmy w artykule o decyzjach architektonicznych w budowie produktu SaaS. Tam też widać, dlaczego billing i bramka płatności to dwie różne warstwy, które łatwo pomylić.

Jak obsłużyć zwroty i chargebacki, żeby nie tracić pieniędzy?

Zwroty są częścią sprzedaży, a nie wyjątkiem. Przy sprzedaży konsumentom w Polsce ustawa o prawach konsumenta, wdrażająca dyrektywę 2011/83/UE, wymaga zwrotu płatności w ciągu 14 dni od odstąpienia od umowy, przy użyciu takiego samego sposobu zapłaty, jakiego użył konsument, chyba że zgodził się on na inny sposób. Dla integracji oznacza to, że zwrot musi dać się wykonać przez API operatora dla każdej obsługiwanej metody, także częściowo, gdy klient zwraca jeden produkt z trzech.

Przy wyborze operatora sprawdź, jak zwroty wyglądają dla każdej metody. Czy zwrot BLIK i zwrot szybkiego przelewu działają tak samo jak zwrot karty? Czy można zrobić kilka zwrotów częściowych do jednej płatności? Ile czasu po transakcji można jeszcze zrobić zwrot przez API? Co się dzieje, gdy saldo u operatora jest niższe niż kwota zwrotu? Czy zwrot generuje powiadomienie, które aplikacja może przetworzyć tak samo jak płatność? Każde „nie” w tych odpowiedziach oznacza ręczną pracę obsługi klienta albo przelew wykonywany poza systemem.

Chargeback, czyli obciążenie zwrotne, to inny mechanizm: klient kwestionuje transakcję u wydawcy karty, a środki są cofane z rachunku sprzedawcy, zanim spór zostanie rozstrzygnięty. Sprzedawca może przedstawić dowody, ale musi zrobić to w terminie i w formacie wymaganym przez operatora. Sprawdź, czy operator informuje o sporach przez API lub powiadomienia, czy pozwala przesłać dowody elektronicznie i ile kosztuje każdy spór, niezależnie od wyniku. Przy sprzedaży cyfrowej, gdzie nie ma potwierdzenia doręczenia przesyłki, warto od początku zapisywać dowody wykonania usługi: logi dostępu, adres IP, czas aktywacji.

Najczęstszy błąd w integracji zwrotów to dwa źródła prawdy. Obsługa klienta robi zwrot w panelu operatora, a aplikacja o nim nie wie, więc zamówienie dalej wygląda na opłacone, a raport sprzedaży jest zawyżony. Zasada jest prosta: zwroty inicjuje aplikacja, a jeśli z jakiegoś powodu zostaną zrobione w panelu, aplikacja musi się o nich dowiedzieć z powiadomienia operatora i odnotować je w swoim modelu stanów.

Co PSD2 i silne uwierzytelnianie klienta zmieniają w ścieżce płatności?

Dyrektywa PSD2 wprowadziła obowiązek silnego uwierzytelniania klienta, a szczegóły określa rozporządzenie delegowane (UE) 2018/389, stosowane od 14 września 2019 roku. Dla płatności kartą w internecie oznacza to w praktyce protokół 3D Secure w wersji 2, w którym bank wydawcy może poprosić klienta o potwierdzenie płatności w aplikacji. Dla BLIK potwierdzenie w aplikacji banku jest wbudowane w samą metodę, więc wymaganie jest spełnione z natury.

Ważne są wyłączenia, bo od nich zależy, ile transakcji przejdzie bez dodatkowego kroku. Rozporządzenie pozwala dostawcy usług płatniczych nie stosować silnego uwierzytelniania m.in. dla płatności zdalnych do 30 euro, dopóki łączna kwota od ostatniego uwierzytelnienia nie przekroczy 100 euro albo liczba takich płatności nie przekroczy pięciu (art. 16), dla kolejnych płatności z serii płatności cyklicznych o tej samej kwocie i dla tego samego odbiorcy (art. 14), dla odbiorców z listy zaufanych (art. 13) oraz dla transakcji niskiego ryzyka według analizy ryzyka prowadzonej w czasie rzeczywistym (art. 18). To ostatnie wyłączenie zależy od wskaźnika oszustw dostawcy: dla płatności kartą do 500 euro wskaźnik referencyjny wynosi 0,01%, do 250 euro 0,06%, a do 100 euro 0,13%.

Co z tego wynika dla wyboru operatora? Po pierwsze, warto zapytać, czy i w jakim zakresie operator wnioskuje o wyłączenia w imieniu sprzedawcy i jak raportuje odsetek transakcji uwierzytelnionych, wyłączonych i odrzuconych. Po drugie, płatności cykliczne i płatności inicjowane przez sprzedawcę, na przykład odnowienie abonamentu kartą zapisaną w profilu klienta, wymagają poprawnego oznaczenia pierwszej transakcji i kolejnych. Błąd w tym oznaczeniu objawia się odrzuceniami odnowień, które trudno zdiagnozować. Po trzecie, nawet gdy sklep wnioskuje o wyłączenie, bank wydawcy może zażądać uwierzytelnienia, więc ścieżka płatności musi zawsze obsłużyć ten krok, także w aplikacji mobilnej.

Warto też pamiętać, że zasady się zmieniają. Unia pracuje nad pakietem PSD3 i rozporządzeniem w sprawie usług płatniczych, które mają zmienić część reguł, m.in. dotyczących uwierzytelniania i ochrony przed oszustwami. Zanim podpiszesz wieloletnią umowę, zapytaj operatora, jak zamierza wdrażać nowe wymagania i kto poniesie koszt zmian po Twojej stronie integracji.

Przekierowanie, iframe czy własny formularz: jak model integracji ustala zakres PCI DSS?

To najważniejsza decyzja techniczna przy płatnościach kartą i ta, która najbardziej wpływa na koszt w długim okresie. Standard PCI DSS obowiązuje każdego, kto przyjmuje płatności kartą, ale zakres obowiązków zależy od tego, czy dane kart w ogóle dotykają Twojego systemu. Obecną wersją jest PCI DSS 4.0.1, opublikowana w czerwcu 2024 roku. Wersja 4.0 została wycofana 31 grudnia 2024 roku, a wymagania oznaczone jako przyszłe stały się obowiązkowe 31 marca 2025 roku.

W praktyce są trzy modele. Przekierowanie na stronę płatności operatora albo formularz w iframe dostarczany w całości przez operatora oznacza, że dane karty trafiają bezpośrednio do operatora. Sprzedawca, który w pełni powierzył przetwarzanie danych kart podmiotom zgodnym z PCI DSS, zwykle kwalifikuje się do najkrótszego kwestionariusza samooceny, SAQ A. Formularz osadzony na Twojej stronie, ale generowany przez Twój kod lub przesyłający dane bezpośrednio do operatora z przeglądarki, to zwykle SAQ A-EP, bo Twoja strona wpływa na bezpieczeństwo transakcji, choć danych nie przechowuje. Dane karty przechodzące przez Twój serwer to pełny zakres wymagań i model, którego większość firm powinna unikać.

Wersja 4.0 dodała dwa wymagania, które dotyczą właśnie strony płatności: 6.4.3 o inwentaryzacji, autoryzacji i kontroli integralności skryptów na stronie płatności oraz 11.6.1 o wykrywaniu nieautoryzowanych zmian tej strony. Odpowiadają one na ataki, w których złośliwy skrypt wstrzyknięty do sklepu przechwytuje dane kart. W styczniu 2025 roku Rada PCI SSC zaktualizowała kwestionariusz SAQ A: usunęła z niego wymagania 6.4.3, 11.6.1 i 12.3.1, ale dodała kryterium kwalifikacji, zgodnie z którym sprzedawca musi potwierdzić, że jego strona nie jest podatna na ataki skryptów mogące wpłynąć na jego system e-commerce. Nowa wersja SAQ A obowiązuje od 31 marca 2025 roku. Sprzedawca, który tego kryterium nie spełni, przechodzi na SAQ A-EP, który według analizy firmy audytorskiej usd AG zawiera ponad sto dodatkowych wymagań.

Wniosek jest mniej oczywisty, niż się wydaje: przekierowanie lub iframe operatora nie kończą tematu bezpieczeństwa, tylko przesuwają go ze zgodności formalnej na higienę strony. Nadal musisz kontrolować, jakie skrypty zewnętrzne ładuje Twoja strona, jak chronisz konto administratora sklepu i czy ktoś może podmienić adres przekierowania. Pomaga w tym nagłówek Content Security Policy, kontrola integralności zasobów i regularny przegląd zależności frontendowych, a punktem wyjścia jest lista OWASP Top 10. Ale różnica w koszcie między SAQ A a SAQ A-EP czy pełnym zakresem jest na tyle duża, że model integracji powinien wynikać z tej analizy, a nie z preferencji projektanta interfejsu, który chce, żeby formularz karty wyglądał jak reszta strony. Większość operatorów oferuje dziś pola formularza osadzane w iframe, które można dopasować wizualnie, więc rzadko trzeba wybierać między wyglądem a zakresem odpowiedzialności.

Dlaczego to webhook, a nie powrót klienta, jest źródłem prawdy o płatności?

Bo powrót klienta ze strony operatora jest zdarzeniem w przeglądarce, a nie potwierdzeniem płatności. Klient może zamknąć kartę po potwierdzeniu płatności w aplikacji banku, stracić zasięg w tramwaju, wrócić do sklepu przez inną przeglądarkę albo trafić na adres powrotu, zanim bank potwierdzi przelew. Integracja, która oznacza zamówienie jako opłacone na podstawie parametrów w adresie powrotu, prędzej czy później wyśle towar bez zapłaty albo pokaże klientowi błąd mimo pobrania pieniędzy.

Źródłem prawdy jest powiadomienie serwer–serwer od operatora, czyli webhook, albo odpytanie API operatora o status transakcji. Ten mechanizm ma jednak swoje właściwości, które trzeba znać. Dokumentacja Stripe opisuje je wprost i dobrze ilustruje to, co dotyczy większości operatorów. Powiadomienia są ponawiane, jeśli Twój serwer nie odpowie kodem 2xx; w trybie produkcyjnym Stripe próbuje je dostarczyć przez maksymalnie trzy dni z wydłużającymi się odstępami. To samo zdarzenie może przyjść więcej niż raz. Kolejność dostarczania nie jest gwarantowana, więc informacja o zwrocie może dotrzeć przed informacją o płatności. Serwer powinien szybko odpowiedzieć kodem 2xx, a właściwe przetwarzanie wykonać asynchronicznie, bo długa obsługa kończy się przekroczeniem czasu i ponowieniem.

Z tego wynikają cztery reguły dla integracji. Weryfikuj podpis każdego powiadomienia kluczem operatora, na surowej treści żądania, i odrzucaj powiadomienia ze zbyt starym znacznikiem czasu, żeby zapobiec ich ponownemu odtworzeniu przez atakującego. Bez weryfikacji każdy, kto zna adres Twojego punktu odbioru, może „opłacić” zamówienie. Zapisuj identyfikatory przetworzonych zdarzeń i ignoruj te, które już widziałeś. Nie zakładaj kolejności: przy każdym zdarzeniu sprawdź, czy przejście stanu ma sens, a w razie wątpliwości pobierz aktualny stan transakcji z API operatora. Kolejkuj przetwarzanie: punkt odbioru zapisuje zdarzenie i odpowiada, a logika biznesowa działa w osobnym procesie, który można ponowić.

Do tego potrzebny jest mechanizm, który łapie to, co umknęło. Okresowe zadanie porównujące stan zamówień oczekujących na płatność ze stanem u operatora wychwytuje powiadomienia, które nie dotarły, i transakcje, które utknęły. Dzienne uzgodnienie z raportem rozliczeniowym zamyka pętlę po stronie finansów. To są elementy, które zwykle nie trafiają do pierwszej wyceny integracji, a potem są dobudowywane w pośpiechu, gdy pojawiają się pierwsze rozbieżności. Szerzej o tym, jak dobierać wzorce komunikacji między systemami, piszemy w artykule o wzorcach integracji oprogramowania, a o zabezpieczaniu punktów końcowych w tekście o bezpieczeństwie API.

Jak zaprojektować idempotencję i model stanów płatności?

Idempotencja oznacza, że powtórzenie tej samej operacji daje ten sam efekt co jej jednokrotne wykonanie. W płatnościach ma ona dwie strony. Pierwsza dotyczy żądań, które Twoja aplikacja wysyła do operatora. Jeśli żądanie utworzenia płatności lub zwrotu zakończy się błędem sieci, nie wiesz, czy operator je wykonał. Bez idempotencji ponowienie może utworzyć drugą płatność albo drugi zwrot. Dlatego operatorzy obsługują klucze idempotencji: aplikacja generuje unikalny klucz dla operacji i wysyła go z żądaniem, a operator przy ponowieniu z tym samym kluczem zwraca wynik pierwszego żądania. Stripe opisuje klucze o długości do 255 znaków, zaleca losowe identyfikatory typu UUID v4, porównuje parametry ponowionego żądania z oryginałem i zwraca błąd, gdy się różnią, a klucze mogą być usuwane po co najmniej 24 godzinach. Sprawdź, jak ten mechanizm wygląda u Twojego operatora, i dla każdej operacji zmieniającej stan (płatność, przechwycenie autoryzacji, zwrot) używaj klucza powiązanego z Twoim identyfikatorem operacji.

Druga strona to obsługa powiadomień, o której była mowa wyżej. Tu idempotencję zapewnia Twoja aplikacja: zapisuje identyfikator zdarzenia w tej samej transakcji bazodanowej co zmianę stanu zamówienia, więc ponowne zdarzenie nie zmieni niczego drugi raz.

Fundamentem obu jest własny model stanów płatności, niezależny od operatora. Płatność w Twojej aplikacji przechodzi przez jasno zdefiniowane stany: utworzona, oczekująca na klienta, autoryzowana, przechwycona, nieudana, anulowana, zwrócona częściowo, zwrócona w całości, sporna. Każde zdarzenie od operatora jest tłumaczone na przejście w tym modelu, a niedozwolone przejścia są odrzucane i logowane. Model ten trzyma też powiązanie między Twoim zamówieniem a identyfikatorami operatora, co ułatwia uzgadnianie i ewentualną migrację.

Dlaczego to takie ważne? Bo bez własnego modelu stanów logika płatności rozlewa się po aplikacji w postaci warunków typu „jeśli status od operatora to X”. Każdy operator ma inne statusy i inną semantykę, więc zmiana operatora oznacza przegląd całego kodu, który na nie patrzy. Z własnym modelem zmiana dotyczy jednego adaptera, który tłumaczy statusy operatora na Twoje stany. Testy tej warstwy warto zautomatyzować na środowisku testowym operatora, łącznie ze scenariuszami brzegowymi: powtórzonym powiadomieniem, powiadomieniem w złej kolejności, przekroczeniem czasu żądania i odrzuceniem przez bank. Jak budować takie testy, pokazujemy w artykule o testowaniu API.

Jak przygotować integrację na zmianę operatora i czy warto mieć dwóch od startu?

Operatorów zmienia się z kilku powodów: wolumen urósł i lepszą cenę daje bezpośredni acquiring, firma wchodzi na nowy rynek, operator zmienił warunki, jakość obsługi spadła. W każdym z tych przypadków koszt zmiany zależy od tego, jak zbudowano integrację. Dlatego pytanie o zmianę operatora warto zadać przed wyborem pierwszego.

Trzy elementy decydują o tym koszcie. Pierwszy to wspomniany model stanów i adapter, który izoluje resztę aplikacji od API operatora. Drugi to dane kart zapisanych w profilach klientów. Jeśli sprzedajesz abonamenty kartą, tokeny kart należą do operatora i bez ich przeniesienia każdy klient musiałby podać kartę ponownie. Zapytaj przed podpisaniem umowy, czy operator umożliwia eksport danych kart do innego podmiotu zgodnego z PCI DSS w razie zakończenia współpracy, na jakich warunkach i w jakim czasie, i zapisz to w umowie. Trzeci to historia transakcji: identyfikatory, raporty, spory, które muszą pozostać dostępne po zmianie, choćby na potrzeby zwrotów do transakcji sprzed migracji.

Czy w takim razie warto od początku podłączyć dwóch operatorów albo platformę orkiestracji płatności, która przełącza ruch między nimi? Dla dużych sprzedawców, sprzedaży w wielu krajach i firm, dla których godzina niedostępności płatności oznacza duże straty, odpowiedź może brzmieć „tak”. Dla większości sklepów i aplikacji na starcie odpowiedź brzmi „nie”. Drugi operator podwaja testy, konfigurację metod, obsługę zwrotów, uzgadnianie wpłat i rozmowy o sporach, a jego korzyść, czyli lepsza cena lub odporność na awarię, pojawia się dopiero przy wolumenie, którego nowa aplikacja jeszcze nie ma. Taniej jest zbudować integrację gotową na drugiego operatora niż utrzymywać dwóch od pierwszego dnia.

Jest też kwestia platformy sklepowej. Jeśli sklep działa na platformie SaaS, lista operatorów może być ograniczona do tych, którzy mają gotową wtyczkę, a część logiki płatności jest po stronie platformy. Jeśli budujesz rozwiązanie własne lub headless, masz pełną swobodę, ale też pełną odpowiedzialność za opisane tu elementy. Te kompromisy opisaliśmy szerzej w porównaniu platformy SaaS, headless i sklepu szytego na miarę.

Jak przeprowadzić wybór operatora płatności krok po kroku?

Proces wyboru zajmuje zwykle kilka tygodni i warto go zaplanować tak, żeby zespół techniczny i finansowy pracowały równolegle. Poniższa kolejność sprawdza się, bo eliminuje operatorów na kryteriach koniecznych, zanim zacznie się rozmowa o cenie.

Krok 1: wymagania. Spisz metody płatności (konieczne, ważne, opcjonalne), rynki i waluty, model biznesowy (sprzedaż jednorazowa, abonamenty, marketplace), oczekiwany wolumen w trzech scenariuszach i wymagania regulacyjne. Na tym etapie ustal z prawnikiem model przepływu środków.

Krok 2: lista krótka. Wybierz trzech, czterech operatorów, którzy spełniają wymagania konieczne, mają odpowiednie zezwolenia i obsługują Twoją platformę lub stos technologiczny. Sprawdź status w rejestrach KNF lub EBA.

Krok 3: ocena techniczna. Zespół przegląda dokumentację API, środowisko testowe, mechanizm powiadomień (podpisy, ponowienia, kolejność), klucze idempotencji, obsługę zwrotów przez API, biblioteki klienckie i stronę statusu. Dobrze jest zbudować prototyp najważniejszej ścieżki, na przykład płatności BLIK i zwrotu częściowego, na środowisku testowym każdego operatora z listy krótkiej. Dwa, trzy dni pracy na operatora mówią więcej niż prezentacja handlowa.

Krok 4: ocena finansowa i operacyjna. Finanse przeglądają przykładowe raporty rozliczeniowe, terminy wypłat, warunki rezerw i wyceny na Twoim miksie transakcji. Obsługa klienta sprawdza panel: wyszukiwanie transakcji, zwroty, obsługę sporów.

Krok 5: umowa. Negocjuj cenę, ale też warunki wyjścia: okres wypowiedzenia, eksport danych kart i historii transakcji, poziom dostępności z konsekwencjami, sposób informowania o zmianach cennika i API.

KryteriumWaga (przykład)Jak sprawdzić
Metody płatności i rynki20%Lista metod koniecznych, test BLIK i kart na środowisku testowym
Model integracji i zakres PCI DSS15%Czy operator oferuje przekierowanie i pola w iframe; jaki SAQ wynika z wybranego modelu
Jakość API i powiadomień20%Prototyp: podpisy, ponowienia, idempotencja, zwroty częściowe przez API
Rozliczenia i raporty15%Przykładowe pliki: identyfikator zamówienia, brutto/netto, identyfikator wypłaty, API raportów
Całkowity koszt na Twoim miksie15%Wycena na danych z 6–12 miesięcy lub trzech scenariuszach
Warunki wyjścia i umowa10%Eksport tokenów kart, okres wypowiedzenia, historia transakcji
Status prawny i wsparcie5%Rejestr KNF/EBA, kanały wsparcia technicznego, strona statusu

Wagi są przykładowe i powinny odpowiadać Twojej sytuacji. Sklep z dużym udziałem zwrotów podniesie wagę zwrotów i raportów, aplikacja subskrypcyjna wagę płatności cyklicznych i warunków wyjścia, marketplace wagę podziału płatności. Zwróć uwagę, że całkowity koszt ma w tym przykładzie wagę 15%, a nie 60%. To konsekwencja tezy tego artykułu: oferty, które przeszły wcześniejsze kroki, zwykle różnią się ceną mniej niż jakością integracji.

Ile kosztuje i ile trwa integracja płatności w aplikacji?

Uczciwa odpowiedź zależy od zakresu, więc zamiast jednej liczby lepiej pokazać, co składa się na pracę. Integracja jednego operatora z przekierowaniem i jedną metodą płatności, bez zwrotów przez API i bez uzgadniania, jest stosunkowo prosta i często mieści się w kilku tygodniach pracy jednej, dwóch osób. Integracja produkcyjna, o której mówi ten artykuł, obejmuje więcej: model stanów płatności, obsługę powiadomień z weryfikacją podpisu i kolejką, idempotencję, zwroty pełne i częściowe, obsługę sporów, zadanie uzgadniające, eksport danych do systemu finansowego, płatności cykliczne, jeśli są potrzebne, testy scenariuszy brzegowych i monitoring.

Szacunek najlepiej przygotować oddolnie, z listy tych elementów, po krótkiej fazie analizy, w której zespół pozna API wybranego operatora i Twój system zamówień. Przykład ilustracyjny, a nie oferta: jeśli integracja wymaga zespołu dwóch doświadczonych programistów i testera przez dwa, trzy miesiące, to przy stawkach seniorskich z benchmarku ARDURA, czyli 180–260 zł netto za godzinę, i 160 godzinach w miesiącu koszt pracy zespołu wyniesie od około 173 tysięcy złotych (dwa miesiące, dolna granica stawek) do około 374 tysięcy złotych netto (trzy miesiące, górna granica). Zespół z osobami na poziomie mid będzie tańszy, ale zwykle potrzebuje więcej czasu na scenariusze brzegowe. Dla porównania strona usług tworzenia oprogramowania na zamówienie ARDURA podaje, że typowy trzyosobowy zespół, czyli dwóch programistów i tester, kosztuje około 62 000–123 000 zł miesięcznie.

Na koszt najbardziej wpływają cztery czynniki. Pierwszy to stan systemu zamówień: jeśli zamówienie nie ma jasnego modelu stanów, integracja płatności wymusi jego uporządkowanie. Drugi to liczba metod i rynków. Trzeci to płatności cykliczne, które dokładają zarządzanie kartami zapisanymi, ponawianie nieudanych odnowień i oznaczanie transakcji inicjowanych przez sprzedawcę. Czwarty to wymagania finansów co do uzgadniania i raportowania. Te cztery pytania warto zadać, zanim ktokolwiek poda termin.

Jakie są kluczowe wnioski przed podpisaniem umowy z operatorem płatności?

Wybór bramki płatności wygląda jak decyzja zakupowa, a jest w dużej części decyzją architektoniczną. Prowizja jest ważna, ale łatwo ją porównać i łatwo renegocjować. Trudniej zmienić model integracji, raporty rozliczeniowe i sposób, w jaki aplikacja obsługuje asynchroniczne powiadomienia, bo te elementy wrastają w system na lata.

Zapamiętaj sześć rzeczy. Po pierwsze, najpierw kryteria konieczne, potem cena: metody płatności, rynki, status prawny operatora i jakość API eliminują więcej ofert niż prowizja. Po drugie, w Polsce BLIK jest główną ścieżką płatności w e-commerce i powinien działać najlepiej, łącznie ze zwrotami i, w aplikacjach abonamentowych, płatnościami powtarzalnymi. Po trzecie, porównuj koszt na swoim miksie transakcji, ze wszystkimi opłatami, i korzystaj z prawa do informacji o opłatach wynikającego z rozporządzenia 2015/751. Po czwarte, wybierz model integracji, który minimalizuje zakres PCI DSS, i pamiętaj, że nawet przy SAQ A musisz potwierdzić odporność strony na ataki skryptów. Po piąte, traktuj webhook jako źródło prawdy, weryfikuj podpisy, zapewnij idempotencję i dobuduj zadanie uzgadniające. Po szóste, zbuduj własny model stanów płatności i adapter operatora, a warunki wyjścia, w tym eksport tokenów kart, zapisz w umowie, zanim ją podpiszesz.

Jeśli planujesz integrację płatności w nowej aplikacji albo przebudowę istniejącej, możemy pomóc przejść przez ocenę techniczną operatorów, zaprojektować model stanów i zbudować integrację. Zobacz, jak pracujemy w tworzeniu oprogramowania na zamówienie, lub umów rozmowę. Pracę zaczynamy od fazy discovery, która trwa 1–2 tygodnie i kończy się zakresem, architekturą i szacunkiem, który możesz porównać z ofertami.