Flutter支付集成插件easy_pay的使用

在flutter应用内实现：

dependencies:
   easy_pay: ^0.0.4

Android 端

本指南提供了逐步指导，以配置您的Flutter项目所需的Android依赖项和设置。

第一步：将SoftPos-v1.3.66.11-Debug_Test.aar添加到您的项目

1. 导航到您的Flutter项目的android文件夹。
2. 在android文件夹内创建一个名为libs的新文件夹。
3. 将SoftPos-v1.3.66.11-Debug_Test.aar文件粘贴到libs文件夹中。

第二步：在AndroidManifest.xml文件中添加以下权限

  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

第三步：更新build.gradle文件

1. 打开android/app/build.gradle文件。
2. 在dependencies部分，添加以下代码行：

implementation 'com.sdk:easypay:1.1.5'
implementation 'com.denovo:topliteapp:1.7.5.1'
compileOnly files('libs/SoftPos-v1.3.66.11-Debug_Test.aar')

第四步：在MainActivity中扩展FlutterActivity

1. 导航到android/app/src/main/kotlin/your/package/name/。
2. 创建或更新MainActivity.kt文件，使用以下代码：

import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel
import io.flutter.plugins.GeneratedPluginRegistrant

class MainActivity : FlutterActivity() {

    private val CHANNEL = "easy_pay"
    private var easyPayPlugin: EasyPayPlugin? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 初始化EasyPay插件
        easyPayPlugin = EasyPayPlugin()
        easyPayPlugin?.setActivity(this)
    }

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        GeneratedPluginRegistrant.registerWith(flutterEngine)
        easyPayPlugin?.let {
            flutterEngine.plugins.add(it)
        }

        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            when (call.method) {
                "startPayment" -> {
                    val secretKey = call.argument<String>("secretKey") ?: ""
                    val jsonRequest = call.argument<String>("jsonRequest") ?: ""
                    easyPayPlugin?.onMethodCall(call, result)
                }
                "registerDevice" -> {
                    val tpn = call.argument<String>("tpn") ?: ""
                    val merchantKey = call.argument<String>("merchantKey") ?: ""
                    easyPayPlugin?.onMethodCall(call, result)
                }
                else -> {
                    result.notImplemented()
                }
            }
        }
    }
}

通过以上步骤，您可以成功地为您的Flutter项目配置必要的Android依赖项和设置。如果遇到任何问题，请参阅相应的文档以获取更多帮助。

第五步：在settings.gradle文件中，在repositories部分添加以下代码

maven {
        url = uri("s3://denovo-android.s3.amazonaws.com")
        credentials(AwsCredentials) {
            accessKey = "accessKey"
            secretKey = "secretKey"
        }
    }
  maven {
        url = uri("gitUrl")
        credentials {
            username = "Username"
            password = "password"
        }
    }

第六步：在gradle.properties中添加以下代码

android.enableJetifier=true
android.disableAutomaticComponentCreation=true

第七步：在Android端调用函数

  Future<void> startTransaction() async {
   try {
      var status = await Permission.location.status;
      if (!status.isGranted) {
         status = await Permission.location.request();
         if (!status.isGranted) {
            showSnackbar('位置权限被拒绝。请允许该权限。');
            return;
         }
      }

      final response = await _easyPay.registerDevice('tpnKey', 'merchantKey');
      print("交易成功: $response");

      Map<String, dynamic> decodedResponse = jsonDecode(response ?? '{}');
      String? sessionKey = decodedResponse['session_key'];

      if (sessionKey != null) {
         print('会话密钥: $sessionKey');
         var uuid = Uuid();
         // 除类型外，更改参数值为您自己的值
         Map<String, dynamic> paymentData = {
            'type': 'SALE', // 必须为SALE
            'amount': '1', // 更改金额值为您自己的值
            'isreceiptsneeded': false,
            'showapprovalscreen': false,
            'Customobject': {
               'customeremail': 'graghu@denovosystem.com',
               'PhoneNumber': '919840720372',
               'CreditType': '1',
               'NumberOfPayments': '1',
               'ExtraData': '[]',
               'HolderID': '1',
               'TransactionUniqueIdForQuery': uuid.v1()
            }
         };

         String jsonRequest = jsonEncode(paymentData);

         final paymentResponse = await _easyPay.startPayment(sessionKey, jsonRequest);
         print('付款已启动: $paymentResponse');

      } else {
         print('响应中未找到会话密钥。');
      }

   } catch (e) {
      showSnackbar('启动交易失败: $e');
   }
}

iOS 端

本指南提供了逐步指导，以配置您的Flutter项目所需的iOS依赖项和设置。

第一步：在info.plist文件中添加以下权限

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

<key>NSLocationWhenInUseUsageDescription</key>
<string>使用期间访问位置的原因</string>

<key>NSLocationAlwaysUsageDescription</key>
<string>始终访问位置的原因</string>

第二步：iOS示例代码

Future<void> makeRequest() async {
    try {
      final response = await _easyPay.requestWith('merchantKey');
      print("请求成功: $response");
    } catch (e) {
      showSnackbar('请求失败: $e');
    }
  }

  Future<void> performTransaction() async {
    try {
      final response = await _easyPay.transactionWith(100.0, 1);  // 更改金额值为您自己的值
      print("交易成功: $response");
    } catch (e) {
      showSnackbar('执行交易失败: $e');
    }
  }

首先调用makeRequest()函数。然后调用performTransaction()。

有关更多信息，请参阅示例选项卡。

示例代码

import 'dart:convert';
import 'dart:io';
import 'package:flutter/material.dart';
import 'package:easy_pay/easy_pay.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:uuid/uuid.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 EasyPay _easyPay = EasyPay();
  String? _sessionKey;

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

  Future<void> initPlatformState() async {
    try {
      final version = await _easyPay.getPlatformVersion() ?? '未知平台版本';
      setState(() {
        _platformVersion = version;
      });
    } catch (e) {
      print('获取平台版本失败: $e');
    }
  }

  void showSnackbar(String message) {
    final snackBar = SnackBar(content: Text(message));
    ScaffoldMessenger.of(context).showSnackBar(snackBar);
  }

  Future<void> startTransaction() async {
    try {
      var status = await Permission.location.status;
      if (!status.isGranted) {
        status = await Permission.location.request();
        if (!status.isGranted) {
          showSnackbar('位置权限被拒绝。请允许该权限。');
          return;
        }
      }

      final response = await _easyPay.registerDevice('tpnKey', 'merchantKey');
      print("交易成功: $response");

      Map<String, dynamic> decodedResponse = jsonDecode(response ?? '{}');
      String? sessionKey = decodedResponse['session_key'];

      if (sessionKey != null) {
        print('会话密钥: $sessionKey');
        var uuid = Uuid();

        Map<String, dynamic> paymentData = {
          'type': 'SALE',
          'amount': '1',
          'isreceiptsneeded': false,
          'showapprovalscreen': false,
          'Customobject': {
            'customeremail': 'graghu@denovosystem.com',
            'PhoneNumber': '919840720372',
            'CreditType': '1',
            'NumberOfPayments': '1',
            'ExtraData': '[]',
            'HolderID': '1',
            'TransactionUniqueIdForQuery': uuid.v1()
          }
        };

        String jsonRequest = jsonEncode(paymentData);

        final paymentResponse = await _easyPay.startPayment(sessionKey, jsonRequest);
        print('付款已启动: $paymentResponse');

      } else {
        print('响应中未找到会话密钥。');
      }

    } catch (e) {
      showSnackbar('启动交易失败: $e');
    }
  }

  Future<void> makeRequest() async {
    try {
      final response = await _easyPay.requestWith('merchantKey');
      print("请求成功: $response");
    } catch (e) {
      showSnackbar('请求失败: $e');
    }
  }

  Future<void> performTransaction() async {
    try {
      final response = await _easyPay.transactionWith(100.0, 1);
      print("交易成功: $response");
    } catch (e) {
      showSnackbar('执行交易失败: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text('运行在: $_platformVersion\n'),
              if (Platform.isAndroid)
                ElevatedButton(
                onPressed: () => startTransaction(),
                child: const Text('开始交易'),
              ),
              if (Platform.isIOS)
                ElevatedButton(
                onPressed: () => makeRequest(),
                child: const Text('发起请求'),
              ),
              if (Platform.isIOS)
                ElevatedButton(
                  onPressed: () => performTransaction(),
                  child: const Text('执行交易'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}