Flutter集成HyperSDK插件hypersdkflutter的使用

Hyper SDK Flutter

Flutter插件用于通过不同的动态模块实现支付编排。

Flutter Setup

在pubspec.yaml中添加Flutter插件依赖项。从pub.dev获取依赖项。

dependencies:
  hypersdkflutter: ^latest_version

Android Setup

在根（顶层）build.gradle中添加clientId ext属性：

• 可选：通过添加hyperSDKVersion覆盖HyperSDK版本。
• 可选：通过添加excludedMicroSDKs排除与给定clientId一起提供的microSDK。

buildscript {
    ext {
        clientId = "<clientId shared by Juspay team>"
        hyperSDKVersion = "2.1.32"
        excludedMicroSDKs = []
    }
}

注意: 您的应用程序的MainActivity应该扩展FlutterFragmentActivity而不是FlutterActivity。

import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity: FlutterFragmentActivity() {}

iOS Setup

在Podfile（ios/Podfile）中添加以下post_install脚本：

post_install do |installer|
  fuse_path = "./Pods/HyperSDK/Fuse.rb"
  clean_assets = true
  if File.exist?(fuse_path)
    if system("ruby", fuse_path.to_s, clean_assets.to_s)
    end
  end
end

创建文件ios/MerchantConfig.txt，内容如下：

clientId = <clientId> shared by Juspay Team

可选：如果您想覆盖插件中的基础SDK版本，请在项目的pubspec.yaml中添加以下变量：

hyper_sdk_ios_version: "<New version>"

Usage

Import HyperSDK

import 'package:hypersdk/hypersdkflutter.dart';

Step-1: Create Juspay Object

final hyperSDK = HyperSDK();

Step-2: Initiate

await hyperSDK.initiate(initiatePayload, initiateCallbackHandler);

Step-3: Process

await hyperSDK.process(processPayload, hyperSDKCallbackHandler);

Step-3.1: Process via Container

Container(
  color: Colors.white,
  child: hyperSDK.hyperSdkView(processPayload, hyperSDKCallbackHandler),
)

Step-4: Android Hardware Back-Press Handling

onWillPop: () async {
  if (Platform.isAndroid) {
    var backpressResult = await hyperSDK.onBackPress();
    if (backpressResult.toLowerCase() == "true") {
      return false;
    } else {
      return true;
    }
  } else {
    return true;
  }
}

Step-5: Terminate

await hyperSDK.terminate();

Optional: Is Initialised

await hyperSDK.isInitialised();

Callbacks

Initiate callback handler

void initiateCallbackHandler(MethodCall methodCall) {
  if (methodCall.method == "initiate_result") {
    // check initiate result
  }
}

Process callback handler

void hyperSDKCallbackHandler(MethodCall methodCall) {
  switch (methodCall.method) {
    case "hide_loader":
      break;
    case "process_result":
      var args = {};
      try {
        args = json.decode(methodCall.arguments);
      } catch (e) {
        print(e);
      }
      var error = args["error"] ?? false;
      var innerPayload = args["payload"] ?? {};
      var status = innerPayload["status"] ?? " ";
      var pi = innerPayload["paymentInstrument"] ?? " ";
      var pig = innerPayload["paymentInstrumentGroup"] ?? " ";

      if (!error) {
        switch (status) {
          case "charged":
            // Successful Transaction
            break;
          case "cod_initiated":
            // User opted for cash on delivery option displayed on payment page
            break;
        }
      } else {
        var errorCode = args["errorCode"] ?? " ";
        var errorMessage = args["errorMessage"] ?? " ";
        switch (status) {
          case "backpressed":
            // user back-pressed from PP without initiating any txn
            break;
          case "user_aborted":
            // user initiated a txn and pressed back
            break;
          case "pending_vbv":
            break;
          case "authorizing":
            // txn in pending state
            break;
          case "authorization_failed":
            break;
          case "authentication_failed":
            break;
          case "api_failure":
            // txn failed
            break;
          case "new":
            // order created but txn failed
            break;
        }
      }
  }
}

WebView Configuration Callback (Optional)

Android

HyperSdkFlutterPlugin.webViewConfigurationCallback =
    JuspayWebViewConfigurationCallback { webview ->
        // Configure WebView here
    }

iOS

SwiftHyperSdkFlutterPlugin.setJuspayWebViewConfigurationCallback { webView in
    // Configure WebView here
}

Payload Structure

Payload类型为Map<String, Dynamic>。有关详细信息，请参阅官方文档。

License

hypersdkflutter分发在AGPL-3.0-only许可证下。

示例代码

import 'package:flutter/material.dart';
import 'dart:io';
import 'package:flutter_inappwebview/flutter_inappwebview.dart';
import 'package:hypersdkflutter/hypersdkflutter.dart';
import 'package:flutter/services.dart';
import './screens/home.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (Platform.isAndroid) {
    await InAppWebViewController.setWebContentsDebuggingEnabled(true);
  }
  final hyperSDK = HyperSDK();
  runApp(MyApp(hyperSDK: hyperSDK));
}

class MyApp extends StatelessWidget {
  final HyperSDK hyperSDK;
  const MyApp({Key? key, required this.hyperSDK}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    SystemChrome.setEnabledSystemUIMode(SystemUiMode.manual, overlays: [SystemUiOverlay.bottom]);
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: HomeScreen(
        hyperSDK: hyperSDK,
      ),
    );
  }
}

以上是关于如何在Flutter项目中集成和使用HyperSDK插件hypersdkflutter的详细说明。希望对您有所帮助！