Flutter数据处理与传输插件datatrans_plugin_flutter的使用

Flutter数据处理与传输插件datatrans_plugin_flutter的使用

本项目是一个新的Flutter插件项目，用于处理和传输数据。以下是详细的使用说明。

重要提示

• 此插件要求应用使用IOS CocoaPods版本1.13.0或以上。
• 此插件要求AndroidX SDK最低版本为26.0或以上。

教程

你可以参考以下链接获取更多教程：

• Datatrans文档

开始使用

首先，创建一个插件实例：

DatatransPluginFlutter plugin = DatatransPluginFlutter();

接下来，初始化DatatransPluginFlutter对象，并登录到Datatrans的Web服务器以创建会话ID：

plugin.initialize("merchant_id", "password", isTesting: false, appCallbackScheme: your_custom_scheme);

其中，merchant_id 和 password 应替换为你在Datatrans账户上注册的信息。isTesting 参数表示是否进行测试（模拟支付）。appCallbackScheme 是你的回调URL Scheme。

支付

要执行支付操作，你需要创建一个带有支付参数的对象。例如：

final params = PaymentParams(
  amount: 1000, // 金额
  currency: "USD", // 货币单位
  saveAlias: false, // 是否保存别名
  autoSettle: false, // 是否自动结算
  paymentMethods: [
    PaymentMethodType.masterCard, // 支付方式
    PaymentMethodType.visa,
  ]
);

创建完支付参数后，执行支付操作：

var result = await plugin.payment(params: params);

如果设置了 saveAlias，则支付成功后将返回包含详细信息的对象。否则，将收到空值。

快速支付

快速支付或一键支付需要使用已保存的支付参数对象：

var result = await _datatransFlutterPlugin.fastPayment(params: params, saveParams: saveParams);

Android设置

在AndroidManifest.xml中添加以下内容来配置重定向URI：

<activity
  android:name="ch.datatrans.payment.ExternalProcessRelayActivity"
  android:launchMode="singleTask"
  android:enabled="false"
  android:theme="@android:style/Theme.Translucent.NoTitleBar"
  android:exported="true">
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="your_custom_scheme.dtsdk" />
  </intent-filter>
</activity>

确保 <your_custom_scheme> 全部小写，以避免问题。

iOS/macOS设置

在Info.plist文件中添加自定义Scheme：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>your_custom_scheme</string>
        </array>
    </dict>
</array>

示例代码

以下是一个完整的示例代码，展示了如何使用datatrans_plugin_flutter插件：

import 'package:flutter/material.dart';
import 'package:datatrans_plugin_flutter/datatrans_plugin_flutter.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> {
  final _datatransFlutterPlugin = DatatransPluginFlutter();

  [@override](/user/override)
  void initState() {
    super.initState();
    _datatransFlutterPlugin.initialize("1110015614", "NvhOGev4xmiWesTg", isTesting: true, appCallbackScheme: 'app.datatrans.flutter');
  }

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

class Home extends StatefulWidget {
  final DatatransPluginFlutter datatransFlutterPlugin;

  const Home({super.key, required this.datatransFlutterPlugin});

  [@override](/user/override)
  State<Home> createState() => HomeState();
}

class HomeState extends State<Home> {
  SavedPaymentParams? _savedPaymentParams;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Plugin example app'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              child: const Text('Charge payment'),
              onPressed: () async {
                var params = PaymentParams(
                  amount: 1000,
                  currency: "USD",
                  saveAlias: true,
                  paymentMethods: [
                    PaymentMethodType.masterCard,
                    PaymentMethodType.visa,
                    PaymentMethodType.jcb,
                    PaymentMethodType.paypal,
                    PaymentMethodType.americanExpress
                  ]);
                var result = await widget.datatransFlutterPlugin.payment(params: params);
                _showMyDialog(context, result?.success ?? false, error: result?.error);
                if (result?.success == true) {
                  _savedPaymentParams = result?.data;
                } else{
                  print(result?.bodyError.toString());
                }
              },
            ),
            const SizedBox(height: 50,),
            ElevatedButton(
              child: const Text('Charge fast payment'),
              onPressed: () async {
                var params = PaymentParams(
                  amount: 100,
                  currency: "USD",
                  autoSettle: true,
                  paymentMethods: _savedPaymentParams != null ? [_savedPaymentParams!.paymentMethod] : []);

                if (_savedPaymentParams != null) {
                  var result = await widget.datatransFlutterPlugin.fastPayment(params: params, saveParams: _savedPaymentParams!);
                  _showMyDialog(context, result?.success ?? false, error: result?.error);
                }
              },
            ),
          ],
        ),
      ),
    );
  }

  void _showMyDialog(BuildContext context, bool success, {String? error}) {
    showDialog<void>(
      context: context,
      barrierDismissible: false, // 用户必须点击按钮！
      builder: (BuildContext context) {
        return AlertDialog(
          title: const Text('Payment'),
          content: SingleChildScrollView(
            child: ListBody(
              children: <Widget>[
                Text('Payment is ${success ? 'successed' : 'not successed'}'),
                if (error != null) Text(error),
              ],
            ),
          ),
          actions: <Widget>[
            TextButton(
              child: const Text('OK'),
              onPressed: () {
                Navigator.of(context).pop();
              },
            ),
          ],
        );
      },
    );
  }
}