Модульный мобильный SDK
Модульный мобильный SDK Яндекс Пэй построен как один SDK с несколькими независимыми модулями. Каждый модуль отвечает за отдельный пользовательский сценарий: авторизацию, виджет выгод, быструю оплату или платежный виджет. При интеграции вы подключаете только те пакеты, которые нужны вашему приложению.
Например, если в приложении нужен только виджет выгод, подключите модуль виджета и модуль авторизации. Остальные части SDK не нужно добавлять явно: менеджер зависимостей сам подтянет внутренние библиотеки, которые нужны выбранным модулям.
Как устроены модули
Модуль SDK — это публичная точка входа в конкретный сценарий. Внутри модуля уже собраны нужные экраны, навигация, работа с сетью, аналитика, хранилище и базовые UI-компоненты. Приложение партнера работает только с публичным API модуля.
В SDK есть два типа зависимостей:
- Публичные модули — пакеты, которые вы добавляете в приложение напрямую. Например, модуль виджета выгод, модуль авторизации или модуль быстрой оплаты.
- Внутренние зависимости — технические библиотеки SDK:
core,data,entities, адаптеры, ресурсы и UI-компоненты. Они подключаются транзитивно и не требуют отдельной настройки.
Такой подход позволяет расширять интеграцию постепенно. Можно начать с одного виджета, а затем добавить авторизацию, платежный сценарий или другие модули без замены всего SDK. Например:
- Пэй Виджет для быстрой онлайн оплаты на checkout — отдельный публичный модуль модульного SDK. Его можно подключать независимо от виджетов выгод, если приложению нужен только сценарий оплаты на этапе оформления заказа.
- QR‑код от Яндекс Пэй для быстрой оплаты в офлайн-точках — отдельный публичный модуль модульного SDK. Его можно подключать независимо от других модулей, если приложению нужен только сценарий оплаты по QR-коду на физической кассе.
Продуктовые решения
С помощью модулей Yandex Pay Kit вы можете реализовать различные пользовательские сценарии в своем мобильном приложении. Примеры таких сценариев приведены в разделе Продуктовые решения на основе модулей SDK Yandex Pay Kit.
Android
Публичные Android-модули SDK доступны как отдельные пакеты:
| Пакет | Назначение | Документация |
|---|---|---|
| com.yandex.pay:pay-with-redirect | psp-like оплата с редиректами | Редирект |
| com.yandex.pay:assistant | Виджеты выгод и сценарии ассистента Яндекс Пэй. | Ассистент |
| com.yandex.pay:auth | Авторизация пользователя в Яндекс Пэй и передача состояния авторизации партнера. | Авторизация |
| com.yandex.pay:quickpay | Быстрая оплата через QR-код в офлайн-точках. | CP QR |
| com.yandex.pay:inapp | Быстрая оплата онлайн на checkout. Подключается вместе с pay-with-redirect. |
Пэй виджет |
Порядок установки описан в разделе Общее руководство.
В коде приложения вы обращаетесь к нужному модулю через общий объект SDK. Например, YPay.assistant отвечает за виджет выгод, YPay.auth — за авторизацию и состояние пользователя, YPay.payWithRedirect — за сессию оплаты по ссылке и кнопку оплаты. Сценарий Пэй Виджет уже подразумевает pay-with-redirect как резервный путь; для только оплаты по ссылке достаточно подключения pay-with-redirect и инициализации payWithRedirectFlow в flows.
iOS
Публичные iOS-модули SDK доступны как отдельные продукты или пакеты:
| Модуль | Описание | Документация |
|---|---|---|
YandexPayWithRedirect |
Кнопка и форма оплаты по ссылке | Редирект |
YandexPayInventory |
Бейджи Яндекс Пэй | Инвентарь |
YandexPayAuth |
Авторизация через Яндекс ID | Авторизация |
YandexQuickPay |
CP QR | CP QR |
YandexPayInApp |
Встроенные оплаты (InApps) | Пэй виджет |
YandexPayAssistant |
Виджет выгод | Ассистент |
iOS-модули распространяются в формате XCFramework и доступны для подключения через Swift Package Manager и CocoaPods.
Вы можете подключить Yandex Pay Kit с нуля или мигрировать на него с Яндекс Пэй SDK 1.x.