flutter_checkin_sdk

Production-ready Flutter plugin for the Checkin.com (GetID) native SDK on Android and iOS.

Features

Clean Dart API with repository and platform interface layers
MethodChannel for commands, EventChannel for SDK callbacks
Strongly typed models, events, and exceptions
Safe platform bootstrap: method channel is registered before repository access
Debug-only diagnostic logging (logger) for initialize, startVerification, and events
Android (Kotlin) and iOS (Swift) implementations
Example app with Riverpod state management

Supported platforms

Platform	Minimum version	Native SDK
Android	API 21+	`ee.getid:getidlib:4.2.2`
iOS	13.0+ (plugin) / 16.0+ (GetID SDK)	`GetID 4.1.3`

Installation

Add the dependency to your pubspec.yaml:

dependencies:
  flutter_checkin_sdk: ^1.0.0 # or pub.dev latest published version

Android

The plugin bundles the Checkin.com Android SDK dependency. Ensure your project can resolve the GetID Maven repositories (the example app adds them in android/build.gradle.kts):

maven { url = uri("https://jitpack.io") }
maven { url = uri("https://cdn.getid.cloud/sdk/android") }

`android/gradle.properties`

The GetID SDK pulls in dependencies (including bcprov-jdk18on) that can break Android builds when Jetifier is enabled. Update your host app android/gradle.properties as follows:

Property	Recommended value	Why
`android.enableJetifier`	`false`	Jetifier fails on `bcprov-jdk18on` (newer Java bytecode) from the GetID SDK. Modern AndroidX projects no longer need Jetifier.
`android.jetifier.ignorelist`	`protobuf-lite,protobuf-javalite,bcprov-jdk18on`	Safeguard if Jetifier is re-enabled: exclude BouncyCastle JARs from transformation.

Typical Flutter default:

android.enableJetifier=true
android.jetifier.ignorelist=protobuf-lite,protobuf-javalite

Recommended change when using this plugin:

android.enableJetifier=false
android.jetifier.ignorelist=protobuf-lite,protobuf-javalite,bcprov-jdk18on

Add required permissions to your app's AndroidManifest.xml:

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

If your flow uses NFC document reading, also add:

<uses-permission android:name="android.permission.NFC" />
<uses-feature android:name="android.hardware.nfc" android:required="false" />

Add the following to your app's android/app/build.gradle (or build.gradle.kts) to avoid duplicate manifest merge conflicts:

android {
    packaging {
        jniLibs {
            useLegacyPackaging = false
        }
        resources {
            excludes += ['META-INF/versions/9/OSGI-INF/MANIFEST.MF']
        }
    }
}

Release / R8 (minify) builds

Release builds with R8 full mode (android.enableR8.fullMode=true, the Android Gradle Plugin default) can crash the GetID SDK with:

java.lang.Class cannot be cast to java.lang.reflect.ParameterizedType

R8 strips generic Signature attributes that Retrofit/Gson/Moshi reflection needs. This plugin ships android/consumer-rules.pro and wires it via consumerProguardFiles in android/build.gradle, so host apps that enable minify automatically get the keep rules. No extra ProGuard config is required in the app unless you override consumer rules.

iOS

The plugin supports both Swift Package Manager and CocoaPods.

The Flutter plugin package targets iOS 13.0+. The Checkin.com GetID native SDK itself requires iOS 16.0+, so set your app’s deployment target to 16.0 or higher.

Swift Package Manager

With Flutter’s SwiftPM integration enabled, GetID is resolved from vvorld/getid-ios-sdk via the plugin’s Package.swift. No extra Podfile entry is required when using SPM for this plugin.

CocoaPods

GetID is not published on the CocoaPods trunk. Add this line to your app’s ios/Podfile (before flutter_install_all_ios_pods):

pod 'GetID', :podspec => 'https://cdn.getid.cloud/sdk/ios/4.1.3/GetID.podspec'

Because GetID depends on RecaptchaEnterprise (static binaries), use static framework linkage:

use_frameworks! :linkage => :static

Add the following to your app's Info.plist:

<key>NSCameraUsageDescription</key>
<string>This app uses the camera to capture identity documents and perform liveness checks.</string>
<key>UIDesignRequiresCompatibility</key>
<true/>

If your flow includes NFC, also add NFCReaderUsageDescription, enable the Near Field Communication Tag Reading capability, and configure ISO 7816 identifiers as described in the iOS SDK documentation.

Initialization

The native SDK does not expose a separate initialize method. The plugin's initialize() call prepares the platform channel bridge and event stream.

Creating FlutterCheckinSdk() uses a factory constructor that calls ensureCheckinPlatformRegistered() before the repository reads CheckinPlatform.instance. That avoids unbound method-channel / missing-implementation failures when initialize() or startVerification() runs.

final sdk = FlutterCheckinSdk();
await sdk.initialize();

Debug logging (0.1.4+)

In debug builds, the plugin logs initialize, startVerification, and verification events via the logger package (checkinLogger). Logging is off in release (kDebugMode only). No host-app setup is required.

Example usage

import 'package:flutter_checkin_sdk/flutter_checkin_sdk.dart';

final sdk = FlutterCheckinSdk();

Future<void> runCheckinFlow() async {
  await sdk.initialize();

  sdk.events.listen((event) {
    switch (event) {
      case VerificationStarted():
        print('Flow started');
      case VerificationCompleted(:final result):
        print('Completed: ${result.applicationId}');
      case VerificationCancelled():
        print('Cancelled');
      case VerificationFailed(:final error):
        print('Failed: ${error.message}');
      default:
        break;
    }
  });

  /// apiUrl, flowName, and SDK key are provided by your Checkin.com account
  /// In production, use JWT authentication instead of the SDK key.
  /// See the "JWT authentication" section below.
  /// If you are in the sandbox environment, use the sandbox API URL and flow name.
  await sdk.startVerification(
    apiUrl: 'https://company-name.getid.ee',
    auth: CheckinAuth.sdkKey('YOUR_SDK_KEY'), // use JWT in production
    flowName: 'YOUR_FLOW_NAME',
    locale: 'en',
    metadata: const VerificationMetadata(
      externalId: 'user-123',
      labels: {'department': 'EST'},
    ),
    profileData: const {
      'first-name': 'John',
      'last-name': 'Doe',
    },
    acceptableDocuments: const AcceptableDocuments({
      'EST': [DocumentType.passport, DocumentType.idCard],
      'default': [DocumentType.passport],
    }),
  );
}

JWT authentication (production)

Obtain a JWT from your backend using your SDK key:

curl -H "Content-Type: application/json" \
     -H "x-sdk-key: SDK_KEY" \
     -X POST API_URL/sdk/v2/token

Then pass the token:

await sdk.startVerification(
  apiUrl: apiUrl,
  auth: CheckinAuth.jwt(jwtToken),
  flowName: flowName,
);

Verification results

The native SDK does not return verification results. Use the applicationId from VerificationCompleted and fetch results from your backend via the Checkin.com API.

API reference