Jak przyjmować płatności kartą w autorskiej aplikacji POS

Aby przyjmować płatności kartami w autorskiej aplikacji POS, korzystasz z usług dostawcy płatności (PSP) oraz jednej z czterech ścieżek: certyfikowanego czytnika kart, Tap to Pay on iPhone, Tap to Pay on Android lub połączonego z chmurą terminala smart. Twoja aplikacja nigdy nie odczytuje numeru karty. Przesyła kwotę do certyfikowanego sprzętu lub oprogramowania i otrzymuje odpowiedź: zaakceptowano lub odrzucono. Każda ścieżka stawia własne wymogi ze strony Apple, Google lub dostawcy i to właśnie formalności, a nie kodowanie, zajmują najwięcej czasu.

Ten przewodnik przedstawia każdą ścieżkę krok po kroku, wraz z rzeczywistymi wymogami bez koloryzowania. Robimy płatności dla naszego własnego systemu POS, Final, więc sami przeszliśmy przez każdy z tych kroków.

Dlaczego nie możesz po prostu dodać formularza karty do swojego POS?

Ponieważ formularz karty kwalifikuje transakcję jako płatność bez fizycznego użycia karty (card-not-present), podczas gdy lada sklepowa wymaga płatności z fizycznym użyciem karty (card-present). Gdy klient wpisuje numer karty w formularzu WWW, transakcja traktowana jest jak zamówienie internetowe: wyższe prowizje, większe narażenie na oszustwa i większe ryzyko sporu po Twojej stronie. Gdy certyfikowane urządzenie odczytuje kartę lub telefon, transakcja ma charakter fizyczny (card-present), co jest tańsze i bezpieczniejsze dla obu stron.

Przyjmowanie transakcji fizycznych (card-present) wymaga certyfikowanego sprzętu lub oprogramowania. Dlatego każda poniższa ścieżka korzysta z rozwiązań stacjonarnych dostawcy PSP, a nie z Twojego własnego kodu. Różnicę w opłatach opisano w artykule transakcje fizyczne a transakcje internetowe (card-present vs card-not-present).

Ścieżka 1: Jak używać czytnika kart z własną aplikacją?

Wybierz dostawcę PSP oferującego in-person SDK, kup jeden z jego certyfikowanych czytników i sparuj go w swojej aplikacji. W ten sposób działają Stripe Terminal, Adyen i inni.

1. Otwórz konto u dostawcy PSP i aktywuj jego produkt do płatności stacjonarnych (in-person).

2. Zintegruj SDK dostawcy dla iOS, Androida lub React Native.

3. Zamów certyfikowane czytniki i zarejestruj je na swoim koncie.

4. Wyszukuj i łącz się z czytnikami z poziomu aplikacji, a następnie pobieraj płatności za pośrednictwem SDK.

5. Uwzględnij aktualizacje oprogramowania układowego (firmware) czytnika, które udostępnia PSP.

Nie możesz podłączyć dowolnego czytnika: płatności przetwarzają wyłącznie czytniki certyfikowane u Twojego dostawcy, ponieważ certyfikacja obejmuje konkretne połączenie czytnika, oprogramowania i agenta rozliczeniowego. Więcej w artykułach czytniki kart dla autorskich aplikacji POS i certyfikacja EMV dla systemu POS.

Ścieżka 2: Czego wymaga Tap to Pay on iPhone?

Tap to Pay on iPhone zamienia telefon w czytnik. Wymogi samego Apple to: nawiązanie współpracy z obsługiwanym PSP, złożenie wniosku o uprawnienie Tap to Pay on iPhone, integracja API ProximityReader lub SDK dostawcy PSP, zastosowanie się do wytycznych Apple dotyczących interfejsu (Human Interface Guidelines) oraz przesłanie aplikacji do weryfikacji (omówienie Tap to Pay w serwisie Apple). Apple zaznacza, że to dostawca PSP odpowiada za certyfikacje umożliwiające akceptowanie płatności przez sprzedawców.

W praktyce oznacza to:

1. Firmowe konto deweloperskie. Wniosek o uprawnienie musi zostać złożony przez Właściciela konta (Account Holder) na koncie firmowym, a rejestracja firmy wymaga numeru D-U-N-S. Zobacz numery D-U-N-S a konta deweloperskie Apple.

2. Formularz wniosku. Wskaż swojego dostawcę PSP oraz regiony, w których będziesz działać.

3. Uprawnienie deweloperskie. Apple przyznaje je do celów budowania i testowania na własnych urządzeniach.

4. Wymogi UX Apple. Wraz z uprawnieniem Apple przesyła swoje wymogi i wytyczne marketingowe, obejmujące etykiety przycisków, punkty wejścia i proces wdrażania użytkownika.

5. Uprawnienie dystrybucyjne. Odpowiadasz na e-mail od Apple, składając ponowny wniosek o uprawnienie dystrybucyjne. Jest ono wymagane przez TestFlight i App Store.

6. App Review. Aplikacja zostaje opublikowana po pomyślnym przejściu weryfikacji.

Funkcja działa na telefonach iPhone XS lub nowszych i nie działa na iPadach. Pełny przewodnik znajduje się w artykule jak uzyskać uprawnienie Tap to Pay on iPhone, ze wskazówkami dotyczącymi weryfikacji w jak przejść App Review z aplikacją Tap to Pay oraz alternatywami w dlaczego Tap to Pay nie działa na iPadzie.

Ścieżka 3: Czym różni się Tap to Pay on Android?

W Androidzie nie ma wniosków o uprawnienia takich jak w Apple, ale SDK dostawcy PSP przeprowadza własne weryfikacje. Typowe wymogi:

• Urządzenie z systemem Android 11 lub nowszym i wbudowaną obsługą NFC

• Urządzenie certyfikowane przez Google, przechodzące weryfikację integralności

• Kompilacja niedebugowalna: SDK dostawcy PSP odmawia przyjmowania realnych płatności zbliżeniowych w trybie debugowania, więc testy przeprowadzasz na symulowanym czytniku

• Uprawnienia do lokalizacji oraz inne uprawnienia, o które prosi SDK

Tablety z systemem Android mogą działać, jeśli spełniają wymogi dostawcy. Szczegóły w artykule Tap to Pay on Android w autorskiej aplikacji.

Ścieżka 4: Czy webowy system POS może przyjmować karty?

Tak, za pośrednictwem terminala smart połączonego z chmurą. Twój serwer informuje API dostawcy PSP o wysłaniu żądania płatności do konkretnego terminala na ladzie; terminal obsługuje kartę i przekazuje wynik z powrotem do Twojego serwera. To jedyna ścieżka stacjonarna, z której może skorzystać webowy POS, ponieważ strona WWW nie potrafi odczytać karty zbliżeniowej, a Safari nie ma dostępu do czytników Bluetooth.

Sprawdza się to w sklepach i punktach stacjonarnych ze stałym terminalem przy ladzie. Wymaga to jednak połączenia sieciowego, więc zaplanuj awaryjne działanie na wypadek utraty łączności internetowej w lokalu.

Jak wybrać dostawcę płatności dla autorskiego POS?

Zacznij od krajów, w których prowadzisz sprzedaż, a następnie przeanalizuj proces rejestracji i dostępny sprzęt:

Nasz bezpośrednie porównanie znajdziesz w artykule Stripe Terminal a Adyen dla autorskiej aplikacji POS. Jeśli planujesz przyjmować płatności w imieniu innych firm, przeczytaj najpierw artykuł zostań pośrednikiem płatności (payfac) lub skorzystaj z gotowej platformy; w przypadku pojedynczego sklepu jesteś po prostu sprzedawcą.

Jaką zgodność z przepisami przejmujesz, a za co odpowiadasz samodzielnie?

Używanie certyfikowanego SDK lub czytnika dostawcy PSP oznacza, że dane kart nigdy nie trafiają do Twojego kodu, co pozwala utrzymać niewielki zakres PCI. Dostawca PSP odpowiada za certyfikacje płatnicze. Po Twojej stronie wciąż pozostaje:

• Wypełnienie kwestionariusza samooceny PCI u agenta rozliczeniowego

• Kontrola dostępu, logowanie zdarzeń i aktualizacje na urządzeniach z aplikacją POS

• Prawidłowe wyliczanie paragonów, zwrotów i stornowanie podatków

• Przestrzeganie zasad Apple oraz dostawcy PSP dotyczących prezentowania i marketingu usługi Tap to Pay

Jeśli budujesz również pozostałą część systemu POS, nasz artykuł o tym, jak zbudować własny system POS z AI, omówi kwestie PCI, podatków i wdrożenia, a artykuł sprzęt POS dla autorskich aplikacji opisze drukarki i szuflady.

Ile czasu zajmuje przyjęcie pierwszej płatności kartą?

Czy możesz zacząć przyjmować karty od pierwszego dnia?

Tak, budując swój interfejs kasowy na platformie, która dysponuje już wszystkimi zatwierdzeniami. Taką platformą jest Final. Twoje AI tworzy interfejs w Flow Studio, a gdy pojawia się potrzeba płatności kartą, Final Pay obsługuje czytnik lub Tap to Pay:

• Czytniki i Tap to Pay są już zatwierdzone. Final Pay przyjmuje płatności kartą, zbliżeniowo oraz przez Tap to Pay na obsługiwanych urządzeniach. Zobacz jak przyjąć płatność Tap to Pay oraz jak przyjąć płatność przy kasie.

• Tworzy to Twoje własne AI. Podłącz Claude, Cursor lub dowolnego klienta MCP za pośrednictwem serwera MCP Final.

• Cennik prosty jak jedno zdanie. Brak subskrypcji. Gotówka wynosi $0. Karta to 2,49% + $0,10 w USA i na świecie, 1,99% w Kanadzie i 0,99% w Europie.

Uczciwy kompromis: rozliczenia odbywają się przez Final Pay, a nie wybranego przez Ciebie dostawcę, a dostępność zależy od kraju i urządzenia, co wyszczególniono w artykule gdzie jest dostępny Final Pay. Jeśli płatności są Twoim produktem, zbuduj integrację samodzielnie za pomocą powyższych ścieżek. Jeśli płatności to po prostu sposób na pobieranie należności, wszystkie zgody są już załatwione.