Flutter支付集成插件monnify_flutter_sdk的使用

Flutter 插件 monnify_flutter_sdk 可以帮助你在 Flutter 应用程序中集成 Monnify 支付功能。此插件可以让你轻松地初始化支付，并处理与 Monnify 支付系统的交互。

开始使用

首先，在你的 pubspec.yaml 文件中添加 monnify_flutter_sdk 作为依赖项：

dependencies:
  monnify_flutter_sdk: ^版本号

然后运行 flutter pub get 来获取新的依赖项。

如何使用

1. 初始化

在你的应用程序中初始化插件。这一步通常在 initState 方法中完成。

import 'package:monnify_flutter_sdk/monnify_flutter_sdk.dart';

class _MyAppState extends State<MyApp> {

  [@override](/user/override)
  void initState() {
    super.initState();
    MonnifyFlutterSdk.initialize(
      'YOUR_API_KEY', 
      'CONTRACTCODE', 
      ApplicationMode.TEST
    );
  }
}

2. 初始化支付

创建一个 Transaction 对象并调用 initializePayment 方法来启动支付流程。

Future<void> initPayment() async {
  TransactionResponse transactionResponse = await MonnifyFlutterSdk.initializePayment(Transaction(
    2000,
    "NGN",
    "Customer Name",
    "mail.cus@tome.er",
    "PAYMENT_REF",
    "Description of payment",
    metaData: {
      "ip": "196.168.45.22",
      "device": "mobile_flutter"
      // 其他信息
    },
    paymentMethods: [PaymentMethod.CARD, PaymentMethod.ACCOUNT_TRANSFER],
    incomeSplitConfig: [
      SubAccountDetails("MFY_SUB_319452883968", 10.5, 500, true),
      SubAccountDetails("MFY_SUB_259811283666", 10.5, 1000, false)
    ]
  ));
}

参数说明

• Payment Methods: 指定交易级别的支付方式。
• Sub-Accounts: 在 incomeSplitConfig 中指定的账户将接收该交易的结算。
• MetaData: 是一个单层的映射，用于传递额外的信息。

返回值

TransactionResponse 类包含以下字段：

String paymentDate;
double amountPayable;
double amountPaid;
String paymentMethod;
String transactionStatus;
String transactionReference;
String paymentReference;

完整示例代码

以下是完整的示例代码，展示了如何在 Flutter 应用程序中使用 monnify_flutter_sdk 插件。

import 'package:flutter/material.dart';
import 'dart:async';
import 'dart:math';

import 'package:flutter/services.dart';
import 'package:monnify_flutter_sdk/monnify_flutter_sdk.dart';

void main() => runApp(MyApp());

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

class _MyAppState extends State<MyApp> {
  late BuildContext mContext;

  [@override](/user/override)
  void initState() {
    super.initState();
    initializeSdk();
  }

  Future<void> initializeSdk() async {
    try {
      if (await MonnifyFlutterSdk.initialize(
          'MK_TEST_G9YG93QQJA', '4551641593', ApplicationMode.TEST)) {
        _showToast("SDK initialized!");
      }
    } on PlatformException catch (e, s) {
      print("Error initializing sdk");
      print(e);
      print(s);

      _showToast("Failed to init sdk!");
    }
  }

  Future<void> initPayment() async {
    TransactionResponse transactionResponse;

    try {
      transactionResponse = await MonnifyFlutterSdk.initializePayment(Transaction(
        2000.0,
        "NGN",
        "Customer Name",
        "mail.cus@tome.er",
        getRandomString(15),
        "Description of payment",
        metaData: {
          "ip": "196.168.45.22",
          "device": "mobile"
        },
        paymentMethods: [PaymentMethod.CARD, PaymentMethod.ACCOUNT_TRANSFER]
      ));

      _showToast(
          transactionResponse.transactionStatus.toString() + "\n" +
          transactionResponse.paymentReference.toString() + "\n" +
          transactionResponse.transactionReference.toString() + "\n" +
          transactionResponse.amountPaid.toString() + "\n" +
          transactionResponse.amountPayable.toString() + "\n" +
          transactionResponse.paymentDate.toString() + "\n" +
          transactionResponse.paymentMethod.toString()
      );

    } on PlatformException catch (e, s) {
      print("Error initializing payment");
      print(e);
      print(s);

      _showToast("Failed to init payment!");
    }
  }

  String getRandomString(int length) {
    const _chars = 'AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz1234567890';
    Random _rnd = Random();

    return String.fromCharCodes(Iterable.generate(
        length, (_) => _chars.codeUnitAt(_rnd.nextInt(_chars.length))));
  }

  void _showToast(String message) {
    final scaffold = ScaffoldMessenger.of(mContext);
    scaffold.showSnackBar(
      SnackBar(
        content: Text(message),
        action: SnackBarAction(
            label: 'CLOSE', onPressed: scaffold.hideCurrentSnackBar),
      ),
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Monnify Plugin Sample'),
        ),
        body: Builder(
          builder: (context) {
            mContext = context;
            return Center(
              child: TextButton(
                child: Text("PAY"),
                onPressed: () => initPayment(),
              ),
            );
          },
        ),
      ),
    );
  }
}