Flutter-SDK

Матеріал з apidocs
Перейти до: навігація, пошук

Введеня

Ця інструкція допоможе вам налаштувати і реалізувати можливості EasyPay SDK у вашому Flutter-додатку як для Android, так і для iOS. Виконуючи кроки в інструкції, ви зможете:

  • Підключити SDK до вашого Flutter-проекту.
  • Реалізувати функціонал для здійснення платежів.
  • Додати можливість перегляду, додавання або видалення карток користувачів.


Незалежно від того, на якій платформі ви працюєте (Android чи iOS), SDK EasyPay забезпечить вам підтримку на обох платформах, дозволяючи вам створювати додатки з потужними платіжними функціями для ваших користувачів.

Андроїд частина

1.1 Налаштування залежностей

У файлі settings.gradle (рівень проекту) додайте наступне:

pluginManagement {
    val flutterSdkPath = run {
        val properties = java.util.Properties()
        file("local.properties").inputStream().use { properties.load(it) }
        val flutterSdkPath = properties.getProperty("flutter.sdk")
        require(flutterSdkPath != null) { "flutter.sdk not set in local.properties" }
        flutterSdkPath
    }
    includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

У файлі build.gradle (рівень додатку):

dependencies {
    implementation("ua.easypay:EasyPay-Sdk:1.0.0-alpha8")
}


1.2 Ініціалізація SDK в класі Application

У вашому класі Application додайте ініціалізацію EasyPay SDK:

class FlutterApp : Application() {
    override fun onCreate() {
        super.onCreate()
        EasyPaySdk.init(
            context = PlatformContext(this),
            secret = "your secret",
            partnerKey = "your partner key"
        )
    }
}


1.3 Створення MethodChannel для навігації на оплату та на перегляд/додавання/видалення карток

У файлі MainActivity реалізуйте MethodChannel для обробки методів оплати і роботи з картками:

class MainActivity : FlutterFragmentActivity() {
    private val CHANNEL = "com.example.sdk/payment"
    private var pendingResult: MethodChannel.Result? = null
    private val paymentLauncher = registerForActivityResult(SdkPaymentContract()) { sdkResult ->
        pendingResult?.let { result ->
            result.success(sdkResult?.toString())
            pendingResult = null
        }
    }

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "startPayment") {
                val args = call.arguments as? Map<*, *>
                if (args != null) {
                    try {
                        val serviceKey = args["serviceKey"] as? String ?: throw IllegalArgumentException("Missing serviceKey")
                        val orderId = args["orderId"] as? String ?: throw IllegalArgumentException("Missing orderId")
                        val amount = (args["amount"] as? String)?.toDoubleOrNull() ?: throw IllegalArgumentException("Missing/invalid amount")
                        val description = args["description"] as? String ?: throw IllegalArgumentException("Missing description")
                        val additionalItems = (args["additionalItems"] as? Map<*, *>)?.mapKeys { it.key.toString() }?.mapValues { it.value.toString() }
                        val phoneNumber = args["phoneNumber"] as? String
                        val showPaymentResult = args["showPaymentResult"] as? Boolean ?: false
                        val paymentInstrumentArgs = PaymentInstrumentArgs(
                            serviceKey = serviceKey,
                            orderId = orderId,
                            amount = amount,
                            description = description,
                            additionalItems = additionalItems,
                            phoneNumber = phoneNumber
                        )
                        val sdkArgs = SdkPaymentContractArgs(
                            paymentInstrumentArgs = paymentInstrumentArgs,
                            showPaymentResult = showPaymentResult
                        )
                        pendingResult = result
                        paymentLauncher.launch(sdkArgs)

                    } catch (e: Exception) {
                        result.error("INVALID_ARGS", "Failed to parse args: ${e.localizedMessage}", null)
                    }
                } else {
                    result.error("INVALID_ARGS", "Args were null", null)
                }
            } else if (call.method == "openCardListScreen") {
                val phoneNumber = call.argument<String>("phoneNumber") ?: ""
                val args = SdkCardsContractArgs(phoneNumber = phoneNumber)
                this@MainActivity.navigate(args)
                result.success(null)
            } else {
                result.notImplemented()
            }
        }
    }
}

IOS частина

2.1 Підключення SDK

Для підключення SDK до iOS проекту необхідно завантажити EasyPaySdkIos.xcframework і вставити його в папку з проектом ../YourProject/iOS/Runner/.

Перевірте, чи з'явився фреймворк в розділі Frameworks, Libraries, and Embedded Content.

Також додайте папку compose-resources, яка знаходиться всередині EasyPaySdkIos.xcframework, до Copy Bundle Resources.


2.2 Ініціалізація SDK в AppDelegate.swift

У файлі AppDelegate.swift додайте ініціалізацію SDK:

import Flutter
import UIKit
import EasyPaySdkIos

@main
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        EasyPaySdk.shared.doInit(
            context: PlatformContext(),
            secret: "your secret",
            partnerKey: "your partner key",
            applePayMerchantId: "merchant.com.example"
        )
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

2.3 Створення MethodChannel для методів навігації на оплату та на перегляд/додавання/видалення карток

У файлі AppDelegate.swift додайте код для методів навігації та оплати:

import Flutter
import UIKit
import EasyPaySdkIos

@main
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        EasyPaySdk.shared.doInit(
            context: PlatformContext(),
            secret: "your secret",
            partnerKey: "your partner key",
            applePayMerchantId: "merchant.com.example"
        )
        let controller = window?.rootViewController as! FlutterViewController
        let channel = FlutterMethodChannel(name: "com.example.sdk/payment", binaryMessenger: controller.binaryMessenger)
        channel.setMethodCallHandler { [weak controller] call, result in
            if call.method == "startPayment" {
                guard let args = call.arguments as? [String: Any] else {
                    result(FlutterError(code: "INVALID_ARGS", message: "Args were null", details: nil))
                    return
                }
                let vc = createPaymentVC(args: args) { sdkResult in
                    if let sdkResult = sdkResult {
                        result(sdkResult.description)
                    } else {
                        result("Cancelled")
                    }
                }
                controller?.present(vc, animated: true)
            } else if call.method == "openCardListScreen" {
                let phoneNumber = (call.arguments as? [String: Any])?["phoneNumber"] as? String ?? ""
                let vc = SdkCardsViewControllerKt.SdkCardsViewController(
                    args: SdkCardsContractArgs(phoneNumber: phoneNumber, urlToNotifyMerchant: nil)
                ) {
                    result(nil)
                }
                controller?.present(vc, animated: true)
            } else {
                result(FlutterMethodNotImplemented)
            }
        }
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

3. Ініціалізація оплати

Для запуску оплати через Flutter використовуйте наступний код:

SizedBox(
    width: double.infinity,
    child: FloatingActionButton.extended(
        onPressed: () async {
            final args = {
                'serviceKey': 'SomeServiceKey',
                'orderId': 'SomeOrderId',
                'amount': '3.0',
                'description': 'payment description',
                'phoneNumber': '380990000000', // Необов'язково
                'showPaymentResult': true,
            };
            try {
                final result = await platform.invokeMethod('startPayment', args);
                setState(() {
                    _paymentResult = result; // Це рядок, який повертається з Android
                });
            } on PlatformException catch (e) {
                setState(() {
                    _paymentResult = "Не вдалося отримати результат оплати: '${e.message}'.";
                });
            }
        },
        label: const Text('Зробити платіж'),
    ),
)

4. Перехід на екран перегляду/додавання/видалення карток

SizedBox(
    width: double.infinity,
    child: FloatingActionButton.extended(
        onPressed: () async {
            final phoneNumber = _phoneNumberController.text;
            try {
                await platform.invokeMethod('openCardListScreen', {
                    'phoneNumber': phoneNumber,
                });
            } on PlatformException catch (e) {
                print('Не вдалося відкрити екран карток: ${e.message}');
            }
        },
        label: const Text('Перейти до карток'),
    ),
)

Підсумок

  1. Налаштуйте залежності для Flutter у settings.gradle та build.gradle.
  2. Ініціалізуйте SDK в класах Application (для Android) та AppDelegate (для iOS).
  3. Запускайте оплату за допомогою MethodChannel у Flutter.
  4. Додайте функціонал для роботи з картками за допомогою навігації та MethodChannel.

Ці кроки дозволяють вам інтегрувати EasyPay SDK у Flutter додаток для зручної та безпечної обробки платежів.

Отримано з https://apidocs.easypay.ua/index.php?title=Flutter-SDK&oldid=1492