Trulioo Compatible iOS SDK

The first thing you'll need to build a native iOS app for ID document image capture is Trulioo compatible iOS SDK:

You can request the SDK and detailed documentation from [email protected]

Prerequisite Knowledge

Before starting this guide, you should be comfortable with the following tools and technologies:

  • Trulioo’s API (especially Document Verification)
  • Objective-C or Swift
  • iOS application development & Xcode 11.31

Setup Overview


Xcode 11.3.1 is the best option, simply go to Apple developer site and download and install Xcode 11.3.1. Xcode 11.3 installer itself does not come with provision for any devices with newer iOS, i.e. 13.5.x. You will need to do the following to enable Xcode to support latest iOS.

Install Xcode

Go to Apple developer site and download iOS device support file for the corresponding iOS version

Copy and paste the downloaded file to Finder → Application → Xcode → Show package contents → Contents → Developer → Platforms → iPhoneS Platform → Device Support

Restart Xcode

Trulioo compatible iOS SDK

The SDK static libraries come compiled with armv7 and arm64 and cannot be run on simulator.

iOS Setup

The SDK will need both an environment and a device to run on:

  1. Install Xcode.
  2. Device requirements:
    • iOS 8.0 or later.
    • iPhone 4S and later, iPad 3 and later, iPad mini, iPod Touch 5G and later

Running the Sample App

Endpoint/Credential Configuration

You need the following information to configure the iOS app.

  • GlobalGateway endpoint :
  • API username and password
    Once you obtain these replace the corresponding variables with these values in TruliooHelp.swift

Trulioo Verify

With the sample app you should now have access to the camera screens the SDK provides and are able to capture images of documents. The next step is to send those images to Trulioo in order to Verify them. This can be done in one call to the Trulioo API.

Once the image is captured, convert it to a Base64 string and send as the DocumentFrontImage to the Verify endpoint. See the Document Verification Response section of our starter guide for how to process the Document Verification response from Trulioo.