Adding the SDK to Your Project

You can add the iOS SDK to your project using Swift Package Manager.

Required App Integration Steps

1
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
2
<array>
3
	<string>D23300000045737445494420763335</string>
4
	<string>A0000002471001</string>
5
	<string>A0000002472001</string>
6
	<string>00000000000000</string>
7
</array>

1
<key>com.apple.developer.nfc.readersession.formats</key>
2
<array>
3
	<string>TAG</string>
4
</array>

Initialization

To initialize the SDK, create a subclass of the App class, and add the following code to your init() method:

1
struct SampleAppApp: App {
2
	init() {
3
		IDmeSDK.shared.initialize(sdkConfig: sdkConfig)
4
	}
5
}

You will need to pass in an instance of IDmeSDKConfig while initializing the SDK. This example demonstrates how to create this config:

1
private var sdkConfig: IDmeSDKConfig {
2
	return IDmeSDKConfig(
3
		externalUserId: "sample-user-id", // Unique identifier for the user
4
		appName: "SampleApp", // Name of the app
5
		tokenProvider: Self.tokenProvider
6
	)
7
}

The tokenProvider in the example is responsible for generating the client access token. This token enables the SDK to make REST API requests to ID.me’s backend APIs. The application must obtain a client access token from ID.me and provide a function to generate a new token if the current one expires. The SDK will then automatically use this to make REST API requests. This example illustrates the signature of this token provider method:

1
static func tokenProvider() async throws -> String {
2
	// Fetch client token from the backend and return it
3
}

Common Usage Patterns

This section provides examples of common tasks you can perform with our Mobile SDK.

Performing Legal Document Verification

This section details the process of legal document verification utilizing our Mobile SDK. Initiating a verification is straightforward, as demonstrated by the code snippets below.

1
let manager = IDmeSDK.shared.getVerificationsManager()
2
let workflowView = manager.createVerificationWorkflowView(
3
	verificationType: .document
4
) { result in
5
	print("Verification result: \(result.verificationStatus)")
6
}
7
// Present workflowView in your SwiftUI hierarchy

1
let manager = IDmeSDK.shared.getVerificationsManager()
2
manager.launchVerificationWorkflow(
3
	from: self,
4
	verificationType: .document
5
) { result in
6
	switch result.verificationStatus {
7
	case .completed:
8
		print("Success! Credential: \(result.credentialUuid ?? "")")
9
	case .failed:
10
		print("Failed: \(resulr.errorMessage ?? "")")
11
	case .cancelled:
12
		print("User cancelled")
13
	default:
14
		break
15
}

Checking the Status of an Ongoing Verification

This section describes how to obtain the status of an ongoing verification.

// Returns the verificationID of the current verification and its status
IDmeSDK.shared.getVerificationsManager().getCurrentVerification()

Customizing the Document Scanner User Interface

This section details how to customize the document scanner’s user interface. While default values are based on ID.me’s design system, you have the flexibility to replace any or all of these to align with your application’s aesthetic. We provide customization options for the following elements:

• Colors: Modify the color scheme of various interface elements.
• Button Radius: Control the roundness of buttons within the Mobile SDK.
• Logo: Replace the default ID.me logo with your application’s logo.
• Fonts: Choose the fonts used for all text displayed in the document scanner interface.

1
let customUIConfig = DocScanUIConfig(
2
	colors: DocScanColors(
3
		background: UIColor.<insert color>,
4
		onBackground: UIColor.<insert color>,
5
		onBackgroundSecondary: UIColor.<insert color>,
6
		onBackgroundTertiary: UIColor.<insert color>,
7
		primary: UIColor.<insert color>,
8
		onPrimary: UIColor.<insert color>,
9
		secondary: UIColor.<insert color>,
10
		onSecondary: UIColor.<insert color>,
11
		cameraOverlay: UIColor.<insert color>,
12
		onCameraOverlay: UIColor.<insert color>,
13
		outline: UIColor.<insert color>,
14
		success: UIColor.<insert color>,
15
		error: UIColor.<insert color>
16
	),
17
	buttonRadius: <insert button radius>,
18
	logo: <insert logo>,
19
	fonts: DocScanFonts(
20
		regular: <insert font>,
21
		medium: <insert font>,
22
		bold: <insert font>
23
	)
24
)
25
26
// Sets the custom UI config on the document scanner
27
IdmeSDK.shared.getVerificationsManager().setDocScanUIConfig(customUIConfig)

Support