larkfinserv_flutter_sdk 0.0.3

SDKflutter
Platformandroidiosmacos

A Flutter SDK for integrating Lark FinServ's loan eligibility check functionality into your Flutter applications.

Lark FinServ Flutter SDK

A Flutter SDK for integrating Lark FinServ's loan eligibility check functionality into your Flutter applications.

Installation

Add the following to your pubspec.yaml:

dependencies:
  larkfinserv_flutter_sdk:
    path: ../larkfinserv_flutter_sdk # Adjust path as needed

Usage

1. Initialize the SDK

First, initialize the SDK with your configuration:

import 'package:larkfinserv_flutter_sdk/larkfinserv_flutter_sdk.dart';

// Create SDK instance
final sdk = LarkFinServSDK();

// Initialize with configuration
try {
  await sdk.initialize(PartnerConfig(
    apiKey: 'your_api_key',
    apiSecret: 'your_api_secret',
    environment: 'sandbox', // or 'production'
    phoneNumber: '+1234567890', // optional
    theme: ThemeConfig(
      primaryColor: '#FF5733',
      secondaryColor: '#33FF57',
      fontFamily: 'Roboto',
      logoUrl: 'https://your-logo-url.com/logo.png',
      name: 'Your App Name',
    ),
  ));
} catch (e) {
  print('SDK initialization failed: $e');
}

2. Popup Mode

To open the eligibility check in a popup window:

try {
  await sdk.openEligibilityCheck(SDKMode.popup);
} catch (e) {
  print('Failed to open eligibility check: $e');
}

3. Inline Mode

To embed the eligibility check within your app:

class MyApp extends StatelessWidget {
  final sdk = LarkFinServSDK();

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Loan Eligibility Check')),
        body: Center(
          child: Container(
            width: 500,
            height: 700,
            child: EligibilityCheckWidget(
              sdk: sdk,
              onEvent: (event) {
                switch (event.type) {
                  case SDKEventType.ready:
                    print('SDK is ready');
                    break;
                  case SDKEventType.eligibilityResult:
                    final result = event.data?['result'];
                    print('Eligibility Result: $result');
                    break;
                  case SDKEventType.error:
                    final error = event.data?['error'];
                    print('Error: ${error?.message}');
                    break;
                  case SDKEventType.close:
                    print('SDK closed');
                    break;
                  default:
                    break;
                }
              },
            ),
          ),
        ),
      ),
    );
  }
}

4. Event Handling

The SDK provides various events that you can listen to:

sdk.events.listen((event) {
  switch (event.type) {
    case SDKEventType.ready:
      // SDK is ready to use
      break;
    case SDKEventType.eligibilityResult:
      // Handle eligibility result
      final result = event.data?['result'];
      break;
    case SDKEventType.error:
      // Handle error
      final error = event.data?['error'];
      break;
    case SDKEventType.close:
      // Handle SDK close
      break;
    case SDKEventType.initiated:
      // SDK initialization started
      break;
    case SDKEventType.closeFrame:
      // Frame closed
      break;
  }
});

5. Error Handling

The SDK provides detailed error information:

try {
  await sdk.initialize(config);
} catch (e) {
  if (e is SDKError) {
    print('Error Code: ${e.code}');
    print('Error Message: ${e.message}');
  }
}

6. Cleanup

Don't forget to dispose of the SDK when you're done:

@override
void dispose() {
  sdk.dispose();
  super.dispose();
}

Configuration Options

PartnerConfig

ParameterTypeRequiredDescription
apiKeyStringYesYour API key
apiSecretStringYesYour API secret
environmentStringNo'sandbox' or 'production'
partnerIdStringNoYour partner ID
partnerNameStringNoYour partner name
phoneNumberStringNoUser's phone number
themeThemeConfigNoUI customization options

ThemeConfig

ParameterTypeDescription
primaryColorStringPrimary color in hex format
secondaryColorStringSecondary color in hex format
fontFamilyStringFont family name
logoUrlStringURL of your logo
nameStringYour app name

Error Codes

CodeDescription
INVALID_CONFIGMissing or invalid configuration
INITIALIZATION_FAILEDFailed to initialize SDK
SDK_NOT_INITIALIZEDSDK not initialized before use
URL_LAUNCH_FAILEDFailed to launch URL in popup mode
WEBVIEW_ERRORError in WebView

Platform Support

  • iOS 11.0+
  • Android API level 21+
  • Web (with limitations)

Dependencies

  • webview_flutter: ^4.4.2
  • url_launcher: ^6.2.2
  • http: ^1.1.0
  • shared_preferences: ^2.2.2