paystack_pos_flutter 是一个用于在 Flutter 应用中集成 Paystack 支付功能的插件。Paystack 是一个流行的支付网关，广泛用于非洲地区的在线支付。通过 paystack_pos_flutter 插件，你可以轻松地在 Flutter 应用中实现支付功能。

1. 安装插件

首先，你需要在 pubspec.yaml 文件中添加 paystack_pos_flutter 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  paystack_pos_flutter: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 配置 Paystack

在使用 Paystack 之前，你需要在 Paystack 官网上注册一个账户，并获取你的 Public Key 和 Secret Key。这些密钥将用于初始化 Paystack 插件。

3. 初始化 Paystack

在你的 Flutter 应用中，首先需要初始化 Paystack 插件。通常，你可以在 main.dart 或某个初始化函数中进行初始化。

import 'package:paystack_pos_flutter/paystack_pos_flutter.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 Paystack
  PaystackPosFlutter.initialize(
    publicKey: 'your_public_key',
    secretKey: 'your_secret_key',
  );
  
  runApp(MyApp());
}

4. 发起支付

接下来，你可以在需要支付的地方调用 Paystack 的支付方法。通常，你需要提供以下信息：

• amount: 支付金额（以最小单位表示，例如 1000 表示 10.00 美元）。
• email: 用户的电子邮件地址。
• reference: 交易的唯一标识符。

import 'package:paystack_pos_flutter/paystack_pos_flutter.dart';

Future<void> makePayment() async {
  try {
    final response = await PaystackPosFlutter.chargeCard(
      amount: 1000, // 10.00 美元
      email: 'user@example.com',
      reference: 'unique_transaction_reference',
    );

    if (response.status == 'success') {
      // 支付成功
      print('Payment successful: ${response.message}');
    } else {
      // 支付失败
      print('Payment failed: ${response.message}');
    }
  } catch (e) {
    // 处理异常
    print('Error: $e');
  }
}

5. 处理支付结果

PaystackPosFlutter.chargeCard 方法会返回一个 PaystackResponse 对象，你可以通过检查 status 属性来判断支付是否成功。

6. 其他功能

paystack_pos_flutter 插件还支持其他功能，例如：

• 验证交易：你可以使用 verifyTransaction 方法来验证交易的状态。
• 获取交易列表：你可以使用 fetchTransactions 方法来获取用户的交易列表。

// 验证交易
final verificationResponse = await PaystackPosFlutter.verifyTransaction(
  reference: 'unique_transaction_reference',
);

// 获取交易列表
final transactions = await PaystackPosFlutter.fetchTransactions(
  email: 'user@example.com',
);

7. 注意事项

• 确保在支付过程中处理网络错误和用户取消支付的情况。
• 在生产环境中，不要将 Secret Key 硬编码在客户端代码中，应该通过后端服务来安全地处理支付请求。

8. 示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用中使用 paystack_pos_flutter 插件进行支付：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 Paystack
  PaystackPosFlutter.initialize(
    publicKey: 'your_public_key',
    secretKey: 'your_secret_key',
  );
  
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Paystack Payment Example'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              await makePayment();
            },
            child: Text('Make Payment'),
          ),
        ),
      ),
    );
  }
}

Future<void> makePayment() async {
  try {
    final response = await PaystackPosFlutter.chargeCard(
      amount: 1000, // 10.00 美元
      email: 'user@example.com',
      reference: 'unique_transaction_reference',
    );

    if (response.status == 'success') {
      // 支付成功
      print('Payment successful: ${response.message}');
    } else {
      // 支付失败
      print('Payment failed: ${response.message}');
    }
  } catch (e) {
    // 处理异常
    print('Error: $e');
  }
}