Flutter支付集成插件fincra_payment的使用

Fincra Payment Package

一个用于集成Fincra支付结算的Flutter包，使开发者能够通过借记卡和信用卡进行支付，并在支付成功后提供自定义网络调用的钩子。

特性

• 轻松集成Fincra支付API。
• 支持通过借记卡和信用卡付款。
• 支付成功后的自定义网络调用钩子。
• 可定制的支付流程以满足各种应用需求。

开始使用

前提条件

在使用此包之前，请确保已具备以下条件：

1. 已设置好Flutter项目。如果没有，请运行以下命令创建并进入项目：

   flutter create my_flutter_app
   cd my_flutter_app
   

2. 拥有Fincra账户及必要的API密钥。您可以在此处注册账户。

安装

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

dependencies:
  fincra_payment: ^1.0.0

然后运行以下命令以获取该包：

flutter pub get

使用方法

以下是一个简单的示例，展示如何使用Fincra支付包：

import 'package:fincra_payment/fincra_payment.dart';
import 'package:flutter/material.dart';

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

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

  // 应用程序的根组件
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Fincra Payment'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            FincraCheckout.launchFincra(
              context,
              publicKey: "******************************", // 测试环境使用测试密钥，生产环境使用正式密钥
              amount: '100', // 支付金额（单位为分）
              name: "Ayanfe Afolabi", // 用户姓名
              phoneNumber: '+2347031276982', // 用户电话号码
              currency: "NGN", // 币种
              email: 'ayanfesolutions@gmail.com', // 用户邮箱
              feeBearer: "customer", // 支付手续费承担方："customer" 或 "buyer"
              onSuccess: (data) async {
                print('Payment Successful on test mode'); // 支付成功后的回调
                // 在此处执行支付成功后的逻辑
              },
              onError: (data) {
                print('Payment Failed'); // 支付失败时的回调
              },
              onClose: () {
                Navigator.of(context).pop(); // 关闭支付窗口
                print('Payment Close'); // 支付关闭时的回调
              },
            );
          },
          child: const Text('Make Payment'), // 按钮文本
        ),
      ),
    );
  }
}