Skip to content

Latest commit

 

History

History
255 lines (192 loc) · 21.4 KB

integration_faq.md

File metadata and controls

255 lines (192 loc) · 21.4 KB

Header Graphic

FAQ

Table of Contents

User Consent

User consent is now acquired for all users to ensure the accordance with biometric data protection laws. Depending on the legal requirements, consent can be acquired in one of two ways: Active or passive.

For active consent instances, the user needs to accept the consent items explicitly, e.g. by enabling a UI switch or checking a checkbox for each consent item. For passive consent instances, it is enough to present the consent text and URL to the user. The user implicitly accepts the passive consent items by continuing with the journey.

Acquiring passive user consent

Acquiring active user consent

Acquired active user consent

Improve User Experience and Reduce Drop-off Rate

When evaluating user flows, one of the most commonly used metrics is the rate of drop-offs. At Jumio, we see considerable variance in drop-off rates across industries and customer implementations. For some implementations and industries, we see a higher rate of drop-offs on the first screens when compared with the average. Scanning an ID with sensitive personal data printed on it naturally creates a high barrier for participation on the part of the end user. Therefore, conversion rates can be significantly influenced when the application establishes a sense of trust and ensures that users feel secure sharing their information.

One pattern that is recognizable throughout all of our customers’ SDK implementations: the more seamless the SDK integration, and the better job is done of setting user expectations prior to the SDK journey, the lower the drop-off rate becomes.

Our SDK provides a variety of customization options to help customers achieve a seamless integration. For customers using the standard SDK workflow, our Surface tool provides an easy-to-use WYSIWYG interface to see simple customization options that can be incorporated with minimal effort and generate the code necessary to implement them. For customers who want to have more granular control over look and feel, our SDK offers the CustomUI option, which allows you to customize the entire user interface.

Example of a Non-Ideal SDK integration:

Onboarding bad case

  • Default SDK UI is used and is presented on one of the first screens during onboarding. The user is unprepared for the next steps and might not understand the intention behind the request to show their ID.

Suggested Improvements with Additional Customization:

Onboarding good case

  • Host application has an explanatory help screen that explains what will happen next and why this information is needed.
  • SDK is either customized to have a more embedded appearance or CustomUI is used to create a completely seamless integration in the UX of our customers.
  • Also after the Jumio workflow that shows the displayed results and/or a message that the ID is currently verified, which might take some minutes.

Managing Errors

Not every error that is returned from the SDK should be treated the same. The error codes listed for ID Verification should be handled specifically.

The following table highlights the most common error codes which are returned from the SDK and explains how to handle them appropriately in your application.

Code Cause Recommended Handling
A[xx][yyyy] Caused by temporary network issues like a slow connection. Advise to check the signal and retry the SDK journey.
E[xx][yyyy] Flight mode is activated or no connection available. The user should be asked to disable flight mode or to verify if the phone has proper signal. Advise to connect to WIFI and retry the SDK journey afterwards.
G[xx][0000] The user pressed back or X to exit the SDK while no error view was presented. Reasons for this could be manifold. Often it might be due to the fact that the user didn't have his identity document at hand. Give the user the option to retry.
J[xx][yyyy] The SDK journey was not completed within the session's max. lifetime. (The default is 15 minutes.) The user should be informed about the timeout and be directed to start a new Jumio SDK session.

Ad Blockers or Firewall

End users might face the situation where they are connected to a network that can't reach our Jumio endpoints.

Possible reasons for this might be ad blockers on the device, network wide ad blockers or network specific firewall settings.
In these cases the SDK will return a specific error code: A10900 If this error is received, we suggest to add a screen where the user is advised to switch network and/or turn off possible ad blockers.

Reducing the Size of Your App

The Netverify SDK contains a wide range of different scanning methods. The SDK is able to capture identity documents and extract information on the device using enhanced machine learning and computer vision technologies. The current download size of the sample application containing all products is around 12.5 MB as mentioned in the ID Verification guide. If you want to reduce the size of the SDK within your application, there are several ways to achieve this:

Strip Unused Modules

Depending on your specific needs, you may want to strip out unused functionality. As most of our modules can be linked optionally, you can reduce file size by adapting your Jumio dependencies in your build.gradle.

The following table shows a range of different product configurations with the size and modules that are linked for it. These measurements reflect the extra size that Jumio components add to your app download size and are based on our sample application.

Product Configuration Size Modules
Base 2.67 MB core
Base + iProov 3.52 MB core, iproov
Base + Autocapture 4.21 MB core, docfinder
Base + Autocapture, Barcode-Vision 4.51 MB core, docfinder, barcode-vision
Base + Autocapture, Barcode-Vision, iProov 5.35 MB core, docfinder, barcode, iproov
Base + Autocapture, Barcode-Vision, Liveness 6.28 MB core, docfinder, barcode, liveness
Base + Autocapture, Barcode-Vision, NFC 7.59 MB core, docfinder, barcode, nfc
All (Custom UI only) 10.33 MB core, docfinder, barcode-vision, iproov, nfc, devicerisk, digital-identity, camerax,liveness
Base + Autocapture, Default UI 4.60 MB core, docfinder, default-ui
Base + Autocapture, Default UI, Datadog 5.21 MB core, docfinder, default-ui, datadog
All (with Default UI) 11.17 MB core, docfinder, barcode-vision, iproov, nfc, devicerisk, default-ui, datadog, liveness

Note: The size values in the table above depict the decompressed install size required on a device and are comparable to the estimated Play Store files size. The size value might vary by a few percent, depending on the actual device used. All sizes are calculated based on a build of our sample application using arm64 architecture, english translations and xxhdpi screen resolution.

App Bundles

Android offers a way to reduce the size of a customer's built application using App bundles Google Play’s new app serving model uses the App bundle to generate and serve optimized APKs for each user’s device configuration, so they download only the code and resources they need to run your app.

Architectures, ABI Filters & Splitting

The SDK supports armeabi-v7a and arm64-v8a architecture. You can filter which architecture to use by specifying the abiFilters. That way, you could manually filter for armeabi-v7a as arm64-v8a.

Be aware: As of August 2019, Google Play Console will require that new apps and app updates with native libraries provide 64-bit versions in addition to their 32-bit versions, as mentioned in the Android developers blog..

Note: The abiFilters command in the ndk closure affects the Google Play Store filtering.

defaultConfig {
	ndk {
		abiFilters armeabi-v7a","arm64-v8a","x86","x86_64"
	}
}

It's also possible to manually provide a split apk on Google Play. The apk can be split based on the architecture if multiple apks should be uploaded to the Google Play Store. Google Play Store manages to deliver the appropriate apk for the device.

splits {
	abi {
		enable true
		reset()
		include armeabi-v7a","arm64-v8a","x86","x86_64"
		universalApk false
	}
}

Jumio Authentication Workflow Integration

Jumio Authentication can be used for any use case in which you want your end-users to confirm their identities. As a result of the Authentication journey you get a success or failed result back from the SDK or from our server (callback or retrieval).

In case of a successful result you can grant the user access to your service or let him proceed with the user flow. In case of a failed result, a proper retry handling within your workflow is necessary. A failure could occur because of the following reasons:

  • The user presenting their face is a different one than the user who owns the account
  • An imposter is trying to spoof the liveness check
  • User does not want to show their face at all, but is still trying to complete the onboarding
  • User does not look straight into the camera
  • User does not finish the first or second step of face scan
  • User has bad lighting conditions (too dark, too bright, reflections on face, not enough contrast, …)
  • User is covering (parts) of their face with a scarf, hat or something similar
  • A different person is scanning their face in the second step than in the first one
  • User is not able to align his face with the oval presented during scanning

In case an Authentication fail is returned, we recommend to allow the user between 3-5 Authentication attempts to prove their identity, before you lock the user from performing the action. This approach makes the most sense, as you don't want to lock out possible valid users who might not have completed the face capture task successfully for a legitimate reason. Don't worry about offering a potential fraudster more attempts to gain access to your system - our bullet proof liveness check does not allow them to get a successful result.

Fallback and Manual Capturing

The method isFallbackAvailable() determines if a fallback for the current scan mode is available and returns a boolean. If the method returns true, the available fallback scan mode will have to be started with the method startFallback().

The method showShutterButton() determines if a shutter button needs to be shown because the image has to be taken manually and returns a boolean. If the method returns true, you will have to display your own shutter button and call the method takePicture() once it is clicked.

Note: Please note that the method showShutterButton() does neither create nor display the actual shutter button!

"Manual capturing" simply refers to the user being able to manually take a picture. "Fallback" refers to an alternative scan mode the SDK can resort to if possible, in case there is an issue during the original scanning process. The fallback scan mode might be manual capturing in some cases, but not all.

Custom Theme

Custom Theme Is Not Working

Any customized theme needs to be defined in a styles.xml file and has to inherit from the parent theme Theme.Jumio.

<style name="AppTheme.JumioCustom" parent="Theme.Jumio">
  <item name="colorPrimary">@color/colorPrimary</item>
  ...
</style>

The actual name of the customized theme is arbitrary and can be chosen at will.

Any customized theme needs to be added to the AndroidManifest.xml file by replacing the initial Theme.Jumio.

<activity
  android:name="com.jumio.defaultui.JumioActivity"
  android:theme="@style/AppTheme.JumioCustom"
  ...
<activity/>

Scan Overlay Is Not Displayed

Make sure all necessary style attributes have been added to your custom theme specified in the style.xml file. In case of issues with scan overlay, all relevant attributes start with jumio_scanOverlay and face_scanOverlay.

An overview of all style attributes can be found here

Language Localization

Jumio Android Localization supports the default Android localization features for a number of different languages and cultures. Any language changes within the SDK or separate language support during runtime (meaning the SDK language differs from the overall device languages) are not possible.

All label texts and button titles in the SDK can be changed and localized by adding the required Strings you want to change in a strings.xml file in a values directory for the language and culture preference that you want to support. All modifiable strings can be modified can be found within our Sample application.

Currently, the following languages are automatically supported for your convenience: Supported languages

Runtime language changes within the SDK or separate language support (meaning the SDK language differs from the overall device languages) is not possible. All of the used string values can be found in the sample project resource folder. If you want to manage certain strings individually, please access them in the values-xx folder that corresponds to the language.

Note: The last two letters of the values folder (marked "xx" above) refer to the ISO alpha-2 country code, which has to be used for the localization to work automatically. Please refer to the country list if you have trouble determining which string file contains to which language.

Accessibility

Our SDK supports accessibility features. Visually impaired users can now enable TalkBack or increase the text size on their device. The accessibility-strings that are used by TalkBack contain accessibility in their key and can be also modified in the strings.xml.

String Updates

For an overview of all updates and changes of SDK string keys please refer to the revision history on Github.

Java 8 Compatibility

Jumio SDK uses Java 8 language. It is necessary to enable Java 8 source and target compatibility for in the build.gradle file using compileOptions:

android {
...
  compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

Overview of Scanning Methods

Autocapture

Combines all previously existing scanning methods into one automatic, seamless experience.

Autocapture Success Autocapture Scanning

Linefinder (deprecated)

As of SDK version 4.7.0 this module has been deprecated. Please use Autocapture instead. Scanning using edge detection.

Linefinder Empty Linefinder Document Linefinder Processing

MRZ (deprecated)

As of SDK version 4.7.0 this module has been deprecated. Please use Autocapture instead. Data extraction from passports, some identity cards and some visas.

MRZ Empty MRZ Document

Barcode (deprecated)

As of SDK version 4.7.0 this module has been deprecated. Please use Autocapture instead. PDF417 barcode data extraction, for example from US and Canadian driver licenses.

Barcode Empty Barcode Document

Manual Capture

Manual scanning (taking a picture) using the shutterbutton, fallback option in case user is having trouble.

Manual Capture Empty Manual Capture Document

NFC

Data extraction from eMRTD documents, for example passports.

NFC Start NFC Scanning

Glossary

A quick guide to commonly used abbreviations throughout the documentation which may not be all that familiar.

Google Play Store Prominent Disclosure

Some parts of the SDK might require prominent disclosure - please see the Privacy Notice section in the Integration Guide for further details

Jumio Support

The Jumio development team is constantly striving to optimize the size of our frameworks while increasing functionality, to improve your KYC and to fight fraud. If you have any further questions, please reach out to our support team.