Крупный бизнес

Бизнесу

Компания

Разработчикам

Крупный бизнес

Вход в личный кабинет

Блог Freedom Pay
→
Как интегрировать оплату в мобильное приложение

Как интегрировать оплату в мобильное приложение

Мобильное приложение позволяет клиенту пройти весь путь от выбора товара или услуги до оплаты в одном интерфейсе. Чем проще этот процесс, тем меньше лишних действий нужно совершить пользователю и тем удобнее ему завершить покупку.
Чтобы принимать платежи внутри приложения, бизнесу необходимо подключить интернет-эквайринг и интегрировать платежное решение. Сделать это можно несколькими способами: через готовую платежную страницу, SDK или непосредственно по API.
Разберемся, как интегрировать оплату в мобильное приложение, какой вариант выбрать для iOS и Android и что необходимо предусмотреть до запуска.

Зачем подключать оплату в мобильном приложении

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

интернет-магазинов и маркетплейсов;
сервисов доставки;
приложений для бронирования;
образовательных платформ;
сервисов с подпиской;
билетных сервисов;
SaaS-продуктов;
приложений в сфере услуг;
других проектов, принимающих оплату онлайн.

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

Какие способы интеграции оплаты в приложение существуют

Способ подключения зависит от архитектуры приложения, ресурсов команды разработки и требований бизнеса к пользовательскому интерфейсу.
Рассмотрим основные варианты.
1. Готовая платежная страница
Один из наиболее простых вариантов — использовать готовую платежную страницу.
После оформления заказа приложение инициирует платеж, а пользователь переходит к защищенной форме, где выбирает способ оплаты и вводит необходимые данные.
Freedom Pay Merchant API создает платеж и возвращает ссылку на платежную страницу. После оплаты система сообщает результат на сервер бизнеса и возвращает пользователя по заданному адресу успешной или неуспешной оплаты.
Преимущества такого подхода:

быстрое подключение;
не нужно самостоятельно разрабатывать карточную форму;
платежный интерфейс уже адаптирован под процесс оплаты;
карточные данные вводятся на стороне платежного провайдера.

Этот вариант может подойти компаниям, которым важно запустить прием платежей без разработки собственного платежного интерфейса.
2. Платежный фрейм
Платежную форму можно встроить непосредственно в интерфейс продукта.
В этом случае пользователь вводит данные карты в платежном фрейме и не воспринимает процесс как переход на отдельный сайт.
В Freedom Pay платежный фрейм содержит форму банковской карты, а его внешний вид может настраиваться для мерчанта, включая шрифты, цвета и доступные элементы интерфейса.
Такой подход помогает сохранить более цельный пользовательский путь и приблизить платежную форму к дизайну приложения.
3. Mobile SDK
Для нативных мобильных приложений удобным вариантом может стать SDK — Software Development Kit,готовый набор инструментов для интеграции платежных функций.
SDK упрощает взаимодействие приложения с платежной инфраструктурой и позволяет разработчику использовать уже реализованные платежные сценарии.
Freedom Pay предоставляет Merchant SDK для Android и iOS. В актуальной документации поддерживаются Android 9 и выше, а для iOS — iOS 15 и выше. Через SDK можно запускать платежную страницу или платежный фрейм и работать с другими платежными сценариями.
SDK особенно удобен, когда бизнес хочет глубже встроить оплату в мобильное приложение и сохранить нативный пользовательский опыт.
4. Интеграция напрямую по API
API позволяет приложению и серверу бизнеса обмениваться данными с платежной системой программно.
Такой вариант дает больше гибкости, но требует более глубокой технической интеграции.
Например, можно самостоятельно управлять логикой создания платежа, статусами операций, сохраненными картами и другими сценариями.
При этом важно учитывать требования к безопасности. Если карточные данные собираются непосредственно на стороне бизнеса и передаются server-to-server через Gateway API Freedom Pay, требуется соответствие PCI DSS.При использовании Merchant API данные карты вводятся на страницах Freedom Pay, поэтому PCI DSS сертификат от мерчанта для такого сценария не требуется.

Как подключить оплату в мобильном приложении: пошагово

Сам процесс будет отличаться в зависимости от выбранного решения, но общую схему можно представить следующим образом.
Шаг 1. Подключить интернет-эквайринг
Перед технической интеграцией необходимо подключить сервис приема онлайн-платежей.
Бизнес проходит регистрацию, предоставляет необходимые данные и документы, после чего получает параметры для подключения платежного решения.
После этого команда разработки может переходить к интеграции.
Шаг 2. Выбрать способ интеграции
На этом этапе необходимо определить, как именно клиент будет оплачивать заказ:

на готовой платежной странице;
через встроенную платежную форму;
через Mobile SDK;
через собственный интерфейс и API.

Если нужно запустить платежи быстрее, обычно проще использовать готовую форму.
Если бизнесу необходим более нативный сценарий и глубокая интеграция с интерфейсом приложения, стоит рассмотреть SDK или API.
Шаг 3. Создать платеж на сервере
Когда пользователь оформляет заказ, backend бизнеса формирует информацию о покупке и создает платеж.
Обычно передаются:

идентификатор заказа;
сумма;
валюта;
описание платежа;
необходимые параметры заказа;
адреса или callback для получения результата.

После создания платежа приложение получает данные, необходимые для перехода к следующему этапу оплаты.
Шаг 4. Показать пользователю платежный интерфейс
Клиент выбирает способ оплаты и подтверждает операцию.
Пользователь должен четко видеть:

сумму заказа;
способ оплаты;
кнопку подтверждения;
результат операции.

Если возникает ошибка, сообщение должно объяснять, что произошло и что можно сделать дальше.
Шаг 5. Получить результат платежа
Не стоит определять окончательный результат транзакции только по том, какой экран увидел пользователь.
Сервер бизнеса должен получать и обрабатывать статус операции со стороны платежной системы.
Freedom Pay передает результат платежа на callback мерчанта. Если результат не был получен, Merchant API также позволяет запросить текущий статус платежа.
После подтверждения успешной операции приложение может:

изменить статус заказа;
показать экран успешной оплаты;
предоставить доступ к услуге;
отправить уведомление;
запустить дальнейший бизнес-процесс.

Какие способы оплаты можно добавить в приложение

Чем удобнее клиенту оплачивать заказ, тем меньше действий ему приходится совершать.
В зависимости от подключенных возможностей в мобильном приложении можно использовать разные платежные сценарии.
Банковские карты
Базовый вариант для приема онлайн-платежей.
Пользователь вводит данные карты или выбирает ранее сохраненную карту, если такой функционал предусмотрен.
Сохраненные карты
Если бизнес работает с повторными покупками, пользователю можно дать возможность сохранить карту.
При следующем заказе ему не придется заново вводить полный набор реквизитов.
Freedom Pay Merchant API поддерживает работу с сохраненными картами.
Apple Pay
Для пользователей iOS можно предусмотреть оплату через Apple Pay.
В актуальном iOS SDK Freedom Pay предусмотрен отдельный сценарий Apple Pay: приложение создает платеж,открывает Apple Pay Sheet, получает подтверждение пользователя и передает платежный токен для обработки транзакции.
Google Pay
В Android-приложении можно подключить Google Pay.
Freedom Pay SDK позволяет связать реализацию Google Pay в приложении с платежным шлюзом для дальнейшей обработки транзакции. Для приема реальных платежей приложение необходимо зарегистрировать и получить production-доступ Google.
Доступность конкретных способов оплаты лучше определять на этапе подключения, поскольку она может зависеть от настроек мерчанта, рынка и выбранной интеграции.

Что важно учесть при разработке платежного сценария

Технически работающая интеграция — только часть задачи. Не менее важно сделать оплату удобной для пользователя.
Минимум лишних действий
Не стоит заставлять клиента повторно вводить данные, которые приложение уже знает.
Если имя, телефон или email уже есть в профиле, можно использовать их в процессе оформления заказа автоматически, когда это допустимо.
Понятная сумма перед оплатой
До подтверждения операции пользователь должен понимать, сколько именно будет списано.
Если есть комиссия, доставка или другие дополнительные расходы, лучше показать итоговую сумму заранее.
Состояние загрузки
После нажатия кнопки «Оплатить» операция может обрабатываться несколько секунд.
В этот момент важно показать пользователю, что платеж выполняется, и не провоцировать его нажимать кнопку несколько раз.
Защита от повторной оплаты
Backend должен корректно работать с повторными запросами и идентификаторами заказов.
Пользователь может дважды нажать кнопку, потерять интернет или повторно открыть экран оплаты. Эти ситуации необходимо учитывать при проектировании платежной логики.
Корректная обработка ошибок
Фраза «Произошла ошибка» практически не помогает пользователю.
Лучше предусмотреть понятные сценарии для разных ситуаций:

платеж отклонен;
недостаточно средств;
операция не подтверждена;
истекло время оплаты;
возникла техническая ошибка;
статус операции пока уточняется.

Если проблему можно исправить, пользователю стоит сразу предложить повторить оплату или выбрать другой способ.

Безопасность платежей в мобильном приложении

Работа с платежными данными требует повышенного внимания к безопасности.
Одним из ключевых стандартов отрасли является PCI DSS — Payment Card Industry Data Security Standard.
Необходимость сертификации зависит от того, как построена платежная архитектура.
Если бизнес самостоятельно принимает и обрабатывает карточные данные на своей стороне, требования значительно выше. Gateway API Freedom Pay предназначен именно для server-to-server сценариев с карточными данными на стороне мерчанта и требует PCI DSS.
При использовании Merchant API карта вводится на стороне Freedom Pay, поэтому такой способ подключения не требует от мерчанта собственного PCI DSS сертификата.
Для многих компаний это один из аргументов в пользу использования готового платежного интерфейса или SDK вместо самостоятельной работы с карточными реквизитами.

Как тестировать оплату перед запуском

Перед публикацией новой версии приложения платежный сценарий необходимо протестировать полностью.
Стоит проверить:

успешную оплату;
отклоненный платеж;
прохождение 3-D Secure;
возврат пользователя в приложение;
повторное нажатие кнопки оплаты;
потерю соединения;
повторный запуск приложения во время платежа;
корректное получение callback;
отображение актуального статуса заказа;
возврат средств, если он предусмотрен;
работу на разных устройствах и версиях операционной системы.

Особенно важно убедиться, что приложение и backend одинаково понимают итоговый статус операции.

Что выбрать: API, SDK или платежную страницу

Универсального способа нет.
Платежная страница подойдет, если приоритетом являются простота и скорость запуска.
Платежный фрейм позволяет лучше сохранить единый пользовательский интерфейс.
Mobile SDK удобно использовать в нативных iOS- и Android-приложениях, когда платеж необходимо глубже встроить в пользовательский сценарий.
Gateway API дает максимальную свободу в создании собственной платежной логики, но требует больше ресурсов разработки и соответствия требованиям PCI DSS при самостоятельной работе с карточными данными.
Перед интеграцией стоит определить:

какие способы оплаты нужны клиентам;
какие платформы поддерживает приложение;
необходимы ли сохраненные карты;
насколько важно полностью контролировать дизайн формы;
есть ли у команды ресурсы для собственной интеграции;
планируется ли расширять платежные сценарии в будущем.

Freedom Pay позволяет подключать прием платежей в мобильных приложениях на iOS и Android.
В зависимости от задачи бизнес может использовать Merchant API, платежную страницу или фрейм, а также Merchant SDK для мобильных платформ. В SDK предусмотрены сценарии для работы с платежной формой,сохраненными картами и мобильными кошельками.
Подробные технические требования, методы API и примеры интеграции доступны в документации Freedom Pay.

Частые вопросы

Можно ли принимать оплату прямо внутри мобильного приложения?
Да. Платеж можно встроить в пользовательский сценарий приложения через платежную форму, SDK или API.Конкретный вариант зависит от архитектуры продукта.
Можно ли подключить оплату отдельно для Android и iOS?
Да. Freedom Pay предоставляет Merchant SDK для обеих платформ.
Нужен ли PCI DSS для подключения оплаты?
Не всегда. При использовании Merchant API карточные данные вводятся на стороне Freedom Pay, поэтому собственный PCI DSS сертификат мерчанта не требуется. Если компания самостоятельно собирает карточные данные и использует Gateway API, PCI DSS необходим.
Можно ли добавить Apple Pay и Google Pay?
Да, соответствующие сценарии предусмотрены в мобильных SDK Freedom Pay. Для запуска также необходимо выполнить требования соответствующей платформы и настроить сервис для мерчанта.
Можно ли сохранять карту пользователя?
Freedom Pay поддерживает работу с сохраненными картами. Это позволяет упростить повторную оплату, если соответствующий сценарий подключен для бизнеса.

Назад к списку