Yandex Pay — InApp for Flutter
Flutter-плагин для интеграции сценария InApp Яндекс Пэй в мобильные приложения (Android и iOS). Модуль добавляется поверх yandex_pay_core и предоставляет виджет оплаты InApp.
InApp работает поверх сценария оплаты с редиректом: для его работы необходимо также подключить модуль
yandex_pay_pay_with_redirect.
Установка
Добавьте зависимость в pubspec.yaml:
dependencies:
yandex_pay_inapp: ^2.3.0
Затем:
flutter pub get
Быстрый старт
- Инициализация в
main()доrunApp()через модульную архитектуруyandex_pay_core:
import 'package:yandex_pay_inapp/yandex_pay_inapp.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
await YPay.initialize(
environment: YPayEnvironment.sandbox,
modules: [
inAppModule(
merchantId: 'YOUR_MERCHANT_ID',
stateListener: YInAppStateListener(
onStateChanged: (state) {
switch (state) {
case YInAppLoading():
print('Загрузка состояния InApp');
case YInAppEnabled():
print('InApp доступна');
case YInAppDisabled(:final reason):
print('InApp недоступна: $reason');
}
},
),
),
],
);
runApp(const MyApp());
}
- Управление состоянием оплаты через фасад-синглтон:
final state = await YInApp.instance.getState();
await YInApp.instance.enable(); // изменение доступности придёт в onStateChanged
await YInApp.instance.disable();
- Виджет оплаты InApp. Заказ (
amount+currency) задаётся при создании виджета; передача новогоorderпересоздаёт виджет:
YandexInAppWidget(
order: YInAppOrder(
amount: '199.99',
currency: YInAppCurrency.rub,
),
)
Состояние оплаты
YInAppState— sealed-тип{loading | enabled | disabled(reason)}.getState()— возвращает текущее состояние доступности оплаты.onStateChanged— вызывается при изменении состояния доступности оплаты.
Заказ
YInAppOrder immutable, сравнивается по amount + currency. Сумма — decimal-строка
("199.99"), валидируется регуляркой ^\d+(\.\d+)?$. Валюта — YInAppCurrency
(на провод уходит UPPERCASE ISO 4217).
Требования
- Flutter 3.0+
- Dart 3.0+
- Android: API 24+ (Android 7.0)
- iOS: 15.0+
Полная документация и описание API: Яндекс Пэй для Flutter.
Лицензия
Proprietary License — см. LICENSE.