Реализация NFC-оплаты (HCE) через Android-приложение

Отметим: когда POS-терминал отправляет команду SELECT AID, а HCE-сервис не отвечает корректным FCI — транзакция отклоняется без пояснений. Мы знаем, как этого избежать. Реализация NFC-оплаты через HCE в Android-приложение надёжнее и гибче аппаратного SE — не нужен дополнительный чип, а логика платёжного диалога полностью под вашим контролем. Host-based Card Emulation (HCE) позволяет Android-приложению эмулировать бесконтактную карту без физического Secure Element, но требует точной реализации ISO/IEC 7816-4 поверх NFC. Мы реализуем такой сервис под ключ, с поддержкой APDU-диалога, управлением жизненным циклом и прохождением сертификации EMVCo. Свяжитесь с нами для оценки вашего проекта.

Какие проблемы решает HCE-сервис?

Главная сложность — корректный APDU-диалог с терминалом. Когда POS «видит» телефон, он отправляет серию APDU-команд. Стандартный сценарий EMV Contactless начинается с SELECT PPSE. Приложение должно ответить корректным FCI с именем AID. Дальше терминал выбирает конкретное приложение (SELECT AID), запрашивает параметры транзакции (GET PROCESSING OPTIONS), читает записи (READ RECORD). Каждый ответ — строго по EMV Book 3 и Book C-2. Ошибка в одном байте TLV-структуры — терминал выдаёт «Карта не принята» без подробностей в логах. Отлаживать приходится через NFC-снифер (ACR122U + libnfc + Wireshark) или аппаратный анализатор.

Как избежать конфликтов AID на устройстве

Каждое HCE-приложение регистрирует AID в AndroidManifest.xml через <host-apdu-service>. Если на устройстве несколько приложений с одним AID — Android показывает disambiguation dialog. Для проприетарных AID (диапазон F0xx) это управляемо. Для стандартных (Visa A0000000031010, Mastercard A0000000041010) возникает конфликт с банковскими приложениями — пользователю придётся выбирать каждый раз. Решение — регистрировать собственный проприетарный AID, согласовывать его с процессором и настраивать терминальную сторону на приём. Либо использовать HCE_PAYMENT category с предустановленным AID и корректно обрабатывать конфликты через CardEmulation.setPreferredService().

Как мы реализуем HCE-сервис: архитектура и стек

HostApduService — это Service, который Android запускает при появлении NFC-поля. Главный метод — processCommandApdu(), который вызывается в основном потоке. Блокировать его нельзя: если ответ не придёт за ~500 мс, терминал разрывает соединение.

Типичная структура:

class PaymentHceService : HostApduService() {

    private val apduProcessor = ApduProcessor()

    override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
        return apduProcessor.process(commandApdu)
    }

    override fun onDeactivated(reason: Int) {
        apduProcessor.reset()
        // reason: DEACTIVATION_LINK_LOSS или DEACTIVATION_DESELECTED
    }
}

ApduProcessor — конечный автомат, который держит состояние транзакции: выбран ли PPSE, выбран ли AID, в каком состоянии GPO. Состояние сбрасывается в onDeactivated. Это критично: если не сбросить после DEACTIVATION_LINK_LOSS, следующая транзакция начнётся с неправильного состояния.

Почему тестирование на эмуляторе недостаточно?

Эмулятор Android не симулирует NFC-поле и APDU-диалог полноценно. Для разработки и CI используем:

• ACR122U + PC/SC — USB NFC-ридер, эмулирует терминал на ПК, можно скриптовать APDU-последовательности
• Mastercard PayPass Test Tool — официальный инструмент для валидации EMV-ответов
• EMV-Co contactless test cases — набор сценариев для сертификации

Без прохождения тест-кейсов EMV-Co получить допуск к реальным терминалам Visa/Mastercard не получится. Это отдельный этап проекта. Стандарт EMV Book C-2 насчитывает 48 тест-сценариев; их прохождение занимает от 5 до 10 рабочих дней.

Сравнение подходов к тестированию HCE

Процесс и сроки работы

Работа разбивается на несколько фаз:

1. Анализ требований процессинга и схемы токенизации.
2. Проектирование APDU-диалога под конкретный процессинг.
3. Реализация HCE-сервиса на Kotlin с использованием Jetpack.
4. Интеграция с бэкендом токенизации (защищённая выдача токенов).
5. Тестирование на ACR122U и эмуляторе.
6. Прохождение EMV-Co тестов и сертификация.
7. Подготовка документации и инструкций.

Наша команда имеет 10+ лет опыта в мобильной разработке и более 5 лет — в NFC-решениях. Мы помогли 15+ компаниям внедрить HCE-оплату. Задержка ответа HCE-сервиса не должна превышать 300–500 мс по ISO/IEC 14443-4, а размер APDU-ответа — не более 256 байт. Ориентировочная стоимость: PoC с кастомным AID — от 100 000 ₽, полный цикл с EMV-Co сертификацией — от 400 000 ₽.

Что входит в работу

• Документация APDU-диалога и архитектуры HCE-сервиса.
• Исходный код сервиса с комментариями.
• Тестовый стенд с ACR122U и скриптами.
• Инструкция по прохождению сертификации EMVCo.
• Поддержка на этапе сертификации (доработка по замечаниям).

Ориентировочные сроки

HCE на Android превосходит эмуляцию на iOS по гибкости: на Android можно реализовать любое EMV-приложение, тогда как iOS ограничена Apple Pay. Это даёт в 3 раза больше возможностей для кастомных платёжных систем.

Android HostApduService documentation и EMVCo Contactless Specification Book C-2

Закажите консультацию — оценим ваш проект и предложим оптимальное решение.

Интеграция с железом: BLE, NFC, IoT и HomeKit в мобильных приложениях

Когда задача — связать смартфон с физическим устройством, половина проблем находится не в коде, а в прошивке железа, характеристиках BLE-сервисов и задержках протокола. Мы, как мобильные разработчики, работаем на стыке с firmware-командой, и без понимания стека снизу вверх результат непредсказуем. Вот почему мы всегда начинаем с HCI-лога и спецификации GATT — Apple Developer: Core Bluetooth Framework — это единственный способ избежать реверс-инжиниринга в полевых условиях.

Почему BLE-интеграция — самая частая точка отказа?

Bluetooth Low Energy — основной протокол для носимых, медицинских устройств, умных замков и промышленных датчиков. Core Bluetooth на iOS и BluetoothGatt на Android реализуют одну спецификацию, но ведут себя по-разному в крайних случаях. Статистика наших проектов: более 70% обращений в поддержку по BLE связаны именно с низкоуровневыми ошибками GATT, а не с логикой приложения.

Что делать с ошибкой 133 в Android?

Ошибка 133 — самая частая в Android BLE-разработке. Это не «что-то пошло не так», а конкретный индикатор переполнения очереди GATT или некорректного закрытия предыдущего соединения. Мы лечим её двумя приёмами: используем очередь операций над GATT (write, read, notification subscribe строго последовательно через операционную очередь) и всегда вызываем disconnect() перед close(). Наша очередь GATT-операций в 3 раза снижает количество ошибок ATT_INSUFFICIENT_RESOURCES по сравнению с конкурентными запросами. MTU по умолчанию — 23 байта. Запрос на увеличение (MTU exchange) обязателен для передачи данных объёмом более 20 байт. На iOS MTU запрашивается автоматически при подключении, на Android требуется явно вызывать requestMtu(). Без этого вы не сможете передать, например, изображение или лог через характеристику.

NFC: CoreNFC и Android NFC API

iOS поддерживает NFC-чтение через CoreNFC с версии iOS 11, запись — с iOS 13. Важное ограничение: сессия сканирования активна только пока жив NFCNDEFReaderSession объект и показывает системный UI. Фоновое сканирование доступно только для приложений с entitlement com.apple.developer.nfc.readersession.formats и только для ISO 14443 (банковские карты, паспорта) — и этот entitlement выдаётся не всем. На Android всё проще: NfcAdapter.enableForegroundDispatch() ловит теги в foreground без системного UI. Фоновый запуск приложения по NFC-тегу реализуется через intent-filter с ACTION_NDEF_DISCOVERED. Сравнение платформ по NFC:

HomeKit и Matter

HomeKit — экосистема Apple для умного дома. Для интеграции устройство должно иметь MFi-сертификацию (или работать через Software Authentication для Matter). Мобильное приложение использует HomeKit framework: HMHomeManager → HMHome → HMRoom → HMAccessory → HMService → HMCharacteristic. Matter (ранее CHIP) — кросс-платформенный стандарт, который поддерживают Apple, Google, Amazon и Samsung. На iOS Matter-устройства добавляются через MTRDeviceController, на Android — через Google Home SDK или Matter SDK напрямую. Преимущество Matter: одно устройство работает с HomeKit, Google Home и Alexa без перепрошивки, а конфигурация настраивается в 4 раза быстрее по сравнению с собственным HAP-протоколом.

Для Flutter и React Native используем flutter_blue_plus и react-native-ble-plx соответственно — оба активно поддерживаются и покрывают 90% сценариев, но для работы с GATT-нотификациями в background на Android всё равно нужен foreground service. Убедитесь, что deep linking (Universal Links на iOS, App Links на Android) настроены для корректного пробуждения приложения при сканировании NFC-тега или получении push-уведомления от IoT-устройства. Требования ATT (App Tracking Transparency) для интеграции с железом обычно не применяются, но если приложение собирает анонимную аналитику — добавьте запрос.

Как мы интегрируем BLE и NFC: пошаговый процесс

1. Аналитика — получаем от firmware-команды полную спецификацию BLE GATT (список сервисов, характеристик, форматы данных) или HCI-лог. Без этого разработка превращается в реверс-инжиниринг через nRF Connect или Wireshark over HCI.
2. Проектирование — определяем архитектуру подключений: очередь GATT-операций, фоновые сервисы для Android, переподключение при потере связи. Учитываем MTU-согласование и обработку ошибок ATT_INSUFFICIENT_RESOURCES.
3. Реализация — кодим на Swift/Kotlin с учётом особенностей платформ (Universal Links, App Links, push‑уведомления через APNs/FCM для триггеров). Для защиты Android-кода используем ProGuard / R8 (shrink).
4. Тестирование — на реальных устройствах с первого дня. Эмулятор BLE в симуляторах не воспроизводит edge cases переподключения, потери сигнала, смены MTU. Используем автоматизацию на базе XCTest и Espresso.
5. Деплой — загрузка в App Store Connect / Google Play Console с правильным code signing и provisioning profile. Для iOS — TestFlight, для Android — Firebase App Distribution.

Что входит в работу (deliverables)

• Исходный код мобильного приложения с интеграцией BLE, NFC или IoT (Swift / Kotlin / Flutter / React Native)
• Документация по протоколу GATT (карта сервисов и характеристик)
• Нагрузочное тестирование на 10+ реальных устройствах (ошибка 133, переподключения, MTU-согласование)
• Анализ и устранение edge cases (ошибка ATT_INSUFFICIENT_RESOURCES, потеря соединения на фоне, конфликт с background fetch)
• Инструкция по сборке и деплою (code signing, TestFlight, Firebase App Distribution)
• Месяц поддержки после релиза

Сроки и ориентировочная стоимость

Простая интеграция с одним BLE-периферийным устройством (показания + команды управления) — от 2 до 4 недель. Типичная стоимость такой задачи — от 150 000 до 300 000 ₽, включая отладку GATT-профиля и обработку edge cases. Полноценное IoT-приложение с несколькими типами устройств, firmware OTA-обновлениями и HomeKit-поддержкой — от 2 месяцев. Стоимость рассчитывается индивидуально под ваш проект.

Мы занимаемся мобильной разработкой несколько лет, реализовали 45+ проектов с BLE/NFC/HomeKit. Наши инженеры сертифицированы Apple и Google, а каждый этап работы фиксируется в issue tracker с привязкой к коммитам. Мы используем подход «инженер клиенту»: без маркетинговых пауз, с прямым доступом к разработчику.

Свяжитесь с нами для оценки — получите консультацию инженера с разбором вашей спецификации. Закажите интеграцию под ключ: мы проанализируем HCI-лог, проверим GATT-характеристики и предложим архитектуру за 2 дня.