Есть платежный терминал на Android. На нем работает приложение: принимает оплату, обращается к нужным модулям, печатает слип. Теперь нужно перейти на терминал другого аппаратного вендора. Там тоже Android, и прикладные задачи те же. Но часть кода приходится адаптировать.
Причина в оборудовании. У каждого вендора свои API, библиотеки и особенности работы с компонентами терминала. Одинаковая операционная система эту разницу не устраняет.
В АТОЛ я пришел к этой задаче через другую проблему. API исходного терминала был достаточно сложным для разработчиков прикладного ПО, а мне нужно было подключить несколько систем. Каждому партнеру предстояло разобраться с этим API и затем поддерживать интеграцию. Поэтому я и взялся за платежный SDK. Уже потом оказалось, что решение заодно упростило переход на терминалы другого поставщика.
Телефон с дополнительным оборудованием
Представьте обычный Android-телефон, к разъемам которого подключили ридер банковских карт, принтер, SAM-модули и т.д. Все это висит на телефоне, и приложению нужно уметь с этим работать.

У платежного терминала компоненты собраны в одном корпусе, но для понимания задачи образ вполне подходит. У каждого компонента есть свои особенности, а у вендора терминала – свои способы работы с ним.
В Android есть средства связи с периферией, например USB Host API. Но возможность передать данные устройству еще не означает, что приложение умеет выполнять нужную операцию. Нужно знать, какие команды отправить, в какой последовательности и как обработать ответ.
Поэтому у двух терминалов может быть одинаковый набор функций в спецификации, но разные интерфейсы к оборудованию. Именно с этими различиями приходится разбираться при смене аппаратного вендора.
Сложность возникает еще на первом терминале
Для начала достаточно одной модели и нескольких прикладных систем. Если API терминала сложен в освоении и поддержке, каждый партнер тратит время на одну и ту же часть работы: взаимодействие с оборудованием.
При этом задачи у партнеров свои. Один разрабатывает ПО для курьера, другой – для оплаты проезда. Им нужно подключить возможности терминала к своей прикладной логике. Чем сложнее это сделать, тем больше работы требуется до того, как системой можно пользоваться.
Я понимал, что подключать предстоит несколько таких систем. Поэтому смотрел на задачу со стороны разработчика партнерского ПО: что ему нужно для интеграции и с какими особенностями терминала ему затем придется жить. Это и стало отправной точкой для платежного SDK.
Что меняет платежный SDK
Между прикладным ПО и оборудованием появился общий интерфейс. Приложение обращается к нужным возможностям через платежный SDK, а работу с API аппаратного вендора берет на себя этот слой.
Так у партнеров появляется общий способ интеграции. Особенности исходного API сосредоточены в платежном SDK, и каждому разработчику прикладной системы уже не нужно разбираться с ними самостоятельно.
А дальше этот же подход помог при смене поставщика терминалов. Приложения уже работали через наш интерфейс. Чтобы поддержать другое железо, можно было адаптировать работу платежного SDK с API нового вендора, сохраняя сделанную интеграцию со стороны прикладного ПО.
Упрощенно схема выглядит так:
Это схема подхода, без деталей внутренней реализации платежного SDK АТОЛ.
Работа с новым оборудованием никуда не исчезает. Меняется место, где ее нужно выполнить. Вместо того чтобы адаптировать взаимодействие с вендорским API в каждом приложении, эту часть можно поддержать в общем слое.
Даже у печати есть свои особенности
Возьмем печать слипа. Для пользователя задача не меняется: после оплаты нужно получить распечатку. А при переходе к другому вендору разработчик может столкнуться с другими способами загрузки шрифтов и принципами печати. Приходится адаптировать код подготовки и отправки данных принтеру.
Здесь недостаточно дать методам одинаковые названия. Важно еще договориться об их поведении.
Например, что означает успешный ответ: принтер принял задание или уже напечатал слип? Что вернется, если закончилась бумага? Как поступить, если ответ не пришел: повторить запрос или сначала выяснить, успел ли принтер его выполнить?
Это примеры вопросов, которые приходится учитывать при проектировании общего интерфейса. Если одинаковые вызовы на разных терминалах ведут себя по-разному, особенности оборудования снова попадают в прикладной код.
Есть и вполне физические различия: в одной модели принтер предусмотрен, в другой его нет. Приложению нужно понимать, какие возможности доступны. Платежный SDK помогает организовать работу с оборудованием, но сами различия между моделями остаются.
Что осталось от адаптации
В нашем случае срок портирования партнерского ПО сократился с шести до двух месяцев. Это срок переноса ПО, а не всего цикла запуска терминала.
При этом появление платежного SDK не означает, что любое приложение достаточно установить на новую модель и сразу отдавать в эксплуатацию. Нужно проверить используемые сценарии, работу с компонентами и обработку ошибок. Если возможности терминалов различаются, это тоже может потребовать изменений в приложении.
Особенно важно пройти весь сценарий оплаты. То, что приложение запустилось и показало нужный экран, еще мало говорит о его работе на новом терминале.
Поэтому результат я бы описал так: повторяющейся работы стало меньше, прикладную логику и интеграцию удалось в большей степени сохранить. Адаптация и проверка на конкретном устройстве остались.
Что это меняет при выборе поставщика
Когда выбираешь следующий терминал, обычно сравниваешь цену, экран, аккумулятор, производительность, набор модулей. После такой работы к этим характеристикам добавляются вопросы про ПО: сколько приложений придется адаптировать, сколько времени понадобится партнерам и что из уже сделанного получится сохранить.
Эту стоимость перехода полезно оценить до выбора аппаратного вендора. Иначе подходящее по характеристикам устройство может потребовать заметного объема доработок в нескольких прикладных системах.
Мы начинали со сложного API и необходимости подключить партнерское ПО. Упрощение интеграции заодно уменьшило зависимость приложений от поставщика терминалов. Со временем платежный SDK стал основой для Android-продуктов АТОЛ. Но исходная задача была вполне конкретной: сделать так, чтобы разработчикам нескольких систем было проще работать с нашим оборудованием.
А у вас при переходе на терминал другого вендора сколько работы остается в приложении? Получается ограничиться адаптацией слоя оборудования или особенности нового API расходятся дальше по коду?
Источник: habr.com