Flutter支付集成插件fastpay_merchant的使用

Flutter支付集成插件fastpay_merchant的使用

快速入门

要使用FastPay Flutter SDK，你需要先从FastPay获取商店ID和密码。这可以通过联系FastPay的官方支持渠道完成。

安装

在pubspec.yaml文件中添加以下依赖：

dependencies:
  fastpay_merchant: ^1.2.0
  # 处理来自FastPay钱包应用的回调（重定向）
  app_links: ^4.0.0  

注意：

• iOS 仅支持真实设备测试，模拟器不支持。

初始化FastPaySDK

参数说明

• Store ID：商户的商店ID以发起交易。
• Store Password：商户的商店密码以发起交易。
• Order ID：订单ID/账单编号，每次交易必须唯一。
• Amount：交易金额，例如：“1000”。
• IOS callback URI：当用户通过FastPay应用付款时，用于接收支付信息的iOS回调URI。
• Callback：SDK状态、消息、结果回调。SDK状态包括初始化、支付通过FastPay SDK、支付通过FastPay应用、取消、成功、失败等。

enum SDKStatus{    
  INIT,
  PAYMENT_WITH_FASTPAY_SDK,
  PAYMENT_WITH_FASTPAY_APP, 
  CANCEL, 
  SUCCESS, 
  FAILED
}

示例代码

以下是完整的示例代码，演示了如何在Flutter应用中集成FastPay支付插件。

示例代码：example/lib/main.dart

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

import 'package:app_links/app_links.dart';
import 'package:fastpay_merchant/fastpay_flutter_sdk.dart';
import 'package:fastpay_merchant/models/fastpay_payment_request.dart';
import 'package:flutter/material.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  AppLinks _appLinks = AppLinks();
  Uri? _deepLink;

  @override
  void initState() {
    super.initState();
    _initDeepLinks();
  }

  void _initDeepLinks() async {
    final appLinksStream = _appLinks.uriLinkStream;

    appLinksStream.listen((Uri? deepLink) {
      if (!mounted) return;
      setState(() {
        _deepLink = deepLink;
        _handleDeepLink(deepLink);
      });
    }).onError((err) {
      // 处理错误
    });

    // 检查应用启动时的初始深度链接
    _deepLink = await _appLinks.getInitialAppLink();
    if (_deepLink != null) {
      _handleDeepLink(_deepLink);
    }
  }

  void _handleDeepLink(Uri? deepLink) {
    if (deepLink != null) {
      if (deepLink.path == '/details') {
        Navigator.pushNamed(context, '/details', arguments: deepLink.queryParameters);
      }
      // 处理其他深度链接路径
    }
  }

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: '插件示例应用',
      home: LauncherScreen(),
    );
  }
}

class LauncherScreen extends StatefulWidget {
  const LauncherScreen({super.key});

  @override
  State<LauncherScreen> createState() => _LauncherScreenState();
}

class _LauncherScreenState extends State<LauncherScreen> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Fastpay SDK 测试'),
      ),
      body: Center(
        child: InkWell(
            onTap: ()async{
              Navigator.of(context).push(MaterialPageRoute(builder: (_) => const MyAppHomePage()));
            },
            child: Text('点击这里开始支付')
        ),
      ),
    );
  }
}

class MyAppHomePage extends StatefulWidget {
  const MyAppHomePage({super.key});

  @override
  State<MyAppHomePage> createState() => _MyAppHomePageState();
}

class _MyAppHomePageState extends State<MyAppHomePage> with WidgetsBindingObserver {
  StreamSubscription<Uri>? _linkSubscription;

  @override
  void initState() {
    super.initState();
    _handleIncomingIntent();
    FastpayFlutterSdk.instance.fastpayPaymentRequest = FastpayPaymentRequest(
      "******",       // (必需) 替换为您的实际商店ID
      "******",       // (必需) 替换为您的实际商店密码
      "450",          // 金额
      DateTime.now().microsecondsSinceEpoch.toString(), // 订单ID
      "appfpclientFastpayFlutterSdk", // iOS 回调URI
      false,          // 是否生产环境
      (status, message, {result}) {
        debugPrint('打印堆栈跟踪::消息：${message}');
        debugPrint('打印堆栈跟踪：${result.toString()}');
      },
    );
  }

  @override
  Widget build(BuildContext context) {
    FastpayFlutterSdk.instance.context = context;
    return Scaffold(
      appBar: AppBar(
        title: const Text('Fastpay SDK 测试'),
      ),
      body: Center(
        child: InkWell(
            onTap: ()async{
              Navigator.of(context).push(MaterialPageRoute(builder: (_) => const SdkInitializeScreen()));
            },
            child: Text('点击这里进行支付')
        ),
      ),
    );
  }

  Future<void> _handleIncomingIntent() async {
    final _appLinks = AppLinks();
    if(Platform.isAndroid){
      final uri = await _appLinks.getLatestAppLink();
      debugPrint("重定向URI：${uri?.queryParameters}");
      final allQueryParams = uri?.queryParameters;
      final status = allQueryParams?['status'];
      final orderId = allQueryParams?['order_id'];
      debugPrint("状态：$status, 订单ID：$orderId");
    }else if(Platform.isIOS){
      final appLink = await _appLinks.getInitialAppLink();
      if (appLink != null) {
        var uri = Uri.parse(appLink.toString());
        debugPrint('您可以根据需要从URL重定向');
      }
      _linkSubscription = _appLinks.uriLinkStream.listen((uriValue) {
        debugPrint('重定向URI：$uriValue');
        debugPrint('您可以监听任何URL更新');
        debugPrint('您可以根据需要从URL重定向');
      },onError: (err){
        debugPrint('错误：$err');
      },onDone: () {
        _linkSubscription?.cancel();
      },);
    }
  }
}

SDK回调URI（仅限iOS）

警告

这将重新启动整个应用程序，并从导航队列顶部的页面传递applinks数据。这意味着，从FastPay应用支付后，它会重定向回您的应用并附带数据。

// 使用app_links
import 'package:app_links/app_links.dart';

Future<void> _handleIncomingIntent() async {
  final _appLinks = AppLinks();
  final appLink = await _appLinks.getInitialAppLink();
  if (appLink != null) {
    var uri = Uri.parse(appLink.toString());
    debugPrint('您可以根据需要从URL重定向');
  }
  _linkSubscription = _appLinks.uriLinkStream.listen((uriValue) {
    debugPrint('重定向URI：$uriValue');
    debugPrint('您可以监听任何URL更新');
    debugPrint('您可以根据需要从URL重定向');
  },onError: (err){
    debugPrint('错误：$err');
  },onDone: () {
    _linkSubscription?.cancel();
  },);
}

iOS 设置

在info.plist文件中添加回调URI：

  <key>CFBundleURLTypes</key>
  <array>
  <dict>
  <key>CFBundleURLSchemes</key>
  <array>
  <string>appfpclientFastpayFlutterSdk</string> // 您从SDK初始化请求中给定的URI
  </array>
  </dict>
  </array>

回调URI通过应用深层链接结果

回调URI模式（成功）：appfpclientFastpayFlutterSdk/further/paths?status=success&transaction_id=XXXX&order_id=XXXX&amount=XXX&currency=XXX&mobile_number=XXXXXX&time=XXXX&name=XXXX
回调URI模式（失败）：appfpclientFastpayFlutterSdk/further/paths?status=failed&order_id=XXXXX