Czym jest bramka płatnicza? Jak działają płatności online, wyjaśnione

Bramka płatnicza to usługa, która bezpiecznie przejmuje dane płatnicze klienta przy checkoutcie, przekazuje je do banków i sieci kartowych w celu autoryzacji i odsyła odpowiedź „zatwierdzono” albo „odrzucono” — zwykle w ciągu kilku sekund. To pomost między Twoją aplikacją a systemem finansowym. Stripe, PayPal, Adyen, Square i Braintree to znane przykłady.

Dziś większość tych firm łączy bramkę ze wszystkim, czego potrzebujesz, żeby otrzymać pieniądze, więc „bramka płatnicza”, „procesor płatności” i „dostawca płatności” często znaczą to samo.

Dlaczego bramki płatnicze mają znaczenie, gdy budujesz z AI

„Dodaj płatności” to jedna z najczęstszych próśb kierowanych do kreatorów AI i jedna z najłatwiejszych do subtelnego zepsucia. Sam kod jest zwykle krótki. Ważne są decyzje wokół niego:

• Który dostawca pasuje do Twojej firmy, kraju i tego, co sprzedajesz.
• Gdzie działa kod. Sekretne klucze płatnicze muszą pozostać na serwerze, nigdy w przeglądarce.
• Jak aplikacja dowiaduje się, że płatność się udała. Niezawodnym sposobem jest webhook od dostawcy — a nie klient trafiający na stronę „dziękujemy”.
• Twoje obowiązki prawne i podatkowe, które zależą od tego, kto jest merchant of record.

Zrozumienie, co robi bramka, pomaga dawać jasne instrukcje i sprawdzić, czy wynik jest bezpieczny.

Codzienna analogia

Pomyśl o płaceniu kartą w sklepie.

Terminal płatniczy na ladzie to bramka: bezpiecznie odczytuje Twoją kartę i wysyła żądanie dalej. Sam niczego nie decyduje — przekazuje pytanie „czy ta osoba może zapłacić 40 €?” w łańcuch do Twojego banku i odbiera odpowiedź. Bank sklepu (acquirer) i Twój bank (issuer) podejmują decyzję przez sieć kartową (Visa, Mastercard), która je łączy.

Bramka internetowa to ten terminal, przebudowany dla sieci — plus zabezpieczenia do obsługi danych kart przesyłanych przez internet.

Jak działa płatność kartą online

Oto, co dzieje się w kilka sekund po tym, jak klient kliknie „Zapłać”:

Warto znać dwa punkty:

• Autoryzacja to nie to samo co otrzymanie pieniędzy. Najpierw kwota jest rezerwowana, potem pobierana, a na końcu rozliczana na Twoje konto — często po kilku dniach.
• Twoja aplikacja nigdy nie powinna widzieć numeru karty. Nowocześni dostawcy dają hostowaną stronę checkoutu lub wbudowane pola kontrolowane przez siebie, a Twoja aplikacja dostaje tylko odniesienie do płatności.

Główne elementy i kto się nimi zajmuje

Niektórzy dostawcy (Paddle, Lemon Squeezy) sami działają jako merchant of record, obsługując za Ciebie podatek VAT i sprzedażowy w zamian za wyższe prowizje. Inni (Stripe, PayPal) zostawiają Cię jako merchant of record, z opcjonalnymi narzędziami podatkowymi. Rzetelne porównanie opcji znajdziesz w Stripe kontra Paddle kontra Lemon Squeezy i Stripe kontra PayPal.

Przykład krok po kroku: sprzedaż kursu

Sprzedajesz kurs online za 99 € i prosisz kreatora AI o dodanie przycisku „Kup”.

1. Klient klika Kup. Twój serwer, używając sekretnego klucza, prosi dostawcę o utworzenie sesji checkoutu na 99 € i dostaje link.
2. Klient zostaje przekierowany na hostowaną stronę checkoutu dostawcy, wpisuje kartę i przechodzi ewentualną weryfikację 3D Secure ze swoim bankiem.
3. Płatność zostaje zatwierdzona, a klient trafia na Twoją stronę „sukces”.
4. Osobno dostawca wysyła webhook na Twój serwer: „płatność za sesję X zakończyła się sukcesem”. Serwer sprawdza podpis webhooka, znajduje zamówienie, oznacza je jako opłacone i odblokowuje kurs.
5. Kilka dni później pieniądze pomniejszone o opłaty trafiają na Twoje konto.

Krok 4 jest najważniejszy. Gdybyś odblokował kurs na stronie „sukces”, każdy, kto znalazłby ten adres URL, dostałby go za darmo, a klienci, których przeglądarka zamknęła się wcześniej, zapłaciliby i nic by nie dostali.

Kluczowe pojęcia

Częste nieporozumienia

• „Muszę przechowywać numery kart, żeby obciążać klientów ponownie”. Nie. Dostawcy przechowują kartę i dają Ci token-odniesienie do powtarzalnych płatności i subskrypcji. Nigdy nie powinieneś sam przechowywać numerów kart.
• „Strona sukcesu oznacza, że płatność się udała”. Potwierdzaj płatności webhookami na serwerze. Przekierowania można pominąć, sfałszować albo one nigdy nie nastąpią.
• „Wszyscy dostawcy płatności kosztują mniej więcej tyle samo”. Opłaty różnią się w zależności od dostawcy, kraju, rodzaju karty i tego, czy obsługa podatków jest wliczona. Sprawdź aktualny cennik swojego kraju u każdego dostawcy.
• „Używanie Stripe czyni mnie zgodnym z PCI”. Znacznie to upraszcza, bo dane kart zostają u dostawcy — ale nadal masz do wypełnienia (zwykle krótką) samoocenę.
• „Tryb testowy i produkcyjny działają identycznie”. Są bardzo podobne, ale tryb produkcyjny wymaga w pełni zweryfikowanego konta, prawdziwych endpointów webhooków ustawionych dla środowiska produkcyjnego i prawdziwych danych bankowych.
• „Bramka płatnicza załatwia moje podatki”. Tylko wtedy, gdy jest merchant of record albo włączysz i skonfigurujesz jej narzędzia podatkowe. Sprawdź lokalne przepisy lub zapytaj doradcę.

O co zapytać kreatora AI

• „Dodaj [Stripe] Checkout dla [produktu]. Utwórz sesję na serwerze, używając sekretnego klucza z zmiennej środowiskowej.”
• „Oznaczaj zamówienia jako opłacone tylko z zweryfikowanego webhooka i sprawdzaj podpis webhooka.”
• „Obsłuż sytuację, w której webhook przychodzi dwa razy, bez tworzenia zduplikowanych zamówień.”
• „Używaj kluczy z trybu testowego i przeprowadź mnie przez testy kartami testowymi dostawcy, także kartą odrzuconą.”
• „Co się stanie, jeśli klient zamknie kartę po zapłaceniu?”
• „Pokaż każde miejsce, w którym używany jest klucz płatniczy, i potwierdź, że klucz sekretny nigdy nie trafia do przeglądarki.”

Bramki płatnicze w Mythex

Mythex nie zawiera wbudowanych płatności dla budowanych aplikacji i nie ma przycisku „Połącz Stripe” jednym kliknięciem. Zakładasz konto u wybranego dostawcy, dodajesz jego klucze testowe jako sekrety projektu i prosisz agenta o zbudowanie checkoutu po stronie serwera. Testujesz w Podglądzie kartami testowymi dostawcy, a potem publikujesz. Dokumentacja opisuje to w Przyjmowanie płatności przez Stripe, a Webhooki omawiają krok potwierdzania.

Jeśli chcesz instrukcji krok po kroku, zobacz jak dodać płatności do swojej aplikacji, a w sprawie płatności cyklicznych jak dodać subskrypcje przez Stripe.

Pytania