Как использовать нативный платежный сервис SberPay в кроссплатформенном приложении на Flutter

/** * Плагин для оплаты с использованием SberPay. Для работы нужен установленный Сбербанк (либо Сбол). */ class SberPayPlugin : FlutterPlugin, MethodCallHandler, ActivityAware {     private lateinit var channel: MethodChannel    private lateinit var binding: FlutterPluginBinding    private lateinit var activity: Activity    private lateinit var context: Context     /** Кнопка для управления оплатой **/    private lateinit var button: SPayButton     override fun onAttachedToEngine(flutterPluginBinding: FlutterPluginBinding) {        channel = MethodChannel(flutterPluginBinding.binaryMessenger, "sber_pay")        binding = flutterPluginBinding        context = flutterPluginBinding.applicationContext        channel.setMethodCallHandler(this)    }     override fun onMethodCall(call: MethodCall, result: Result) {        when (call.method) {            // Инициализация            "init" -> {                initialize(call, result)            }            // Проверка готовности к оплате            "isReadyForSPaySdk" -> {                /**                 * Метод для проверки готовности к оплате.                 * Зависит от переданного аргумента [env] при инициализации через метод [initialize]                 * (см. комментарий к методу). Запрос может выполняться долго.                 *                 * @return Если у пользователя нет установленного сбера в режимах                 * SPayStage.SandboxRealBankApp, SPayStage.prod - вернет false.                 */                result.success(button.isReadyForSPaySdk())            }            // Оплата            "payWithBankInvoiceId" -> {                showSberPaymentModal(call, result)            }             else -> {                result.notImplemented()            }        }    }     /**     * Метод для оплаты, в аргументы которого обязательно необходимо передать:     * @property apiKey ключ, выдаваемый по договору, либо создаваемый в личном кабинете;     * @property merchantLogin логин, выдаваемый по договору, либо создаваемый в личном кабинете;     * @property appPackage пакет вашего приложения;     * @property language использовано по умолчанию "RU";     * @property bankInvoiceId параметр, который получаем после запроса для регистрации заказа в     * шлюзе Сбера.     */    private fun showSberPaymentModal(call: MethodCall, result: Result) {        val args = call.arguments as Map<*, *>        var responseSent = false // Флаг для отслеживания отправки ответа        var hasError = false // Флаг для отслеживания отправки ошибки         try {            val apiKey = args["apiKey"] as String            val merchantLogin = args["merchantLogin"] as String            val bankInvoiceId = args["bankInvoiceId"] as String            val appPackage = context.packageName            val language = "RU"             if (!responseSent) {                button.payWithBankInvoiceId(apiKey, merchantLogin, bankInvoiceId, appPackage, language) { response ->                    when (response) {                        // Оплата не завершена                        is PaymentResult.Processing ->                            result.success("processing")                        // Оплата прошла успешно                        is PaymentResult.Success ->                            result.success("success")                        // Оплата прошла с ошибкой                        is PaymentResult.Error -> {                            if (!hasError) {                                hasError = true                                if (response.merchantError is MerchantError.SdkClosedByUser) {                                    result.success("cancel")                                    return@payWithBankInvoiceId                                }                                result.error("-", "MerchantError", response.merchantError?.description                                        ?: "Ошибка выполнения оплаты")                                return@payWithBankInvoiceId                            }                        }                    }                    responseSent = true                }            }        } catch (error: Exception) {            result.error("-", error.localizedMessage, error.message)        }    }     /**     * Метод инициализации, выполняется перед стартом приложения.     * [env], полученный из FLutter, Тесты со всеми типами [env] лучше всего проводить на реальном     * устройстве. Он определяет тип запуска:     *     * @property SPayStage.SandboxRealBankApp устройство с установленным Сбером;     * @property SPayStage.SandBoxWithoutBankApp устройство без Сбера;     * @property SPayStage.prod устройство с установленным Сбером, работает с продовыми данными.     */    private fun initialize(call: MethodCall, result: Result) {        val args = call.arguments as Map<*, *>        val sPayStage = when (args["env"] as String) {            "sandboxRealBankApp" -> SPayStage.SandboxRealBankApp            "sandboxWithoutBankApp" -> SPayStage.SandBoxWithoutBankApp            else -> {                SPayStage.Prod            }        }        // Оплата частями        val enableBnpl = args["enableBnpl"] as Boolean? ?: false         try {            SPaySdkApp.getInstance().initialize(application = activity.application, stage = sPayStage, enableBnpl = enableBnpl)            result.success(true)        } catch (e: Exception) {            result.error("-", e.localizedMessage, e.message)        }    }     override fun onDetachedFromEngine(binding: FlutterPluginBinding) {        channel.setMethodCallHandler(null)    }     override fun onAttachedToActivity(activityBinding: ActivityPluginBinding) {        activity = activityBinding.activity        button = SPayButton(activity, null)    }     override fun onReattachedToActivityForConfigChanges(activityBinding: ActivityPluginBinding) {        activity = activityBinding.activity        button = SPayButton(activity, null)    }     override fun onDetachedFromActivity() {}     override fun onDetachedFromActivityForConfigChanges() {} }

// Плагин для оплаты с использованием SberPay. public class SberPayPlugin: NSObject, FlutterPlugin {     public static func register(with registrar: FlutterPluginRegistrar) {        let channel = FlutterMethodChannel(name: "sber_pay", binaryMessenger: registrar.messenger())        let instance = SberPayPlugin()        registrar.addMethodCallDelegate(instance, channel: channel)        /// Создание [addApplicationDelegate] для перехода по диплинку обратно в приложение        registrar.addApplicationDelegate(instance)    }     public func application(_ app: UIApplication,open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {        /// Если при открытии приложения с диплинком если он содержит хост "spay", то такой диплинк        /// попадает в нативный плагин. Таким образом работает возврат в приложение и получение данных нативным        /// SDK от приложения Сбербанк онлайн/СБОЛ        if  url.host == "spay" {            SPay.getAuthURL(url)        }         return true    }     public func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {        switch call.method {            /// Инициализация        case "init":            initialize(call, result:result)            /// Проверка готовности к оплате        case "isReadyForSPaySdk":            /**             Метод для проверки готовности к оплате.             Зависит от переданного аргумента [env] при инициализации через метод [initialize]             (см. комментарий к методу). Запрос может выполняться долго.              - Returns Если у пользователя нет установленного сбера в режимах SEnvironment.sandboxRealBankApp,             SEnvironment.prod - вернет false.             */            result(SPay.isReadyForSPay)            // Оплата        case "payWithBankInvoiceId":            payWithBankInvoiceId(call, result: result)        default:            result(FlutterMethodNotImplemented)        }    }     /**     Метод для оплаты, в аргументы которого обязательно необходимо передать:     - Parameter apiKey ключ, выдаваемый по договору, либо создаваемый в личном кабинете;     - Parameter merchantLogin логин, выдаваемый по договору, либо создаваемый в личном кабинете;     - Parameter bankInvoiceId параметр, который получаем после запроса для регистрации заказа в     шлюзе Сбера.     - Parameter redirectUri диплинк обратно в приложение после перехода в Сбербанк     */    private func payWithBankInvoiceId(_ call: FlutterMethodCall, result: @escaping FlutterResult) {        guard let args = call.arguments as? [String: Any],              let apiKey = args["apiKey"] as? String,              let merchantLogin = args["merchantLogin"] as? String,              let bankInvoiceId = args["bankInvoiceId"] as? String,              let redirectUri = args["redirectUri"] as? String        else {            result(FlutterError(code: "INVALID_ARGUMENTS", message: "Invalid arguments", details: nil))            return        }         if bankInvoiceId.count != 32 {            result(FlutterError(code: "-", message: "MerchantError", details: "Длина bankInvoiceId должна быть 32 символа"))            return        }         guard let topController = getTopViewController() else {            result(FlutterError(code: "PluginError", message: "SberPay: Failed to implement controller", details: nil))            return        }         let request = SBankInvoicePaymentRequest(            merchantLogin: merchantLogin,            bankInvoiceId: bankInvoiceId,            language: "RU",            redirectUri: redirectUri,            apiKey: apiKey)         SPay.payWithBankInvoiceId(with: topController, paymentRequest: request) { state, info  in            switch state {            case .success:                result("success")            case .waiting:                result("processing")            case .cancel:                result("cancel")            case .error:                result(FlutterError(code: "-", message: "Ошибка оплаты", details: info))            @unknown default:                result(FlutterError(code: "-", message: "Неопределенная ошибка", details: info))            }        }    }     /**     Метод инициализации, выполняется перед стартом приложения.     [env], полученный из FLutter, Тесты со всеми типами [env] лучше всего проводить на реальном устройстве. Он     определяет тип запуска:      - Parameter SEnvironment.sandboxRealBankApp устройство с установленным Сбером;     - Parameter SEnvironment.sandboxWithoutBankApp устройство без Сбера;     - Parameter SEnvironment.prod устройство с установленным Сбером, работает с продовыми данными.     - Parameter enableBnpl Функционал Оплата частями     */    private func initialize(_ call: FlutterMethodCall, result: @escaping FlutterResult) {        guard let args = call.arguments as? [String: Any],              let env = args["env"] as? String        else {            result(FlutterError(code: "INVALID_ARGUMENTS", message: "Invalid arguments", details: nil))            return        }         let enableBnpl = args["enableBnpl"] as? Bool ?? false         let sPayStage: SEnvironment        switch env {        case "sandboxRealBankApp":            sPayStage = .sandboxRealBankApp        case "sandboxWithoutBankApp":            sPayStage = .sandboxWithoutBankApp        default:            sPayStage = .prod        }         SPay.setup(bnplPlan: enableBnpl, environment: sPayStage)        result(true)    }     private func getTopViewController() -> UIViewController? {        var topController = UIApplication.shared.keyWindow?.rootViewController         while let presentedViewController = topController?.presentedViewController {            topController = presentedViewController        }         return topController    } }

/// Плагин для отображения нативной кнопки SberPay SDK /// /// Все исключения (Exceptions) приходящие из методов этого класса должны /// обрабатываться уровнем выше. class SberPayPlugin {  static const methodChannel = MethodChannel('sber_pay');   /// Инициализация SberPay SDK.  ///  /// Необходимо выполнить для начала работы с библиотекой.  /// На платформе Android этот метод является асинхронным, однако у  /// него нет API (коллбека) для выполнения кода после завершения  /// инициализации.  ///  /// * [env] - среда запуска, которая определяется через [SberPayEnv].  /// * [enableBnpl] - функционал оплаты частями  static Future<bool> initSberPay({    required String env,    bool? enableBnpl,  }) async {    final result = await methodChannel.invokeMethod<bool>('init', {      'env': env,      'enableBnpl': enableBnpl,    });    return result ?? false;  }   /// Метод для проверки готовности к оплате.  ///  /// Зависит от переданного аргумента [env] при инициализации через метод  /// [initSberPay] (см. комментарий к методу).  ///  /// Запрос может выполняться долго, поэтому здесь стоит искусственная  /// задержка, чтобы дождаться инициализации SDK.  ///  /// Если у пользователя нет установленного сбера в режимах  /// [SberPayEnv.sandboxRealBankApp], [SberPayEnv.prod] - вернет false.  static Future<bool> isReadyForSPaySdk() async {    final result = await methodChannel.invokeMethod<bool>('isReadyForSPaySdk');    if (result == null || result == false) {      await Future.delayed(        const Duration(seconds: 2),        () async {          return await methodChannel.invokeMethod<bool>('isReadyForSPaySdk');        },      );    }    return result ?? false;  }   /// Метод оплаты через SberPay SDK.  /// * [apiKey] - ключ, выдаваемый по договору, либо создаваемый в личном  /// кабинете;  /// * [merchantLogin] - логин, выдаваемый по договору, либо создаваемый в  /// личном кабинете;  /// * [bankInvoiceId] - параметр, который получаем после запроса для  /// регистрации заказа в шлюзе Сбера.  /// * [redirectUri] - диплинк для перехода обратно в приложение после открытия  /// Сбербанка (только на iOS).  ///  /// Возвращает статус оплаты [SberPayPaymentStatus]  static Future<SberPayPaymentStatus> payWithBankInvoiceId({    required String apiKey,    required String merchantLogin,    required String bankInvoiceId,    required String redirectUri,  }) async {    final result = await methodChannel.invokeMethod<String>(      'payWithBankInvoiceId',      {        'apiKey': apiKey,        'merchantLogin': merchantLogin,        'bankInvoiceId': bankInvoiceId,        'redirectUri': redirectUri,      },    );    return SberPayPaymentStatus.fromString(result);  } }

/// Необходимо указать по данным из договора const _apiKey = ''; const _merchantLogin = '';  /// Диплинк на переход в приложение const _redirectUri = 'sbersdk://spay';  void main() => runApp(const SberPayExampleApp());  class SberPayExampleApp extends StatefulWidget {  const SberPayExampleApp({super.key});   @override  State<SberPayExampleApp> createState() => _SberPayExampleAppState(); }  class _SberPayExampleAppState extends State<SberPayExampleApp> {  late final TextEditingController _controller;  late String _paymentStatus;  late bool _isPluginLoading;  late bool _isAppReadyForPay;  late bool _isPluginInitialized;  late SberPayEnv _selectedInitType;  late Color _color;   @override  void initState() {    super.initState();    _controller = TextEditingController();    _paymentStatus = '';    _selectedInitType = SberPayEnv.sandboxWithoutBankApp;    _isPluginLoading = false;    _isAppReadyForPay = false;    _isPluginInitialized = false;    _color = Colors.grey;    _readyForPay();  }   Future<void> _readyForPay() async {    setState(() => _isPluginLoading = true);    _isPluginInitialized = await SberPayPlugin.initSberPay(      env: _selectedInitType.name,    );    if (mounted) setState(() {});     _isAppReadyForPay = await SberPayPlugin.isReadyForSPaySdk();    if (!_isAppReadyForPay) {      _isAppReadyForPay = await SberPayPlugin.isReadyForSPaySdk();    }    if (mounted) setState(() => _isPluginLoading = false);  }   void _setEnv(SberPayEnv env) {    _selectedInitType = env;    _paymentStatus = '';    _color = Colors.grey;    _readyForPay();  }   @override  void dispose() {    _controller.dispose();    super.dispose();  }   @override  Widget build(BuildContext context) {    return MaterialApp(      theme: ThemeData(        colorScheme: ColorScheme.fromSeed(seedColor: const Color(0xFF21A038)),        useMaterial3: true,      ),      home: Scaffold(        appBar: AppBar(          title: const Text('SberPay plugin example'),          backgroundColor: const Color(0xFF21A038),          centerTitle: true,        ),        body: Builder(          builder: (context) {            return Padding(              padding: const EdgeInsets.all(8.0),              child: SingleChildScrollView(                child: Column(                  mainAxisSize: MainAxisSize.min,                  children: [                    Table(                        border: TableBorder.all(),                        defaultVerticalAlignment:                            TableCellVerticalAlignment.middle,                        children: [                          _tableRowWrapper(                            'Тип запуска',                            Column(                              children: [                                ChoiceChip(                                  label: const Text('Прод'),                                  selected:                                      _selectedInitType == SberPayEnv.prod,                                  onSelected: (_) => _setEnv(SberPayEnv.prod),                                ),                                const SizedBox(                                  width: 10,                                ),                                ChoiceChip(                                  label: const Text('Песочница/Банк'),                                  selected: _selectedInitType ==                                      SberPayEnv.sandboxRealBankApp,                                  onSelected: (_) => _setEnv(                                    SberPayEnv.sandboxRealBankApp,                                  ),                                ),                                const SizedBox(                                  width: 10,                                ),                                ChoiceChip(                                  label: const Text('Песочница'),                                  selected: _selectedInitType ==                                      SberPayEnv.sandboxWithoutBankApp,                                  onSelected: (_) => _setEnv(                                    SberPayEnv.sandboxWithoutBankApp,                                  ),                                ),                              ],                            ),                          ),                          _tableRowWrapper(                            'Плагин проинициализирован',                            Text(_isPluginLoading                                ? 'Загрузка'                                : _isPluginInitialized                                    ? "ДА"                                    : "НЕТ"),                          ),                          _tableRowWrapper(                            'Оплата доступна',                            Text(_isPluginLoading                                ? 'Загрузка'                                : _isAppReadyForPay                                    ? "ДА"                                    : "НЕТ"),                          ),                          _tableRowWrapper(                            'Статус операции оплаты',                            SizedBox(                              height: 80,                              child: Row(                                children: [                                  CircleAvatar(                                    backgroundColor: _color,                                    radius: 10.0,                                  ),                                  Flexible(                                    child: Text(                                      _paymentStatus.isEmpty                                          ? "Оплата не производилась"                                          : _paymentStatus,                                      textAlign: TextAlign.center,                                    ),                                  )                                ],                              ),                            ),                          ),                        ]),                    const SizedBox(height: 16),                    Padding(                      padding: const EdgeInsets.symmetric(horizontal: 16),                      child: TextField(                        controller: _controller,                        textInputAction: TextInputAction.done,                        decoration: InputDecoration(                          hintText: 'Введите bankInvoiceID',                          suffixIcon: GestureDetector(                            onTap: () {                              _controller.clear();                              _color = Colors.grey;                              setState(() => _paymentStatus = '');                            },                            child: const Icon(Icons.close, size: 32),                          ),                        ),                      ),                    ),                    const SizedBox(height: 16),                    Padding(                      padding: const EdgeInsets.symmetric(horizontal: 16),                      child: _isPluginLoading                          ? Container(                              height: 48,                              decoration: BoxDecoration(                                color: const Color(0xFF21A038),                                borderRadius: BorderRadius.circular(12),                              ),                              child: const Center(                                child: CircularProgressIndicator(                                  color: Colors.white,                                ),                              ),                            )                          : SberPayButton(                              onPressed: () async {                                if (_apiKey.isEmpty || _merchantLogin.isEmpty) {                                  ScaffoldMessenger.of(context).showSnackBar(                                    const SnackBar(                                      content: Text(                                        'Не заданы apiKey и/или merchantLogin',                                      ),                                      duration: Duration(seconds: 2),                                    ),                                  );                                  return;                                }                                if (_controller.text.isEmpty) {                                  ScaffoldMessenger.of(context).showSnackBar(                                    const SnackBar(                                      content: Text('Введите bankInvoiceID'),                                      duration: Duration(seconds: 2),                                    ),                                  );                                } else {                                  try {                                    final result = await SberPayPlugin                                        .payWithBankInvoiceId(                                      apiKey: _apiKey,                                      merchantLogin: _merchantLogin,                                      bankInvoiceId: _controller.text,                                      redirectUri: _redirectUri,                                    );                                    switch (result) {                                      case SberPayPaymentStatus.success:                                        _color = Colors.green;                                        _paymentStatus =                                            'Оплата прошла успешно';                                        break;                                      case SberPayPaymentStatus.processing:                                        _color = Colors.yellow;                                        _paymentStatus =                                            'Необходимо проверить статус оплаты';                                        break;                                      case SberPayPaymentStatus.cancel:                                        _color = Colors.blue;                                        _paymentStatus =                                            'Пользователь отменил оплату';                                        break;                                      case SberPayPaymentStatus.unknown:                                        _color = Colors.purple;                                        _paymentStatus =                                            'Неизвестное состояние';                                    }                                    setState(() {});                                  } on PlatformException catch (e) {                                    setState(                                      () {                                        _color = Colors.red;                                        _paymentStatus = e.details ?? '';                                      },                                    );                                  }                                }                              },                            ),                    ),                  ],                ),              ),            );          },        ),      ),    );  }   TableRow _tableRowWrapper(String title, Widget secondChild) {    return TableRow(      children: [        TableCell(child: Text(title, textAlign: TextAlign.center)),        Padding(          padding: const EdgeInsets.all(4.0),          child: Center(child: secondChild),        ),      ],    );  } }