yandex_quick_pay 1.1.0

Yandex Quick Pay SDK for Flutter.

Yandex Quick Pay SDK for Flutter

Flutter-плагин для интеграции быстрой оплаты Яндекс Пэй в мобильные приложения (Android и iOS).

Установка

Добавьте зависимость в pubspec.yaml:

dependencies:
  yandex_quick_pay: ^1.0.0

Затем:

flutter pub get

Быстрый старт

1. Инициализация в main() до runApp():

import 'package:yandex_quick_pay/yandex_quick_pay.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // Инициализация SDK
  await YandexQuickPay.initialize(
    config: const QuickPayConfig(
      merchantId: 'YOUR_MERCHANT_ID',
      environment: QuickPayEnvironment.sandbox,
    ),
    listener: QuickPaymentStateListener(
      onPaymentEnabledStateChanged: (isEnabled) {
        print('Быстрая оплата ${isEnabled ? "включена" : "выключена"}');
      },
      onSessionExpired: () {
        print('Платежная сессия истекла');
      },
      onPaymentResult: (result) {
        if (result is QuickPaySuccess) {
          print('Оплата успешна');
        } else if (result is QuickPayFailure) {
          print('Ошибка оплаты');
        }
      },
    ),
  );

  runApp(const MyApp());
}

2. Вызов нативной UI перед оплатой:

await YandexQuickPay.instance.initUi();

3. Виджеты для экрана настроек/оплаты:

• YandexPaymentMethodsWidget — список способов оплаты и управление быстрой оплатой.
• YandexActivePaymentMethodBadge — бейдж активного способа оплаты (например, на кнопке «Оплатить»).

Конфигурация

• QuickPayConfig: merchantId, environment (sandbox/production), locale, theme.
• QuickPayEnvironment: sandbox, production.

Deep links

Обработка возврата из приложения банка/Яндекс Пэй:

• Android: в AndroidManifest и в коде вызвать YandexQuickPay.instance.handleUserActivity(uri) или handleOpenURL(uri).
• iOS: в AppDelegate передать URL в YandexQuickPay.instance.handleOpenURL(url).

Требования

• Flutter 3.0+
• Dart 3.0+
• Android: API 24+ (Android 7.0)
• iOS: 15.0+

Сборка example-приложения

1. Сборка нативного Android SDK

Перед сборкой example-приложения необходимо собрать нативный Android SDK:

# Для debug-сборки
scripts/bundle_native_android_sdk.sh --build-type debug --with-init

# Для production-сборки
scripts/bundle_native_android_sdk.sh --build-type prod --with-init

2. Выбор окружения

Окружение задаётся через --dart-define=QUICKPAY_ENVIRONMENT при сборке. Доступные значения: sandbox, testing, production.

# Sandbox (по умолчанию для debug)
flutter run --dart-define=QUICKPAY_ENVIRONMENT=sandbox

# Testing
flutter run --dart-define=QUICKPAY_ENVIRONMENT=testing

# Production (по умолчанию для release)
flutter run --release --dart-define=QUICKPAY_ENVIRONMENT=production

3. Настройка в Android Studio

1. Откройте Run > Edit Configurations...
2. Выберите конфигурацию запуска Flutter или создайте новую
3. В поле Additional run args добавьте:

   --dart-define=QUICKPAY_ENVIRONMENT=sandbox
   

4. Нажмите Apply

Документация

Полная документация и описание API: pay.yandex.ru/docs.

Лицензия

Proprietary License — см. LICENSE.