Flutter支付处理插件sbp_payments的使用

Flutter支付处理插件sbp_payments的使用

sbp_payments 是一个帮助处理SBP支付链接并使用特定银行应用打开这些链接的Flutter插件。该插件支持iOS和Android平台。

使用

要使用此插件，在你的 pubspec.yaml 文件中添加 sbp_payments 作为依赖项。

安装

iOS

在你的 Info.plist 文件中添加以下条目以设置 LSApplicationQueriesSchemes：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>bank100000000000</string>
  <string>bank100000000001</string>
  ...
  <string>bank100000000999</string>
  <string>bank100000001000</string>
</array>

这一步是为了确保 UIApplication.shared.canOpenURL 方法可以正常工作。你可以直接复制粘贴所有行，从 示例文件 中获取。

更多信息可参见 Apple文档。

示例

以下是完整的示例代码，展示了如何使用 sbp_payments 插件来处理SBP支付链接。

import 'dart:async';
import 'dart:io';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:sbp_payments/sbp_payments.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _sbpLinkExample =
      'https://qr.nspk.ru/AS100001ORTF4GAF80KPJ53K186D9A3G?type=01&bank=100000000007&crc=0C8A';
  final _tinkoffSbpSchemeIOS = 'bank100000000004';
  final _tinkoffSbpSchemeAndroid = 'com.idamob.tinkoff.android';

  Future<void> chooseBankForPayment() async {
    bool? res;
    // 平台消息可能会失败，因此我们使用try/catch来捕获PlatformException。
    try {
      res = await SbpPayments.showBanks(_sbpLinkExample);
      print('chooseBankForPayment: 状态 $res');
    } on PlatformException catch (e) {
      print('打开SBP小部件失败。$e');
    }
  }

  Future<void> chooseBankForPaymentCustom() async {
    bool? res;
    // 平台消息可能会失败，因此我们使用try/catch来捕获PlatformException。
    try {
      res = await SbpPayments.showBanksCustom(_sbpLinkExample,
          backgroundColorCode: 0xFF291970, textColorCode: 0xFFFFFFFF);
      print('chooseBankForPayment: 状态 $res');
    } on PlatformException catch (e) {
      print('打开SBP小部件失败。$e');
    }
  }

  Future<void> openPaymentWithBank() async {
    bool? res;
    // 平台消息可能会失败，因此我们使用try/catch来捕获PlatformException。
    try {
      var scheme;
      if (Platform.isIOS) {
        scheme = _tinkoffSbpSchemeIOS;
      } else if (Platform.isAndroid) {
        scheme = _tinkoffSbpSchemeAndroid;
      } else {
        scheme = 'https://www.tinkoff.ru/';
      }
      res = await SbpPayments.openWithBank(scheme, _sbpLinkExample);
      print('openPaymentWithBank: 状态 $res');
    } on PlatformException catch (e) {
      print('打开银行失败。$e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          crossAxisAlignment: CrossAxisAlignment.stretch,
          children: [
            TextButton(
                onPressed: () async {
                  await chooseBankForPayment();
                },
                child: Text('选择银行并付款')),
            TextButton(
                onPressed: () async {
                  await chooseBankForPaymentCustom();
                },
                child: Text('选择银行并自定义设置付款')),
            TextButton(
                onPressed: () async {
                  await openPaymentWithBank();
                },
                child: Text('通过Tinkoff银行付款'))
          ],
        ),
      ),
    );
  }
}