Flutter支付集成插件redsys_with_flutter的使用

Redsys with Flutter 是一个用于在 Flutter 应用程序中集成 Redsys 银行支付网关的插件包。通过此插件，您可以轻松地在 Flutter 应用中处理支付。

特性

• 与 Redsys 支付网关无缝集成。
• 简单的配置和设置。
• 同时支持 iOS 和 Android 平台。
• 提供交易成功、失败和取消的回调。
• 详细的文档和示例。

如果您遇到任何问题或希望为该插件的开发做出贡献，请在 GitHub 仓库 上提交问题或拉取请求。

安装

要使用 Redsys with Flutter，请按照以下步骤操作：

1. 在 pubspec.yaml 文件中添加依赖：

dependencies:
  redsys_with_flutter: ^1.0.0

1. 或者运行以下命令：

flutter pub add redsys_with_flutter

1. 运行以下命令以获取包：

flutter pub get

使用方法

导入插件

在项目中导入必要的类：

import 'package:redsys_with_flutter/common/ui_direct_payment_config.dart';
import 'package:redsys_with_flutter/flutter_with_redsys.dart';
import 'package:redsys_with_flutter/common/tpvv_configuration.dart';
import 'package:redsys_with_flutter/common/tpvv_constants.dart';

配置 Redsys 设置

在应用中配置 Redsys 的参数：

RedsysWithFlutter.configure(
  merchantCode: 'YOUR_MERCHANT_CODE', // 商户代码
  terminal: 'YOUR_TERMINAL',          // 终端编号
  currency: 'YOUR_CURRENCY',          // 货币代码（例如：978 表示欧元）
  secretKey: 'YOUR_SECRET_KEY',       // 密钥
  transactionType: TransactionType.authorization, // 交易类型
  urlEnvironment: UrlEnvironment.live, // 环境（测试或生产）
);

处理支付

实现支付功能的代码如下：

final _pluginRedsysPlugin = FlutterWithRedsys();

performCardPayment(context, {String? alias, String? originalAlias}) async {
  TPVVConfiguration tpvvConfig = TPVVConfiguration();
  tpvvConfig.amount = 10.0; // 支付金额
  tpvvConfig.enableRedirection = true; // 是否重定向
  tpvvConfig.enableResultAlert = true; // 是否启用结果通知
  tpvvConfig.paymentMethods = TPVVConstants.PAYMENT_METHOD_T; // 支付方式
  tpvvConfig.license = "<dev_license_for_ios_or_android>"; // 开发者许可证
  tpvvConfig.environment = TPVVConstants.ENVIRONMENT_TEST; // 测试环境
  tpvvConfig.fuc = "<merchant_fuc>"; // 商户功能码
  tpvvConfig.terminal = "002"; // 终端编号
  tpvvConfig.merchantUrl = "<merchant_url_for_results_reporting>"; // 商户结果报告 URL
  tpvvConfig.currency = "978"; // 货币代码
  tpvvConfig.order = "978"; // 订单号
  tpvvConfig.reference = 'ahmad'; // 参考信息
  tpvvConfig.enableResultAlert = true; // 启用结果通知
  tpvvConfig.enableRedirection = true; // 启用重定向
  tpvvConfig.uiDirectPaymentConfig = UIDirectPaymentConfig(); // UI 直接支付配置
  tpvvConfig.merchantData = "<id_transaction_to_be_set>"; // 交易 ID

  log(tpvvConfig.toJson().toString()); // 打印配置信息

  // 发起支付请求
  var call = await _pluginRedsysPlugin.webPayment(tpvvConfig.toJson());
  log(call.toString()); // 打印返回值
  var resp = jsonDecode(call.toString()); // 解析返回值
  log('ressssppp$resp'); // 打印解析后的结果
}

示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 中使用 redsys_with_flutter 插件进行支付：

import 'dart:async';
import 'dart:convert';
import 'dart:developer';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:redsys_with_flutter/common/ui_direct_payment_config.dart';
import 'package:redsys_with_flutter/flutter_with_redsys.dart';
import 'package:redsys_with_flutter/common/tpvv_configuration.dart';
import 'package:redsys_with_flutter/common/tpvv_constants.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';
  final _pluginRedsysPlugin = FlutterWithRedsys();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      TPVVConfiguration tpvvConfig = TPVVConfiguration();

      tpvvConfig.amount = 10.0;
      tpvvConfig.paymentMethods = TPVVConstants.PAYMENT_METHOD_T;
      tpvvConfig.license = "<dev_license_for_ios_or_android>";
      tpvvConfig.environment = TPVVConstants.ENVIRONMENT_TEST;
      tpvvConfig.fuc = "<merchant_fuc>";
      tpvvConfig.terminal = "002";
      tpvvConfig.merchantUrl = "<merchant_url_for_results_reporting>";
      tpvvConfig.currency = "978";
      tpvvConfig.merchantData = "<id_transaction_to_be_set>";

      var call = await _pluginRedsysPlugin.webPayment(tpvvConfig.toJson());
      log("CALL $call");
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }
    if (!mounted) return;

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

  performCardPayment(context, {String? alias, String? originalAlias}) async {
    TPVVConfiguration tpvvConfig = TPVVConfiguration();
    tpvvConfig.amount = 10.0;
    tpvvConfig.enableRedirection = true;
    tpvvConfig.enableResultAlert = true;
    tpvvConfig.paymentMethods = TPVVConstants.PAYMENT_METHOD_T;
    tpvvConfig.license = "<dev_license_for_ios_or_android>";
    tpvvConfig.environment = TPVVConstants.ENVIRONMENT_TEST;
    tpvvConfig.fuc = "<merchant_fuc>";
    tpvvConfig.terminal = "002";
    tpvvConfig.merchantUrl = "<merchant_url_for_results_reporting>";
    tpvvConfig.currency = "978";
    tpvvConfig.order = "978";
    tpvvConfig.reference = 'ahmad';
    tpvvConfig.enableResultAlert = true;
    tpvvConfig.enableRedirection = true;
    tpvvConfig.uiDirectPaymentConfig = UIDirectPaymentConfig();
    tpvvConfig.merchantData = "<id_transaction_to_be_set>";

    log(tpvvConfig.toJson().toString());
    var call = await _pluginRedsysPlugin.webPayment(tpvvConfig.toJson());
    log(call.toString());
    var resp = jsonDecode(call.toString());
    log('ressssppp$resp');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: TextButton(
            child: Text('Running on: $_platformVersion\n'),
            onPressed: () {
              performCardPayment(context);
            },
          ),
        ),
      ),
    );
  }
}