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