Как принимать оплату картами в кастомном POS-приложении

Чтобы принимать оплату картами в кастомном POS-приложении, вы взаимодействуете с провайдером платежных услуг (PSP) по одному из четырех путей: сертифицированный картридер, Tap to Pay on iPhone, Tap to Pay on Android или смарт-терминал с подключением к облаку. Ваше приложение никогда напрямую не считывает номер карты. Оно отправляет сумму на сертифицированное оборудование или ПО и получает статус операции (одобрено или отклонено). У каждого пути есть свои требования со стороны Apple, Google или вашего провайдера, и именно эта бумажная работа, а не код, занимает основное время.

В этом руководстве пошагово описан каждый путь с реальными требованиями. Мы обрабатываем платежи для собственной POS-системы Final, поэтому сами прошли каждый из этих этапов.

Почему нельзя просто добавить форму ввода карты в POS-систему?

Потому что форма ввода карты переводит операцию в разряд «карта не присутствует» (card-not-present), а торговой кассе необходим режим «карта присутствует» (card-present). Когда покупатель вводит номер карты в веб-форму, платеж обрабатывается как онлайн-покупка: с повышенными комиссиями, высоким риском фрода и переложением оспаривания операций на вас. Когда сертифицированное устройство считывает карту или телефон, платеж считается проведенным в присутствии карты, что дешевле и безопаснее для всех.

Прием платежей в режиме card-present требует сертифицированного оборудования или ПО. Именно поэтому каждый из описанных ниже путей работает через готовые решения PSP, а не через ваш собственный код. Разница в комиссиях подробно описана в статье оплата в присутствии карты против оплаты без присутствия карты.

Путь 1: Как использовать картридер в собственном приложении?

Выберите PSP с готовым SDK для очных платежей, купите один из его сертифицированных ридеров и свяжите его со своим приложением. Stripe Terminal, Adyen и другие работают именно так.

1. Откройте аккаунт у PSP и активируйте сервис очных платежей.

2. Интегрируйте его iOS, Android или React Native SDK.

3. Закажите сертифицированные ридеры и зарегистрируйте их в своем аккаунте.

4. Находите и подключайте ридеры из своего приложения, а затем принимайте платежи через SDK.

5. Запланируйте обновления прошивки ридера, которые рассылает PSP.

Вы не можете подключить случайный ридер: обрабатывать карты могут только устройства, сертифицированные вашим провайдером, так как сертификация покрывает связку из конкретного ридера, ПО и процессинга. Подробнее в картридеры для кастомных POS-приложений и сертификация EMV для POS.

Путь 2: Что требуется для Tap to Pay on iPhone?

Tap to Pay on iPhone превращает сам телефон в платежный ридер. Шаги Apple: заключить договор с поддерживаемым PSP, запросить разрешение Tap to Pay on iPhone, интегрировать ProximityReader API или SDK провайдера, следовать Human Interface Guidelines от Apple и отправить приложение на проверку (обзор Tap to Pay от Apple). Apple указывает, что PSP отвечает за сертификации, позволяющие продавцам принимать платежи.

На практике это означает:

1. Корпоративный аккаунт разработчика. Запрос разрешения должен подавать владелец аккаунта (Account Holder) организации, а для регистрации организации нужен номер D-U-N-S. См. номера D-U-N-S и аккаунты разработчиков Apple.

2. Форма запроса. Укажите вашего PSP и регионы работы.

3. Разрешение для разработки. Apple выдает его для сборки и тестирования на собственных устройствах.

4. Требования Apple к UX. Вместе с разрешением Apple высылает требования к интерфейсу и маркетингу (надписи на кнопках, точки входа, онбординг).

5. Разрешение для дистрибуции. Вы отвечаете на письмо Apple и запрашиваете разрешение на дистрибуцию. Оно необходимо для TestFlight и App Store.

6. App Review. Приложение публикуется после прохождения проверки.

Функция работает на iPhone XS и новее и не работает на iPad. Полное руководство читайте в как получить разрешение Tap to Pay on iPhone, советы по прохождению проверки — в прохождение App Review с приложением Tap to Pay, а альтернативы — в почему Tap to Pay не работает на iPad.

Путь 3: Чем отличается Tap to Pay на Android?

На Android нет аналога разрешений от Apple, но SDK платежного провайдера выполняет собственные проверки. Типичные требования:

• Устройство Android со встроенным NFC на базе Android 11 или новее

• Сертифицированное Google устройство, проходящее проверку целостности (attestation)

• Релизная сборка (non-debuggable): SDK провайдера отказываются принимать реальные касания в режиме отладки, поэтому тестирование идет на эмуляторе ридера

• Разрешения на геопозицию и другие доступы, запрашиваемые SDK

Планшеты Android могут работать, если они соответствуют требованиям провайдера. Детали в Tap to Pay на Android в кастомном приложении.

Путь 4: Может ли браузерная POS-система принимать карты?

Да, с помощью подключенного к облаку смарт-терминала. Ваш сервер передает через API провайдера команду отправить платеж на конкретный терминал на стойке; терминал обрабатывает карту и возвращает результат вашему серверу. Это единственный очный путь для веб-POS, так как веб-страница не может считать бесконтактную карту, а Safari не может подключаться к Bluetooth-ридерам.

Это решение подходит для стационарных касс. Оно добавляет зависимость от сети, поэтому нужно заранее продумать поведение при обрыве связи.

Как выбрать платежного провайдера для кастомной POS?

Начните со стран присутствия, затем оцените онбординг и оборудование:

Наше прямое сравнение — в статье Stripe Terminal против Adyen для кастомного POS-приложения. Если вы планируете принимать платежи от имени других бизнесов, сначала прочитайте стать платежным фасилитатором или использовать платформу; для одного магазина вы выступаете обычным продавцом (merchant).

Какую часть compliance вы наследуете, а какую ведете сами?

Использование сертифицированного SDK или ридера от PSP означает, что данные карт никогда не проходят через ваш код, что сводит объем требований PCI DSS к минимуму. Провайдер берет на себя платежные сертификации. За вами остаются:

• Заполнение опросника самооценки PCI (SAQ) для вашего процессинга

• Контроль доступа, логирование и обновления на устройствах с POS

• Корректность чеков, возвратов и сторнирования налогов

• Соблюдение правил Apple и провайдера по отображению и маркетингу Tap to Pay

Если вы разрабатываете и остальные блоки POS-системы, в нашем материале про то, как создать собственную POS-систему с помощью ИИ, описаны PCI, налоги и развертывание, а статья POS-оборудование для кастомных приложений закрывает вопросы принтеров и ящиков.

Сколько времени уйдет до приема первого платежа по карте?

Можно ли начать принимать карты с первого дня?

Да, если собрать кассовый интерфейс на платформе, у которой уже есть все разрешения. Это Final. Ваш ИИ собирает кассовый интерфейс в Flow Studio, и когда требуется оплата картой, Final Pay берет на себя ридер или Tap to Pay:

• Уже одобренные ридеры и Tap to Pay. Final Pay принимает карты, бесконтактную оплату и Tap to Pay на поддерживаемых устройствах. См. как принять платеж через Tap to Pay и как принять платеж на кассе.

• Ваш собственный ИИ строит интерфейс. Подключите Claude, Cursor или любой MCP-клиент через MCP-сервер Final.

• Тарифы в одну строку. Без абонентской платы. Наличные — $0. Карты — 2.49% + $0.10 в США и по миру, 1.99% в Канаде и 0.99% в Европе.

Честный компромисс: вы проводите операции через Final Pay, а не выбираете собственного провайдера, при этом география работы зависит от страны и устройства (список доступен в где доступен Final Pay). Если платежи — это ваш продукт, создавайте интеграцию самостоятельно по указанным выше путям. Если платежи — это просто способ получать деньги за продажи, то все разрешения за вас уже получены.