upi_payments_india 是一个用于在 Flutter 应用中集成印度 UPI（统一支付接口）支付的插件。它允许用户通过 UPI 应用程序进行支付，如 Google Pay、PhonePe、Paytm 等。

1. 添加依赖

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

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

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

2. 导入插件

在你的 Dart 文件中导入插件：

import 'package:upi_payments_india/upi_payments_india.dart';

3. 初始化 UPI 支付

你可以使用 UpiPayments 类来初始化 UPI 支付。以下是一个简单的示例：

Future<void> initiateUpiPayment() async {
  // 创建 UpiPayments 实例
  UpiPayments upiPayments = UpiPayments();

  // 设置支付参数
  UpiPaymentRequest upiPaymentRequest = UpiPaymentRequest(
    payeeVpa: 'merchant@upi', // 收款方的 UPI ID
    payeeName: 'Merchant Name', // 收款方名称
    amount: '100.00', // 支付金额
    transactionRefId: 'TXN123456', // 交易参考ID
    transactionNote: 'Payment for order #123', // 交易备注
  );

  // 发起支付
  UpiPaymentResponse upiPaymentResponse = await upiPayments.initiateTransaction(upiPaymentRequest);

  // 处理支付结果
  if (upiPaymentResponse.status == UpiPaymentStatus.SUCCESS) {
    print('Payment successful: ${upiPaymentResponse.transactionId}');
  } else if (upiPaymentResponse.status == UpiPaymentStatus.FAILURE) {
    print('Payment failed: ${upiPaymentResponse.errorMessage}');
  } else if (upiPaymentResponse.status == UpiPaymentStatus.SUBMITTED) {
    print('Payment submitted: ${upiPaymentResponse.transactionId}');
  } else {
    print('Payment cancelled by user');
  }
}

4. 调用支付方法

你可以在按钮点击事件或其他用户交互中调用 initiateUpiPayment 方法：

ElevatedButton(
  onPressed: () {
    initiateUpiPayment();
  },
  child: Text('Pay via UPI'),
);

5. 处理支付结果

UpiPaymentResponse 对象包含了支付的结果信息。你可以根据 status 字段来判断支付是否成功、失败、提交或取消。

6. 权限和配置

确保在 AndroidManifest.xml 中添加必要的权限：

<uses-permission android:name="android.permission.INTERNET" />

7. 测试

在测试时，你可以使用测试 UPI ID 和金额来确保支付流程正常工作。

8. 注意事项

• 确保用户设备上安装了支持 UPI 的应用程序。
• 处理支付失败和取消的情况，提供适当的用户反馈。
• 在生产环境中使用真实的 UPI ID 和金额。

9. 插件文档

你可以查看插件的官方文档以获取更多信息和高级用法：upi_payments_india

10. 示例代码

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

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

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

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

Future<void> initiateUpiPayment() async {
  UpiPayments upiPayments = UpiPayments();

  UpiPaymentRequest upiPaymentRequest = UpiPaymentRequest(
    payeeVpa: 'merchant@upi',
    payeeName: 'Merchant Name',
    amount: '100.00',
    transactionRefId: 'TXN123456',
    transactionNote: 'Payment for order #123',
  );

  UpiPaymentResponse upiPaymentResponse = await upiPayments.initiateTransaction(upiPaymentRequest);

  if (upiPaymentResponse.status == UpiPaymentStatus.SUCCESS) {
    print('Payment successful: ${upiPaymentResponse.transactionId}');
  } else if (upiPaymentResponse.status == UpiPaymentStatus.FAILURE) {
    print('Payment failed: ${upiPaymentResponse.errorMessage}');
  } else if (upiPaymentResponse.status == UpiPaymentStatus.SUBMITTED) {
    print('Payment submitted: ${upiPaymentResponse.transactionId}');
  } else {
    print('Payment cancelled by user');
  }
}