paydala_flutter_widget 是一个用于集成支付功能的 Flutter 插件。使用该插件，你可以轻松地在 Flutter 应用中集成各种支付方式。以下是如何使用 paydala_flutter_widget 的基本步骤：

1. 添加依赖

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

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

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

2. 导入包

在你的 Dart 文件中导入 paydala_flutter_widget 包：

import 'package:paydala_flutter_widget/paydala_flutter_widget.dart';

3. 初始化支付模块

在使用支付功能之前，你需要初始化支付模块。通常，这需要在应用启动时完成：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化支付模块
  await PaydalaFlutterWidget.initialize(
    apiKey: "YOUR_API_KEY",  // 替换为你的API Key
    environment: Environment.sandbox,  // 使用沙盒环境进行测试
  );
  
  runApp(MyApp());
}

4. 创建支付订单

在触发支付之前，你需要创建一个支付订单。你可以通过调用 PaydalaFlutterWidget.createOrder 方法来实现：

Future<void> createOrder() async {
  try {
    final order = await PaydalaFlutterWidget.createOrder(
      amount: 100.0,  // 订单金额
      currency: "USD",  // 货币类型
      description: "Test Payment",  // 订单描述
    );
    
    print("Order created: ${order.orderId}");
  } catch (e) {
    print("Failed to create order: $e");
  }
}

5. 发起支付

创建订单后，你可以使用 PaydalaFlutterWidget.launchPayment 方法来发起支付：

Future<void> launchPayment() async {
  try {
    final paymentResult = await PaydalaFlutterWidget.launchPayment(
      orderId: "YOUR_ORDER_ID",  // 替换为你的订单ID
      paymentMethod: PaymentMethod.creditCard,  // 选择支付方式
    );
    
    if (paymentResult.status == PaymentStatus.success) {
      print("Payment successful: ${paymentResult.transactionId}");
    } else {
      print("Payment failed: ${paymentResult.errorMessage}");
    }
  } catch (e) {
    print("Failed to launch payment: $e");
  }
}

6. 处理支付结果

支付完成后，你可以根据 paymentResult 来处理支付结果。通常，你需要更新订单状态或通知用户支付结果。

7. 其他功能

paydala_flutter_widget 可能还提供了其他功能，如查询订单、取消订单等。你可以根据插件文档来使用这些功能。

8. 调试和测试

在开发过程中，建议使用沙盒环境进行测试。确保你正确处理了各种异常情况，并提供了用户友好的错误提示。

9. 发布应用

在发布应用之前，确保你已经切换到生产环境，并使用了正确的 API Key 和其他配置。

await PaydalaFlutterWidget.initialize(
  apiKey: "YOUR_PRODUCTION_API_KEY",
  environment: Environment.production,
);

10. 参考文档

如果你在使用过程中遇到问题，可以参考 paydala_flutter_widget 的官方文档，或者查看插件的示例代码。

示例代码

以下是一个简单的示例，展示了如何在 Flutter 应用中集成 paydala_flutter_widget：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  await PaydalaFlutterWidget.initialize(
    apiKey: "YOUR_API_KEY",
    environment: Environment.sandbox,
  );
  
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: PaymentScreen(),
    );
  }
}

class PaymentScreen extends StatelessWidget {
  Future<void> _createAndLaunchPayment() async {
    try {
      final order = await PaydalaFlutterWidget.createOrder(
        amount: 100.0,
        currency: "USD",
        description: "Test Payment",
      );
      
      final paymentResult = await PaydalaFlutterWidget.launchPayment(
        orderId: order.orderId,
        paymentMethod: PaymentMethod.creditCard,
      );
      
      if (paymentResult.status == PaymentStatus.success) {
        print("Payment successful: ${paymentResult.transactionId}");
      } else {
        print("Payment failed: ${paymentResult.errorMessage}");
      }
    } catch (e) {
      print("Failed to process payment: $e");
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Paydala Payment'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _createAndLaunchPayment,
          child: Text('Pay Now'),
        ),
      ),
    );
  }
}