Skip to content
Jumio Mobile SDK for iOS
Branch: master
Clone or download

Latest commit


Type Name Latest commit message Commit time
Failed to load latest commit information.
Carthage Final commit for 3.6.0 May 20, 2020
docs Final commit for 3.6.0 May 20, 2020
licenses Final commit for 2.15.0 Jan 25, 2019
sample Final commit for 3.6.0 May 20, 2020
.gitignore Final commit for 2.10.0 Jan 23, 2018 Final commit for 3.6.0 May 20, 2020


Version License Platform Pod Version Carthage compatible Swift 3.0-5.x

Table of Content

Release notes

SDK version: 3.6.0


  • Support for 5 new languages (Czech, Greek, Hungarian, Polish, Romanian) [Netverify/Fastfill, Authentication, Document Verification]
  • Added support for right-to-left languages [Netverify/Fastfill, Authentication, Document Verification]
  • Provide access to document guidance animation [Netverify Custom UI]
  • Added Carthage as an additional dependency manager [Netverify/Fastfill, Authentication, Document Verification, BAM Checkout]
  • Adjusted handling of document types which don’t support plastic documents [Netverify]


  • Improved accessibility handling [Netverify/Fastfill, Authentication, Document Verification]
  • Various smaller bug fixes/improvements [Netverify/Fastfill, Authentication, Document Verification]

Basic Setup

General Requirements

The minimum requirements for the SDK are:

  • iOS 10.0 and higher
  • Internet connection

The following architectures are supported in the SDK:

  • armv7 and arm64 for devices
  • x86_64 for iOS simulator

App thinning and size matters

App thinning (app slicing, bitcode and on-demand resources) is supported within the SDK. For app slicing, the image resources are placed within a xcassets collection. For Fastfill & Netverify, some resource files (e.g. images) are loaded on demand.

In case you experience a build error when building your app in Debug configuration and aim to run it on a device, we advise to temporarily disable the build setting "Enable Bitcode" in your Xcode project.


The app’s Info.plist must contain the NSCameraUsageDescription key with a string value explaining to the user how the app uses this data. Example: “This will allow to take photos of your credentials."


Check the Xcode sample project to learn the most common use. Make sure to use the device only frameworks for app submissions to the AppStore. Read more detailed information on this here: Manual integration

via Cocoapods

Jumio supports CocoaPods as dependency management tool for easy integration of the SDK.

Update your local clone of the specs repo in Terminal to ensure that you are using the latest podspec files:

pod repo update

Adapt your Podfile and add the pod according to the product(s) you use. Check the following example how a Podfile could look like:

source ''

use_frameworks! # Required for proper framework handling

pod 'JumioMobileSDK', '~>3.6.0' # Use Netverify, Authentication, Document Verification and BAM Checkout together in your app

pod 'JumioMobileSDK/Netverify', '~>3.6.0' # Use full Netverify and Authentication functionality
pod 'JumioMobileSDK/NetverifyBase', '~>3.6.0' # For Fastfill, Netverify basic functionality
pod 'JumioMobileSDK/NetverifyBarcode', '~>3.6.0' # For Fastfill, Netverify functionality with barcode extraction
pod 'JumioMobileSDK/NetverifyFace', '~>3.6.0' # For Fastfill, Netverify functionality with identity verification, Authentication

pod 'JumioMobileSDK/DocumentVerification', '~>3.6.0' # Use Document Verification functionality

pod 'JumioMobileSDK/BAMCheckout', '~>3.6.0' # Use BAM Checkout functionality

Install the pod to your project via Terminal:

pod install

via Carthage

Jumio supports Carthage as dependency management tool for easy integration of the SDK.

Adapt you Cartfile and add the JumioMobileSDK dependency. Check the following example how a Cartfile could look like:

binary "" == 3.6.0

Update you Carthage dependencies via Terminal:

carthage update


Download our frameworks manually via

Note: Our sample project on GitHub contains the sample implementation without our frameworks. The project file contains a “Run Script Phase” which downloads our frameworks automatically during build time.

The Jumio Mobile SDK consists of several dynamic frameworks. Add specific frameworks to your Xcode project, depending on which product you use.

Please see Strip unused frameworks for more information.

The framework binaries are available with support for device and simulator architecture. Make sure to remove the simulator architecture from our frameworks for app submissions to the AppStore. If this step is not performed, your submission will be rejection by Apple. Add the following code snippet as run script build phase to your app project and ensure that it is executed after the frameworks are embedded. Please see the required setup in our sample project.

Note: The simulator architecture is automatically removed if using cocoapods via "[CP] Embed Pods Frameworks" build phase.

if [[ "$CONFIGURATION" == "Release" ]]; then

Code snippet source:

Add the following linker flags to your Xcode Build Settings:
Note: Added automatically if using CocoaPods.

  • "-lc++"
  • "-ObjC" (recommended) or -all_load

Make sure that the following Xcode build settings in your app are set accordingly:

Setting Value
Link Frameworks Automatically YES


All label texts and button titles can be changed and localized using the Localizable-<YOUR_PRODUCT>.strings file. Just adapt the values to your required language, add it to your app or framework project and mark it as Localizable. This way, when upgrading our SDK to a newer version your localization file won't be overwritten. Make sure, that the content of this localization file is up to date after an SDK update. Note: If using CocoaPods, the original file is located under /Pods/JumioMobileSDK.

For our products Netverify & Fastfill, Authentication & Document Verification we support following languages for your convenience:

  • Chinese (Simplified)
  • Czech
  • Dutch
  • English
  • French
  • German
  • Greek
  • Hungarian
  • Italian
  • Polish
  • Portuguese
  • Romanian
  • Spanish

Please check out our sample project to see how to use the strings files in your app.

Our SDK supports Accessibility. Visually impaired users can enable VoiceOver or increased text size on their device. VoiceOver uses separate values in the localization file, which can be customised.

Get started


Previous version

The previous release version 3.5.0 of the Jumio Mobile SDK is supported until 2020-08-04.

In case the support period is expired, no bug fixes and technical support are provided anymore (bugs are typically fixed in the upcoming versions). Older SDK versions will keep functioning with our server until further notice, but we highly recommend to always update to the latest version to benefit from SDK improvements and bug fixes.


If you have any questions regarding our implementation guide please contact Jumio Customer Service at or The Jumio online helpdesk contains a wealth of information regarding our service including demo videos, product descriptions, FAQs and other things that may help to get you started with Jumio. Check it out at:

Two-factor Authentication

If you want to enable two-factor authentication for your Jumio merchant backend please contact us at Once enabled, users will be guided through the setup upon their first login to obtain a security code using the "Google Authenticator" app.


The software contains third-party open source software. For more information, please see licenses.

This software is based in part on the work of the Independent JPEG Group.


© Jumio Corporation, 395 Page Mill Road, Suite 150, Palo Alto, CA 94306

The source code and software available on this website (“Software”) is provided by Jumio Corp. or its affiliated group companies (“Jumio”) "as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall Jumio be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including but not limited to procurement of substitute goods or services, loss of use, data, profits, or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this Software, even if advised of the possibility of such damage. In any case, your use of this Software is subject to the terms and conditions that apply to your contractual relationship with Jumio. As regards Jumio’s privacy practices, please see our privacy notice available here: Privacy Policy.

You can’t perform that action at this time.