airpay_package 是一个用于在 Flutter 应用中集成 AirPay 支付功能的插件。以下是如何使用 airpay_package 的基本步骤：

1. 添加依赖

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

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

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

2. 导入包

在你的 Dart 文件中导入 airpay_package：

import 'package:airpay_package/airpay_package.dart';

3. 初始化 AirPay

在使用 AirPay 之前，你需要进行初始化。通常，你可以在 main 函数中或应用的启动阶段进行初始化：

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 AirPay
  AirPay.initialize(
    apiKey: 'YOUR_API_KEY',
    environment: AirPayEnvironment.sandbox, // 或 AirPayEnvironment.production
  );

  runApp(MyApp());
}

4. 创建支付请求

创建一个支付请求并启动支付流程。你可以使用 AirPay.createPayment 方法来创建支付请求：

void initiatePayment() async {
  try {
    final paymentResponse = await AirPay.createPayment(
      amount: 1000, // 支付金额，单位是分
      currency: 'INR', // 货币类型
      orderId: 'ORDER12345', // 订单ID
      customerName: 'John Doe', // 客户姓名
      customerEmail: 'john.doe@example.com', // 客户邮箱
      customerPhone: '1234567890', // 客户电话
    );

    // 处理支付响应
    if (paymentResponse.status == 'success') {
      print('Payment successful: ${paymentResponse.transactionId}');
    } else {
      print('Payment failed: ${paymentResponse.errorMessage}');
    }
  } catch (e) {
    print('Error occurred: $e');
  }
}

5. 处理支付回调

在支付完成后，AirPay 会返回支付结果。你可以根据支付结果来更新订单状态或向用户显示支付结果。

6. 监听支付状态（可选）

如果你需要监听支付状态的变化，可以使用 AirPay.onPaymentStatusChanged 来监听支付状态的变化：

void listenToPaymentStatus() {
  AirPay.onPaymentStatusChanged.listen((paymentStatus) {
    if (paymentStatus.status == 'success') {
      print('Payment successful: ${paymentStatus.transactionId}');
    } else {
      print('Payment failed: ${paymentStatus.errorMessage}');
    }
  });
}

7. 处理支付结果

在支付完成后，你可以根据支付结果来更新订单状态或向用户显示支付结果。通常，你可以在支付成功的回调中更新订单状态，并在支付失败时提示用户重新尝试。

8. 测试支付

在开发阶段，你可以使用 AirPay 的沙盒环境进行测试。确保在发布应用之前将环境切换为生产环境。

9. 发布应用

在完成测试并确保支付功能正常工作后，你可以将应用发布到应用商店。

注意事项

• 确保在发布应用之前将 AirPayEnvironment 切换为 production。
• 处理支付结果时，确保更新订单状态并提供相应的用户反馈。
• 确保你的 API 密钥和其他敏感信息的安全性，避免泄露。

参考文档

有关 airpay_package 的更多信息，请参考官方文档或插件的 GitHub 页面。

示例代码

以下是一个完整的示例代码：

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 AirPay
  AirPay.initialize(
    apiKey: 'YOUR_API_KEY',
    environment: AirPayEnvironment.sandbox, // 或 AirPayEnvironment.production
  );

  runApp(MyApp());
}

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

  void initiatePayment() async {
    try {
      final paymentResponse = await AirPay.createPayment(
        amount: 1000, // 支付金额，单位是分
        currency: 'INR', // 货币类型
        orderId: 'ORDER12345', // 订单ID
        customerName: 'John Doe', // 客户姓名
        customerEmail: 'john.doe@example.com', // 客户邮箱
        customerPhone: '1234567890', // 客户电话
      );

      // 处理支付响应
      if (paymentResponse.status == 'success') {
        print('Payment successful: ${paymentResponse.transactionId}');
      } else {
        print('Payment failed: ${paymentResponse.errorMessage}');
      }
    } catch (e) {
      print('Error occurred: $e');
    }
  }
}