Flutter安全支付插件safexpay的使用

Flutter安全支付插件safexpay的使用

本指南将帮助你了解如何在Flutter项目中集成和使用safexpay插件来实现安全支付功能。我们将通过一个简单的示例来演示如何初始化插件、设置支付参数并处理支付结果。

获取开始

首先,确保你已经安装了Flutter环境,并且可以创建一个新的Flutter项目。如果你还没有安装Flutter,请访问Flutter官方文档获取安装指南。

配置safexpay插件

在你的pubspec.yaml文件中添加safexpay依赖:

dependencies:
  safexpay: ^1.0.0 # 请根据实际情况替换版本号

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

初始化插件

在你的主应用类中初始化safexpay插件并设置商户信息:

import 'dart:async';
import 'dart:math';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:safexpay/constants/strings.dart';
import 'package:safexpay/constants/utility.dart';
import 'package:safexpay/safexpay.dart';

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

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

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
    MerchantConstants.setDetails(
        mId: 'HERE-MERCHANT-ID',
        mKey: 'HERE-MERCHANT-KEY',
        aggId: 'HERE-AGGREGATOR-ID',
        environment: Environment.PRODUCTION); //Environment.PRODUCTION
  }

  // 平台消息是异步的,因此我们在异步方法中初始化。
  Future<void> initPlatformState() async {
    String platformVersion;
    // 平台消息可能会失败,所以我们使用try/catch来捕获PlatformException。
    // 我们也处理消息可能返回null的情况。
    try {
      platformVersion = await Safexpay.platformVersion ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // 如果在异步平台消息飞行时小部件被从树中移除,则我们希望丢弃回复而不是调用setState来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
        debugShowCheckedModeBanner: false, home: UserInputPage());
  }
}

用户输入页面

在这个页面中,用户可以输入金额并点击按钮进行支付:

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

class _UserInputPageState extends State<UserInputPage> implements SafeXPayPaymentCallback {
  TextEditingController controller = TextEditingController();
  GlobalKey<ScaffoldState> _scaffoldKey = GlobalKey<ScaffoldState>();
  late SafeXPayPaymentCallbackObservable _safeXPayPaymentCallbackObservable;

  [@override](/user/override)
  void initState() {
    super.initState();
    _safeXPayPaymentCallbackObservable = SafeXPayPaymentCallbackObservable();
    _safeXPayPaymentCallbackObservable.register(this);
  }

  [@override](/user/override)
  void dispose() {
    _safeXPayPaymentCallbackObservable.unRegister(this);
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      key: _scaffoldKey,
      appBar: AppBar(
        title: Text('DemoPaymentApp'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          mainAxisSize: MainAxisSize.max,
          children: [
            TextField(
              controller: controller,
              keyboardType: TextInputType.number,
              decoration: InputDecoration(hintText: 'Enter the amount to pay'),
            ),
            const SizedBox(
              height: 32,
            ),
            ElevatedButton(
              onPressed: () {
                String amount = controller.text.toString().trim();
                if (amount.isEmpty) {
                  Utility.showSnackBarMessage(
                      state: _scaffoldKey.currentState!,
                      message: 'Please enter amount to pay');
                } else {
                  SafeXPayGateway safeXPayGateway = SafeXPayGateway(
                      orderNo: '${Random().nextInt(1000)}',
                      amount: double.parse(controller.text),
                      currency: 'INR',
                      transactionType: 'SALE',
                      channel: 'MOBILE',
                      successUrl: 'https://1bd1c7cd06b7.ngrok.io/Performance/public/simApp',
                      failureUrl: 'https://1bd1c7cd06b7.ngrok.io/Performance/public/simApp',
                      countryCode: 'IND');

                  safeXPayGateway.setUserDetails(
                      name: 'Nagendra',
                      emailId: 'nagendra@safexpay.com',
                      mobile: '7710910181');

                  safeXPayGateway.allowedPaymentMethods(
                      allowCardPayment: true,
                      allowNetBankingPayment: true,
                      allowWalletPayment: true,
                      allowUPIPayment: true);

                  MaterialPageRoute route = MaterialPageRoute(builder: (context) => safeXPayGateway);
                  Navigator.push(context, route);
                }
              },
              child: Text(
                'Proceed to Payment',
                style: TextStyle(color: Colors.black),
              ),
              style: ElevatedButton.styleFrom(
                primary: Colors.cyanAccent,
                padding: const EdgeInsets.symmetric(vertical: 12, horizontal: 24),
              ),
            )
          ],
        ),
      ),
    );
  }

  [@override](/user/override)
  void onInitiatePaymentFailure(
      String orderID,
      String transactionID,
      String paymentID,
      String paymentStatus,
      String date,
      String time,
      String paymode,
      String amount,
      String udf1,
      String udf2,
      String udf3,
      String udf4,
      String udf5) {
    print('onInitiatePaymentFailure : $orderID -- $transactionID -- $paymentID -- $paymentStatus -- $date -- $time -- $paymode -- $amount -- $udf1 -- $udf2 -- $udf3 -- $udf4 -- $udf5');
  }

  [@override](/user/override)
  void onPaymentCancelled() {
    print('onPaymentCancelled : Transaction Cancelled');
  }

  [@override](/user/override)
  void onPaymentComplete(
      String orderID,
      String transactionID,
      String paymentID,
      String paymentStatus,
      String date,
      String time,
      String paymode,
      String amount,
      String udf1,
      String udf2,
      String udf3,
      String udf4,
      String udf5) {
    print('onPaymentComplete : $orderID -- $transactionID -- $paymentID -- $paymentStatus -- $date -- $time -- $paymode -- $amount -- $udf1 -- $udf2 -- $udf3 -- $udf4 -- $udf5');
  }
}

更多关于Flutter安全支付插件safexpay的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter安全支付插件safexpay的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


SafeExpay 是一个用于在 Flutter 应用中实现安全支付的插件。它通常用于处理支付交易,确保支付过程的安全性。以下是如何在 Flutter 项目中使用 safexpay 插件的基本步骤:

1. 添加依赖

首先,你需要在 pubspec.yaml 文件中添加 safexpay 插件的依赖项。

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

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

2. 初始化 SafeExpay

在你的 Flutter 应用中,首先需要初始化 SafeExpay 插件。通常,你可以在 main.dart 或任何其他合适的地方进行初始化。

import 'package:safexpay/safexpay.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 SafeExpay
  await SafeExpay.initialize(
    apiKey: 'YOUR_API_KEY',
    environment: Environment.sandbox, // 或者 Environment.production
  );

  runApp(MyApp());
}

3. 发起支付请求

在你的应用中,你可以使用 SafeExpay 插件来发起支付请求。以下是一个简单的示例:

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

class PaymentPage extends StatelessWidget {
  Future<void> initiatePayment() async {
    try {
      // 创建支付请求
      final PaymentRequest request = PaymentRequest(
        amount: 100.0, // 支付金额
        currency: 'USD', // 货币类型
        orderId: 'ORDER12345', // 订单ID
        description: 'Payment for product', // 支付描述
      );

      // 发起支付
      final PaymentResponse response = await SafeExpay.startPayment(request);

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SafeExpay Payment'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: initiatePayment,
          child: Text('Pay Now'),
        ),
      ),
    );
  }
}

4. 处理支付结果

PaymentResponse 中,你可以根据 status 字段来判断支付是否成功,并执行相应的操作。例如,你可以显示成功或失败的消息给用户。

5. 配置环境

SafeExpay 提供了两种环境:Environment.sandboxEnvironment.production。在开发阶段,你可以使用 sandbox 环境进行测试。当应用上线时,切换到 production 环境。

6. 错误处理

在处理支付过程中,可能会遇到各种错误。你可以通过 try-catch 块来捕获异常,并根据需要处理错误。

7. 调试和日志

在开发过程中,你可以启用 SafeExpay 的调试模式,以便查看详细的日志信息。

SafeExpay.setDebugEnabled(true);
回到顶部