Дополнительно: посмотрите, какие методы оплат доступны в нашем стеке и как работает базовый API для приёма платежей.
Варианты интеграции: Native SDK, App2App и WebView
Мы поддерживаем несколько сценариев внедрения. Выберите тот, который лучше балансирует скорость запуска, UX и требования безопасности.
| Вариант |
Когда выбирать |
UX и 3DS |
Безопасность/PCI |
Время внедрения |
| Native SDK (рекомендовано) |
Нужен максимальный конверт и нативный UX |
3DS mobile flow внутри приложения |
Минимальный PCI‑скоуп благодаря токенизации |
Среднее |
| Deeplink App2App |
Хотите переводить в доверенное банковское приложение |
Плавный переход по deeplink, возврат в приложение |
Минимальный |
Низкое–среднее |
| WebView/мобильный веб |
Временное решение или минимум разработки |
3DS в вебе, возможны переключения контекста |
Завершение на стороне платёжной страницы |
Низкое |
Примечание: deeplink app2app сценарии зависят от поддержки со стороны банка‑эмитента пользователя и могут быть недоступны для части трафика. Наш SDK автоматически выбирает оптимальный маршрут.
Apple Pay интеграция на iOS: требования и шаги
Нативный SDK платежей для iOS упрощает подключение Apple Pay и обработку карт. Для Apple Pay интеграции требуется выполнить несколько пунктов.
Требования
- Аккаунт Apple Developer с включённым Apple Pay.
- Merchant ID и сертификаты (Payment Processing, Merchant Identity).
- Добавленные сети карт (Visa, Mastercard, MIR, при поддержке региона) и регионы.
- iOS 12+ (рекомендуется) и актуальная версия Xcode.
Шаги интеграции
- Настройте entitlements и добавьте Merchant ID в проект.
- Установите наш iOS SDK (Swift Package Manager/CocoaPods) и инициализируйте клиент ключом.
- Сформируйте платёжный запрос (сумма, валюта, описание, allowedNetworks).
- Вызовите PKPaymentAuthorizationController через SDK-обёртку — токен из Apple Pay безопасно уйдёт на наш шлюз.
- Обработайте коллбэк авторизации и дождитесь статуса через вебхуки и события.
Примеры кода и пошаговые инструкции доступны в документации API и разделе быстрого старта. Для проверки сценариев используйте песочницу.
Советы по UX
- Показывайте Apple Pay как первый способ оплаты, если устройство его поддерживает.
- Используйте динамическую итоговую сумму, добавляйте доставку и скидки в тот же лист.
- Чётко помечайте назначение списания в описании платежа.
Google Pay интеграция на Android: требования и шаги
SDK платежей для Android упрощает работу с классическими картами и Google Pay. Наш Android‑компонент берёт на себя шифрование, сериализацию и передачу платёжных токенов на шлюз.
Требования
- Play Services и актуальная библиотека Google Pay на устройстве пользователя.
- Зарегистрированный merchantId (payment gateway tokenization через наш шлюз).
- Указание поддерживаемых сетей карт и стран/валют.
Шаги интеграции
- Подключите Android SDK (Gradle/Maven) и инициализируйте его ключами окружения.
- Проверьте isReadyToPay и предварительно настройте PaymentDataRequest.
- Запустите платеж с Google Pay Sheet, получите токен и передайте его в SDK.
- Получите итоговый статус транзакции через вебхуки и события и на стороне клиента.
Для отладки используйте тестовую среду и набор карт в песочнице. Общие принципы работы платёжных методов см. в документации API.
Советы по UX
- Если Google Pay доступен, показывайте «Оплатить GPay» рядом с кнопкой «Оплатить картой».
- Сохраняйте выбранный способ для следующего раза — это снижает трение.
3DS mobile flow, безопасность и антифрод
Наш SDK реализует полный 3DS mobile flow: от фрикшенлесс‑проверок до challenge с биометрией/OTP. Основные особенности:
- 3DS 2.x в нативном окне без переключений в браузер.
- Fallback на 3DS 1 для редких сценариев (WebView с безопасным редиректом).
- Передача расширенных данных о девайсе и транзакции для повышения доли frictionless.
По безопасности мы соответствуем отраслевым стандартам: см. раздел Безопасность и PCI DSS. Для снижения мошенничества доступен модуль антифрод и риск‑контроль с гибкими правилами, скорингом и листами доверия.
UX мобильного чекаута: лучшие практики
Хороший UX мобильной оплаты повышает конверсию и LTV. Рекомендации:
- Один экран — одна задача. Не перегружайте экран оплаты лишними полями.
- Автоматические форматы: маскирование PAN, авто‑разделители срока, numeric‑клавиатуры.
- Подсказки и валидации в реальном времени, понятные сообщения об ошибках.
- Видимые иконки брендов карт и защищённости (PCI/3DS).
- Сохранение карты по токену, однокликовая оплата при повторных покупках.
- Кнопка Pay фиксируется на «fold» экрана, sticky summary с итоговой суммой.
- Учитывайте доступность: контраст, крупные тапы, поддержку screen‑reader.
Наш SDK включает готовые компоненты для улучшенного UX мобильного чекаута и шрифтовые иконки платёжных сетей.
Сохранение карт, токенизация и рекуррентные списания
SDK поддерживает безопасную токенизацию: карта сохраняется в виде токена на стороне платёжного провайдера, а не в вашем приложении, что минимизирует PCI‑скоуп и ускоряет повторные платежи.
Возможности:
- One‑click платежи с сохранённой картой.
- Рекуррентные списания с автопролонгацией подписок и гибкой логикой ретраев.
- Привязка карты с нулевым/микро‑авторизационным списанием.
Узнайте больше в разделе рекуррентных платежей и настройках безопасности в PCI DSS.
Серверная часть, API и вебхуки
Хотя мобильное приложение инициирует платеж, финальная авторизация и подтверждение происходят через ваш бэкенд по безопасному каналу. Базовый поток:
- Приложение создаёт платёж или сессию через ваш сервер.
- Сервер вызывает методы API для приёма платежей по ключу мерчанта.
- SDK проводит платёж и, при необходимости, запускает 3DS.
- Статусы и обновления приходят на ваш endpoint через вебхуки и события.
См. технические детали в документации API и примеры в быстром старте. Для мобильно‑веб гибридов доступны также плагины для CMS.
Возвраты, фискализация и отчётность
После проведения платежа бизнес‑процессы не заканчиваются:
Тестирование, тарифы и поддержка
Быстрый старт: чек‑лист внедрения
- Определите нужные сценарии: карты, Apple Pay, Google Pay, рекуррентные.
- Настройте аккаунты и ключи: Apple Merchant ID, Google Pay merchantId.
- Подключите iOS/Android SDK, инициализируйте с ключами окружения.
- Реализуйте основной поток: create payment → present sheet/SDK UI → handle result.
- Подключите сервер: обработка статусов через вебхуки, реквизиты заказа через API.
- Включите 3DS mobile flow и протестируйте challenge/фрикшенлесс.
- Настройте токенизацию и one‑click, при необходимости — рекуррентные платежи.
- Проведите end‑to‑end тесты в песочнице, затем откройте прод.
Подробный план и примеры кода — в разделе быстрый старт интеграции.
Заключение и следующий шаг
Мобильные платежи SDK — кратчайший путь к высокому конверту и безопасной оплате в приложениях. Наши iOS/Android решения обеспечивают нативный 3DS mobile flow, поддерживают Apple Pay интеграцию и Google Pay интеграцию, токенизацию, deeplink app2app и все необходимые бэкенд‑процессы.
Готовы ускорить внедрение? Начните с быстрого старта, изучите документацию и подключите тестовый проект в песочнице. Нужна помощь — мы на связи: смотрите SLA и поддержку.
