Flutter插件easebuzz_flutter的安装及使用方法详解

Flutter 插件用于 Easebuzz SDK。通过此插件，您可以轻松地在 Flutter 应用程序中集成 Easebuzz 支付网关。

• 开始使用
• 前置条件
• 安装
• 使用
• 示例代码

开始使用

此 Flutter 插件是基于我们的 Android 和 iOS SDK 的封装，提供了将 Easebuzz 支付网关集成到 Flutter 应用程序的一种简便方式。要了解 Easebuzz 支付流程及其实现，请参阅官方文档：Easebuzz 文档。

前置条件

在进行集成之前，请确保以下条件已经满足：

商户注册

• 创建一个商户账户，并通过 Easebuzz 注册门户 完成注册流程。

测试环境凭据

• 在您的注册邮箱中会收到测试凭据。这些凭据使您能够在安全的沙箱环境中测试支付功能，确保不会发生真实的金融交易。
• 在充分测试后，用生产环境密钥替换测试密钥以处理实际支付。

安装

该插件可在 pub.dev 上找到。

要在您的 Flutter 项目中集成 easebuzz_flutter，请在 pubspec.yaml 文件中添加以下依赖项：

easebuzz_flutter: ^0.0.1

或者运行以下命令：

flutter pub add easebuzz_flutter

添加依赖项后，运行以下命令获取包：

flutter pub get

使用

要集成 Easebuzz 支付功能，请遵循以下步骤：

导入包

import 'package:easebuzz_flutter/easebuzz_flutter.dart';

初始化插件

创建插件实例并定义支付响应变量：

final _easebuzzFlutterPlugin = EasebuzzFlutter();
String _paymentResponse = 'No payment response yet';

实现支付功能

使用以下方法发起支付：

// 使用 Easebuzz 插件发起支付的方法
Future<void> initiatePayment() async {
  String accessKey = "Access key generated by the Initiate Payment API";
  String payMode = "test"; // 可以是 'test' 或 'production'
  try {
    // 调用平台方法以发起支付
    final paymentResponse = await _easebuzzFlutterPlugin.payWithEasebuzz(accessKey, payMode);

    setState(() {
      _paymentResponse = paymentResponse.toString(); // 存储并显示响应
    });
  } on PlatformException catch (e) {
    setState(() {
      _paymentResponse = "Payment failed: ${e.message}";
    });
  }
}

示例代码可以在 example/lib/main.dart 中找到。

示例代码

以下是展示如何集成 initiatePayment 方法的一个示例小部件：

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

class CheckoutPaymentPage extends StatefulWidget {
  [@override](/user/override)
  _PaymentScreenState createState() => _PaymentScreenState();
}

class _PaymentScreenState extends State<CheckoutPaymentPage> {
  final _easebuzzFlutterPlugin = EasebuzzFlutter();
  String _paymentResponse = 'No payment response yet';

  Future<void> initiatePayment() async {
    String accessKey = "Access key generated by the Initiate Payment API";
    String payMode = "test"; // 用于测试模式；使用 "production" 进行生产模式
    try {
      final paymentResponse = await _easebuzzFlutterPlugin.payWithEasebuzz(accessKey, payMode);
      setState(() {
        _paymentResponse = "Payment successful: $paymentResponse";
      });
    } on PlatformException catch (e) {
      setState(() {
        _paymentResponse = "Payment failed: ${e.message}";
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Easebuzz Payment'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(_paymentResponse),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: initiatePayment,
              child: Text('Initiate Payment'),
            ),
          ],
        ),
      ),
    );
  }
}