Onfido Android SDK Migration Guide

The guides below are provided to ease the transition of existing applications using the Onfido SDK from one version to another that introduces breaking API changes.

If your migration involves upgrading across multiple SDK versions, be sure to read each individual guide in order to account for all relevant breaking changes.

23.1.0 -> 23.2.0

String Changes

Added

The following string keys have been added:

• onfido_nfc_capture_scan_card_scanning_sheet_2 (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

22.1.0 -> 22.2.0

String Changes

Added

The following string keys have been added:

• onfido_generic_icon_error_accessibility (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

22.0.0 -> 22.1.0

Deprecated API Changes

• Usage of manually-generated SDK tokens alongside Studio workflows is deprecated. Please use Studio tokens returned in the payload when creating a workflow run. For more details see: https://documentation.onfido.com/api/latest/#sdk-tokens

21.2.0 -> 22.0.0

Breaking API Changes

• Updated the captures object in the userCompleted(captures) callback to support two-sided Proof of address documents. The object went from: ProofOfAddress(id=poa_id, type=UTILITY_BILL, issuing_country=UK)
  to ProofOfAddress(type=UTILITY_BILL, front = (id = front_side_id, type = (optional)), back = (id = back_side_id, type = (optional)))
• Removed EnterpriseFeatures's deprecated constructor. Use the builder instead
• Removed the deprecated CAMERA_PERMISSION_DENIED SDK exit code. This case is now handled by the SDK
• Removed OnfidoConfig.Builder's deprecated methods: withNFCReadFeature() and disableNFC(). Use withNFC(option: NFCOptions) instead
• OnfidoActivityTheme has been renamed to OnfidoLightTheme for consistency with OnfidoDarkTheme
• The attr suffix has been removed from all font family theme attributes for consistency with other attribute names
• Removed withBaseUrl API from the OnfidoConfig public APIs

String Changes

Removed

The following string keys have been removed:

• onfido_avc_confirmation_title ()
• onfido_avc_confirmation_subtitle ()
• onfido_avc_confirmation_button_primary_upload ()

21.1.0 -> 21.2.0

String Changes

Added

The following string keys have been added:

• onfido_retry_feedback_id_expired_title (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_id_unaccepted_title (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_id_generic_title (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_selfie_generic_title (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_id_expired_subtitle (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_id_unaccepted_subtitle (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_id_generic_subtitle (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_selfie_generic_subtitle (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_custom_title (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_custom_subtitle (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_retry_feedback_button_primary (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)## 20.5.0 -> 21.0.0

Platform Changes

• There might be a chance of getting "2 files found with path 'META-INF/versions/9/OSGI-INF/MANIFEST.MF'." during build or run tasks. If so, please add the following to your packagingOptions of the app/build.gradle file: packagingOptions.resources.excludes += "META-INF/versions/9/OSGI-INF/MANIFEST.MF"
• Please update your JDK version to version 17. Details: https://developer.android.com/build/jdks

Breaking API Changes

• Motion functionality has been enhanced to work seamlessly on all devices. You can safely remove any existing withCaptureFallback() implementations from your code
• Deprecated APIs are removed and need to be replaced with current ones
• Removed the deprecated withNFCReadFeature and disableNFC configuration options for OnfidoConfig in non-Studio usage scenarios. Please use withNFC(NFCOptions.Disabled) instead.

20.4.0 -> 20.5.0

Deprecated API Changes

• Deprecated disableNFC() use withNFC(NFCOptions.Disabled) instead

20.0.0 -> 20.4.0

String Changes

Added

The following string keys have been added:

• onfido_nfc_capture_scan_intro_passport_scan_guide_1 (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_nfc_scan_doc_realign_title (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_nfc_capture_scan_doc_realign_body (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_nfc_capture_scan_intro_passport_scan_guide_android_2 (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_nfc_capture_scan_intro_passport_scan_guide_android_3 (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)

• onfido_nfc_capture_scan_intro_passport_scan_guide_android_4 (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)## 19.6.0 -> 20.0.0

Breaking API Changes

• If you have imported the onfido-dfm-base module please remove the import and use onfido-public-api instead

19.5.0 -> 19.6.0

Breaking API Changes

• Added new ExitCode - REQUIRED_NFC_FLOW_NOT_COMPLETED
• Removed NFCOptions.Preferred. Consider using NFCOptions.Optional instead.

String Changes

Removed

The following string keys have been removed:

• onfido_app_title_doc_select (en, ar, bg, cs, da, de, el, en-rGB, es, es-rUS, et, fa, fi, fr, fr-rCA, hi, hr, hu, hy, in, it, iw, ja, ko, lt, lv, ms, nb, nl, nn, pl, pt, pt-rBR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-rCN, zh-rTW)## 19.2.2 -> 19.3.0

19.2.2 -> 19.3.0

Deprecation

• Motion capture fallbacks configuration is no longer supported from version 19.3.0 onwards as the SDK has been improved to mitigate device coverage issues. withCaptureFallback configuration has been marked as Deprecated and will be removed in an upcoming version.

String Changes

Added

The following string keys have been added:

• onfido_country_select_search_results_none_accessibility
• onfido_country_select_search_results_one_accessibility
• onfido_country_select_search_results_multiple_accessibility
• onfido_doc_confirmation_alert_odp_photo_of_screen_title
• onfido_doc_confirmation_alert_odp_screenshot_title
• onfido_doc_confirmation_alert_odp_photocopy_title
• onfido_doc_confirmation_alert_odp_scan_title
• onfido_doc_confirmation_alert_odp_detail
• onfido_doc_confirmation_button_secondary_change_document
• onfido_doc_confirmation_button_secondary_submit_anyway
• onfido_doc_capture_alert_manual_capture_video_title

19.0.0 -> 19.1.0

• Onfido SDK now supports the dark theme. By default, the user's active device theme will be automatically applied to the Onfido SDK. However, you can opt out from dynamic theme switching at run time and instead set a theme statically at the build time. In this case, the flow will always be in displayed in the selected theme regardless of the user's device theme. Please refer to the dark theme section in README.md for further details on how to configure the SDK with a static UI theme.
• Onfido's public colors defined in your colors.xml are now deprecated. Please refer to the "appearance and colors" section in README.md for our new theme-based UI customization approach and the list of available attributes and UI customization options.

18.0.0 -> 19.0.0

Breaking API changes

• Removed Parcelable implementation from MediaCallback and run it in the same process with the application.
• Removed Parcelable implementation from OnfidoAnalyticsEventListener and run it in the same process with the application.
• Removed Parcelable implementation from TokenExpirationHandler and run it in the same process with the application.

Deprecated API changes

• Deprecated withNFCReadFeature() in OnfidoConfig, as NFC is now enabled by default. Use disableNFC() if you want to disable NFC.

17.0.0 -> 18.0.0

Breaking API changes

• Updated the properties of MediaFile (used for custom media callbacks) - it now contains 3 attributes: the file data, file type and file name
• Dropped Attr suffix from font attribute names in OnfidoBaseActivityTheme.
• Removed the internal onfidoFontFamily attribute in OnfidoBaseActivityTheme.

Added

• The isOnfidoProcess extension function has been integrated into the Application class. If you have implemented a custom Application class and are also using Firebase, please ensure to follow the instructions provided in this documentation for correct setup and integration.

16.3.2 -> 17.0.0

Breaking changes

• After the release of version 17.0.0, Onfido Android SDK runs in a separate process. This means that when the callback is triggered, the body of that callback will run in Onfido SDK process rather than the main application process. Therefore, any actions performed in the callback, such as accessing memory or modifying UI, will be executed within the SDK process. It is important to keep this in mind when designing and implementing callbacks in order to ensure the proper functioning and performance of the SDK.

16.3.0 -> 16.3.1

Platform Changes

• Added default value to DocumentSide#nfcSupported to support backward compatibility.

15.4.0 -> 16.0.0

Breaking API changes

• Removed setUserEventHandler and getUserEventHandler for the UserEventHandler since it is deprecated. Please use OnfidoConfig.builder(context).withAnalyticsEventListener().

15.3.0 -> 15.4.0

String Changes

Added

The following string keys have been added:

• onfido_avc_intro_disclaimer_camera_and_audio_on

Changed

The following string keys have been changed:

• onfido_avc_intro_button_primary_ready
• onfido_avc_intro_disclaimer

15.1.0 -> 15.2.0

String Changes

Added

The following string keys have been added:

• onfido_enter_can_title
• onfido_enter_can_subtitle
• onfido_enter_can_button_primary
• onfido_enter_can_disclaimer
• onfido_enter_can_error_label
• onfido_enter_can_substring_attempt_singular
• onfido_enter_can_substring_attempt_plural
• onfido_nfc_scan_error_title
• onfido_nfc_scan_error_button_primary
• onfido_nfc_scan_error_button_secondary
• onfido_nfc_scan_error_list_item
• onfido_nfc_scan_error_list_item_2

Removed

The following string keys have been removed:

• onfido_nfc_fail_title
• onfido_nfc_fail_button_primary
• onfido_nfc_fail_button_secondary
• onfido_nfc_fail_list_item_remove_cover
• onfido_nfc_fail_list_item_keep_contact
• onfido_nfc_intro_subtitle_card
• onfido_nfc_intro_subtitle_passport
• onfido_nfc_intro_button_primary_card
• onfido_nfc_intro_button_primary_passport

Changed

The following string keys have been changed:

• onfido_nfc_intro_passport_scan_guide_1
• onfido_nfc_intro_passport_scan_guide_2
• onfido_nfc_intro_passport_scan_guide_3
• onfido_nfc_intro_passport_scan_guide_4

15.0.0 -> 15.1.0

String Changes

Changed

The following string keys have been changed:

• onfido_country_select_error_no_country_body_poa -> onfido_country_select_error_no_country_body
• onfido_nfc_sheet_scanning_button_secondary -> onfido_nfc_sheet_button_secondary
• onfido_nfc_intro_sheet_header_scanning -> onfido_nfc_intro_sheet_scanning_subtitle
• onfido_nfc_sheet_success_instruction -> onfido_nfc_sheet_success_instruction_passport
• onfido_doc_select_button_work_permit -> onfido_doc_select_button_permit_work
• onfido_doc_select_section_input_placeholder_country_copy -> onfido_doc_select_section_input_placeholder_country
• onfido_liveness_intro_loading_video -> onfido_video_intro_loader
• onfido_doc_select_section_input_placeholder_country -> onfido_doc_select_section_input_country_not_found
• onfido_doc_select_button_bill_detail_all -> onfido_doc_select_button_bill_detail
• onfido_liveness_fetch_challenge_error_description -> onfido_video_capture_prompt_network_timeout_detail
• onfido_liveness_intro_loading_video -> onfido_video_intro_loader

14.0.0 -> 15.0.0

Breaking changes

• In order to use Studio/Workflow, now it is required to include it as a separate dependency as below: implementation "com.onfido.sdk:onfido-workflow:$onfidoSdkVersion"

13.2.0 -> 14.0.0

Breaking API changes

• Removed all references to wording around beta for the NFC feature. NFC is no longer beta and generally available.

12.3.1 -> 13.0.0

String Changes

Added

The following string keys have been added:

• onfido_avc_face_alignment_feedback_move_left_accessibility
• onfido_avc_face_alignment_feedback_move_right_accessibility
• onfido_avc_face_alignment_feedback_move_up_accessibility
• onfido_avc_face_alignment_feedback_move_down_accessibility

Removed

The following string keys have been removed:

• onfido_permission_recovery_button_secondary_cam
• onfido_permission_recovery_button_secondary_mic
• onfido_permission_recovery_button_secondary_both
• onfido_welcome_list_item_doc
• onfido_permission_recovery_subtitle_video
• onfido_permission_recovery_extra_instructions_cam
• onfido_permission_recovery_extra_instructions_mic
• onfido_permission_recovery_extra_instructions_both
• onfido_permission_recovery_body_mic
• onfido_permission_recovery_body_cam
• onfido_permission_recovery_body_both
• onfido_app_title_user_consent
• onfido_country_select_error_no_country_body
• onfido_welcome_list_item_video
• onfido_doc_confirmation_body_visa
• onfido_welcome_list_item_selfie
• onfido_welcome_list_header_photo
• onfido_welcome_list_header_record
• onfido_welcome_list_header_doc_video
• onfido_app_title_doc_video_confirmation
• onfido_doc_capture_header_license_front_auto
• onfido_doc_capture_header_visa_back
• onfido_doc_capture_header_passport_auto
• onfido_doc_capture_header_license_back_auto
• onfido_doc_capture_frame_accessibility_pp_cover_manual
• onfido_doc_capture_frame_accessibility_pp_manual
• onfido_welcome_list_item_face_generic
• onfido_doc_capture_alert_no_face_title
• onfido_doc_capture_alert_no_face_detail
• onfido_doc_capture_header_live_guidance_distance_ok
• onfido_doc_capture_header_live_guidance_distance_ok_accessibility
• onfido_nfc_intro_sheet_scanning_subtitle
• onfido_avc_connection_error_button_primary_reload
• onfido_doc_select_button_bill_detail
• onfido_poa_country_not_found
• onfido_doc_select_extra_no_mobile
• onfido_label_doc_type_driving_license_short
• onfido_label_doc_type_residence_permit_short
• onfido_face_tracking_timeout_button_retry
• onfido_allow
• onfido_permission_subtitle_video
• onfido_permission_body_video
• onfido_accessibility_liveness_confirmation_view
• onfido_nfc_sheet_ready_button_secondary
• onfido_nfc_intro_sheet_header_scan_retry
• onfido_nfc_sheet_scanning_instruction_retry
• onfido_nfc_intro_sheet_header_fail_passport
• onfido_nfc_intro_sheet_header_fail_card
• onfido_nfc_intro_sheet_header_ready_card
• onfido_nfc_intro_sheet_header_ready_passport
• onfido_poa_document_submission_empty
• onfido_flow_user_exit_message_user_cancelled

12.2.3 -> 12.3.0

Added

The following string keys have been added:

• onfido_avc_intro_title_accessibility
• onfido_avc_intro_video_accessibility
• onfido_avc_face_capture_frame_accessibility
• onfido_avc_confirmation_left_side_complete_accessibility
• onfido_avc_confirmation_right_side_complete_accessibility
• onfido_avc_face_capture_title_accessibility
• onfido_avc_face_capture_recording_started_accessibility
• onfido_avc_face_alignment_feedback_face_aligned_accessibility
• onfido_avc_face_alignment_feedback_move_closer_accessibility
• onfido_avc_face_alignment_feedback_move_back_accessibility
• onfido_avc_face_alignment_title_accessibility
• onfido_avc_face_alignment_feedback_no_face_detected_accessibility

11.5.0 -> 12.0.0

Breaking API changes

• Removed the option to implement the user consent screen directly in your configuration during SDK initialization. It is now controlled by the Onfido backend. Please see our Onfido privacy notices and consent migration guide for further information.

String Changes

Changed

The following string keys have been changed:

• onfido_doc_capture_header_live_guidance_doc_position_ok_accessibility

11.0.0 -> 11.1.0

String Changes

Added

The following string keys have been added:

• onfido_nfc_intro_sheet_ready_subtitle_passport
• onfido_nfc_intro_sheet_scanning_subtitle
• onfido_nfc_intro_sheet_ready_subtitle_card
• onfido_nfc_intro_sheet_fail_instructions_card
• onfido_nfc_intro_sheet_fail_subtitle_card
• onfido_nfc_intro_sheet_fail_subtitle_passport
• onfido_nfc_intro_sheet_fail_instructions_passport

10.3.1 -> 11.0.0

Breaking API changes

• Removed deprecated withToken(token) and withApplicant(ID) from OnfidoConfig.Builder class. Mobile tokens are not supported anymore, please use SDK tokens with withSDKToken(token), otherwise you will get an authorization exception when creating an applicant.

String Changes

Added

The following string keys have been added:

• onfido_doc_capture_header_capturing
• onfido_nfc_intro_carousel_body_dont_move
• onfido_nfc_intro_carousel_body_last_page
• onfido_nfc_intro_carousel_body_lay_flat
• onfido_nfc_intro_carousel_body_phone_top
• onfido_nfc_intro_carousel_body_remove_cover

Changed

The following string keys have been changed:

• onfido_nfc_intro_subtitle_passport

Removed

The following string keys have been removed:

• onfido_doc_capture_header_scanning

10.3.0 -> 10.3.1

String Changes

Added

The following string keys have been added:

• onfido_nfc_select_title_passport
• onfido_nfc_select_subtitle_passport
• onfido_nfc_select_body_passport
• onfido_nfc_select_button_primary_passport
• onfido_nfc_select_button_secondary_passport
• onfido_nfc_intro_title_passport
• onfido_nfc_intro_subtitle_passport
• onfido_nfc_intro_button_primary_passport
• onfido_nfc_intro_sheet_header_ready_passport
• onfido_nfc_fail_title_passport
• onfido_nfc_fail_list_item_remove_cover_passport
• onfido_nfc_fail_list_item_keep_contact_passport
• onfido_nfc_fail_button_primary_passport
• onfido_nfc_fail_button_secondary_passport
• onfido_nfc_select_title_card
• onfido_nfc_select_subtitle_card
• onfido_nfc_select_body_card
• onfido_nfc_select_button_primary_card
• onfido_nfc_select_button_secondary_card
• onfido_nfc_intro_title_card
• onfido_nfc_intro_subtitle_card
• onfido_nfc_intro_sheet_header_ready_card
• onfido_nfc_fail_title_card
• onfido_nfc_fail_list_item_remove_cover_card
• onfido_nfc_fail_list_item_keep_contact_card
• onfido_nfc_sheet_success_instruction_card
• onfido_nfc_intro_sheet_header_fail_passport
• onfido_nfc_intro_button_primary_card
• onfido_nfc_intro_sheet_header_fail_card
• onfido_nfc_fail_button_primary_card
• onfido_nfc_fail_button_secondary_card

Changed

The following string keys have been changed:

• onfido_doc_capture_header_live_guidance_no_doc
• onfido_nfc_sheet_success_instruction

Removed

The following string keys have been removed:

• onfido_nfc_select_title
• onfido_nfc_select_subtitle
• onfido_nfc_select_button_primary
• onfido_nfc_select_button_secondary
• onfido_nfc_select_body
• onfido_nfc_intro_title
• onfido_nfc_intro_sheet_header_ready
• onfido_nfc_sheet_ready_subtitle
• onfido_nfc_intro_subtitle
• onfido_nfc_sheet_success_intruction
• onfido_nfc_intro_button_primary
• onfido_nfc_fail_title
• onfido_nfc_fail_list_item_remove_covers
• onfido_nfc_fail_list_item_keep_contact
• onfido_nfc_fail_button_primary
• onfido_nfc_fail_button_secondary

10.2.0 -> 10.3.0

String Changes

Added

The following string keys have been added:

• onfido_doc_capture_header_live_guidance_intro_doc_front_accessibility
• onfido_doc_capture_header_live_guidance_no_doc
• onfido_doc_capture_header_live_guidance_no_doc_accessibility
• onfido_doc_capture_header_live_guidance_distance_close
• onfido_doc_capture_header_live_guidance_distance_close_accessibility
• onfido_doc_capture_header_live_guidance_distance_far
• onfido_doc_capture_header_live_guidance_distance_far_accessibility
• onfido_doc_capture_header_live_guidance_distance_ok
• onfido_doc_capture_header_live_guidance_distance_ok_accessibility
• onfido_doc_capture_header_live_guidance_doc_too_left
• onfido_doc_capture_header_live_guidance_doc_too_left_accessibility
• onfido_doc_capture_header_live_guidance_doc_too_right
• onfido_doc_capture_header_live_guidance_doc_too_right_accessibility
• onfido_doc_capture_header_live_guidance_doc_too_high
• onfido_doc_capture_header_live_guidance_doc_too_high_accessibility
• onfido_doc_capture_header_live_guidance_doc_slightly_high
• onfido_doc_capture_header_live_guidance_doc_slightly_high_accessibility
• onfido_doc_capture_header_live_guidance_doc_too_low
• onfido_doc_capture_header_live_guidance_doc_too_low_accessibility
• onfido_doc_capture_header_live_guidance_doc_slightly_low
• onfido_doc_capture_header_live_guidance_doc_slightly_low_accessibility
• onfido_doc_capture_header_live_guidance_doc_position_ok
• onfido_doc_capture_header_live_guidance_doc_position_ok_accessibility
• onfido_doc_capture_header_live_guidance_intro_doc_front
• onfido_doc_capture_header_live_guidance_intro_doc_back
• onfido_doc_capture_header_live_guidance_intro_doc_back_accessibility
• onfido_doc_capture_header_live_guidance_intro_pp_photo
• onfido_doc_capture_header_live_guidance_intro_pp_photo_accessibility

10.1.0 -> 10.2.0

String Changes

Added

The following string keys have been added:

• onfido_welcome_list_header
• onfido_welcome_list_item_doc_photo
• onfido_welcome_list_item_doc_video
• onfido_welcome_list_item_doc_generic
• onfido_welcome_list_item_face_photo
• onfido_welcome_list_item_face_video
• onfido_welcome_list_item_face_generic
• onfido_nfc_select_title_passport
• onfido_nfc_select_subtitle_passport
• onfido_nfc_select_body_passport
• onfido_nfc_select_button_primary_passport
• onfido_nfc_select_button_secondary_passport
• onfido_nfc_intro_title_passport
• onfido_nfc_intro_subtitle_passport
• onfido_nfc_intro_button_primary_passport
• onfido_nfc_intro_sheet_header_ready_passport
• onfido_nfc_sheet_success_instruction
• onfido_nfc_fail_title_passport
• onfido_nfc_fail_list_item_remove_cover_passport
• onfido_nfc_fail_list_item_keep_contact_passport
• onfido_nfc_fail_button_primary_passport
• onfido_nfc_fail_button_secondary_passport
• onfido_nfc_select_title_card
• onfido_nfc_select_subtitle_card
• onfido_nfc_select_body_card
• onfido_nfc_select_button_primary_card
• onfido_nfc_select_button_secondary_card
• onfido_nfc_intro_title_card
• onfido_nfc_intro_subtitle_card
• onfido_nfc_intro_sheet_header_ready_card
• onfido_nfc_fail_title_card
• onfido_nfc_fail_list_item_remove_cover_card
• onfido_nfc_fail_list_item_keep_contact_card
• onfido_nfc_sheet_success_instruction_card
• onfido_nfc_intro_sheet_header_fail_passport
• onfido_nfc_intro_button_primary_card
• onfido_nfc_intro_sheet_header_fail_card
• onfido_nfc_fail_button_primary_card
• onfido_nfc_fail_button_secondary_card

Changed

The following string keys have been changed:

• onfido_doc_capture_header_folded_doc_front
• onfido_doc_capture_header_folded_doc_back
• onfido_doc_capture_header_license_front
• onfido_doc_capture_header_license_back
• onfido_doc_capture_header_permit_front
• onfido_doc_capture_header_permit_back
• onfido_doc_capture_header_id_front
• onfido_doc_capture_header_id_back
• onfido_doc_capture_header_permit_work_front
• onfido_doc_capture_header_generic_front
• onfido_doc_capture_header_permit_work_back
• onfido_doc_capture_header_generic_back
• onfido_doc_capture_header_visa_front
• onfido_doc_capture_header_visa_back
• onfido_doc_capture_header_passport
• onfido_doc_capture_header_license_front_auto
• onfido_doc_capture_header_license_back_auto
• onfido_doc_capture_header_passport_auto
• onfido_doc_capture_frame_accessibility_pp_auto
• onfido_doc_capture_frame_accessibility_dl_front_auto
• onfido_doc_capture_frame_accessibility_dl_back_auto
• onfido_doc_capture_frame_accessibility_pp_manual
• onfido_doc_capture_frame_accessibility_dl_front_manual
• onfido_doc_capture_frame_accessibility_dl_back_manual
• onfido_doc_capture_frame_accessibility_ic_front_manual
• onfido_doc_capture_frame_accessibility_ic_back_manual
• onfido_doc_capture_frame_accessibility_rp_front_manual
• onfido_doc_capture_frame_accessibility_rp_back_manual
• onfido_doc_capture_frame_accessibility_dl_fr_front_manual
• onfido_doc_capture_frame_accessibility_dl_fr_back_manual
• onfido_doc_capture_frame_accessibility_ic_it_front_manual
• onfido_doc_capture_frame_accessibility_ic_it_back_manual
• onfido_doc_capture_frame_accessibility_ic_za_front_manual
• onfido_doc_capture_frame_accessibility_ic_za_back_manual
• onfido_doc_capture_frame_accessibility_pp_cover_manual

Removed

The following string keys have been removed:

• onfido_nfc_select_title
• onfido_nfc_select_subtitle
• onfido_nfc_select_button_primary
• onfido_nfc_select_button_secondary
• onfido_nfc_select_body
• onfido_nfc_intro_title
• onfido_nfc_intro_sheet_header_ready
• onfido_nfc_intro_subtitle
• onfido_nfc_sheet_success_intruction
• onfido_nfc_intro_button_primary
• onfido_nfc_fail_title
• onfido_nfc_fail_list_item_remove_covers
• onfido_nfc_fail_list_item_keep_contact
• onfido_nfc_fail_button_primary
• onfido_nfc_fail_button_secondary

10.0.0 -> 10.1.0

String Changes

Added

The following string keys have been added:

• onfido_doc_capture_frame_accessibility_pp_auto
• onfido_doc_capture_frame_accessibility_dl_front_auto
• onfido_doc_capture_frame_accessibility_dl_back_auto
• onfido_doc_capture_frame_success_accessibility
• onfido_doc_capture_frame_accessibility_rp_front_manual
• onfido_doc_capture_frame_accessibility_rp_back_manual
• onfido_doc_capture_frame_accessibility_ic_front_manual
• onfido_doc_capture_frame_accessibility_ic_back_manual
• onfido_doc_capture_frame_accessibility_dl_fr_front_manual
• onfido_doc_capture_frame_accessibility_dl_fr_back_manual
• onfido_doc_capture_frame_accessibility_ic_it_front_manual
• onfido_doc_capture_frame_accessibility_ic_it_back_manual
• onfido_doc_capture_frame_accessibility_ic_za_front_manual
• onfido_doc_capture_frame_accessibility_ic_za_back_manual
• onfido_video_capture_frame_accessibility

Changed

The following string keys have been changed:

• onfido_selfie_capture_frame_accessibility

9.3.1 -> 10.0.0

Breaking API changes

• Removed deprecated methods and constructors of DocumentType class

String Changes

Added

The following string keys have been added:

• onfido_permission_recovery_button_primary
• onfido_permission_recovery_list_item_how_to_cam
• onfido_permission_recovery_list_item_action_cam
• onfido_permission_recovery_list_item_how_to_mic
• onfido_permission_recovery_list_item_action_mic
• onfido_permission_recovery_list_item_how_to_both
• onfido_permission_recovery_list_item_action_both
• onfido_video_capture_header_challenge_turn_forward
• onfido_generic_uploading
• onfido_doc_confirmation_alert_crop_detail
• onfido_doc_confirmation_alert_crop_title
• onfido_doc_upload_progress_label
• onfido_video_intro_list_item_time_limit_copy
• onfido_app_title_selfie_confirmation
• onfido_app_title_video_confirmation
• onfido_doc_capture_header_passport_auto
• onfido_doc_capture_detail_passport
• onfido_doc_capture_header_license_front_auto
• onfido_video_capture_body
• onfido_doc_capture_header_license_back_auto
• onfido_welcome_list_header_photo
• onfido_welcome_list_header_record
• onfido_app_title_doc_confirmation
• onfido_app_title_permission
• onfido_app_title_selfie_intro
• onfido_app_title_video_intro
• onfido_welcome_list_header_doc_video
• onfido_app_title_doc_video_confirmation
• onfido_video_capture_turn_success_accessibility

Removed

The following string keys have been removed:

• onfido_permission_extra_instructions_cam
• onfido_permission_extra_instructions_mic
• onfido_permission_extra_instructions_both
• onfido_permission_recovery_button_primary_cam
• onfido_permission_recovery_button_primary_mic
• onfido_permission_recovery_button_primary_both
• onfido_app_title_doc_capture_visa
• onfido_app_title_doc_capture_permit_work
• onfido_app_title_doc_capture_generic
• onfido_app_title_doc_capture_passport
• onfido_app_title_doc_capture_permit
• onfido_app_title_doc_capture_id
• onfido_app_title_doc_capture_license
• onfido_doc_capture_detail_passport_auto
• onfido_doc_confirmation_body_passport
• onfido_doc_confirmation_body_permit
• onfido_doc_confirmation_body_license
• onfido_doc_confirmation_body_id
• onfido_doc_confirmation_body_permit_work
• onfido_selfie_confirmation_button_primary_long
• onfido_selfie_confirmation_button_primary_short
• onfido_selfie_confirmation_button_secondary_long
• onfido_selfie_confirmation_button_secondary_short
• onfido_video_confirmation_title
• onfido_welcome_list_item_doc_video
• onfido_doc_confirmation_alert_no_barcode_title
• onfido_welcome_button_primary_selfie
• onfido_welcome_button_primary_video
• onfido_doc_capture_detail_license_front_auto

Changed

The following string keys have been changed:

• onfido_app_title_welcome
• onfido_permission_subtitle_cam
• onfido_permission_body_cam
• onfido_permission_recovery_title_cam
• onfido_permission_recovery_subtitle_cam
• onfido_permission_subtitle_mic
• onfido_permission_body_mic
• onfido_permission_recovery_title_mic
• onfido_permission_recovery_subtitle_mic
• onfido_permission_subtitle_both
• onfido_permission_body_both
• onfido_permission_button_primary_both
• onfido_permission_recovery_title_both
• onfido_permission_recovery_subtitle_both
• onfido_doc_confirmation_button_primary_passport
• onfido_doc_confirmation_button_primary_permit
• onfido_doc_confirmation_button_primary_license
• onfido_doc_confirmation_button_primary_id
• onfido_doc_confirmation_button_primary_visa
• onfido_doc_confirmation_button_primary_generic
• onfido_doc_confirmation_button_primary_barcode
• onfido_doc_confirmation_button_primary_permit_work
• onfido_doc_confirmation_button_secondary_passport
• onfido_doc_confirmation_button_secondary_id
• onfido_doc_confirmation_button_secondary_license
• onfido_doc_confirmation_button_secondary_permit
• onfido_doc_confirmation_button_secondary_permit_work
• onfido_doc_confirmation_button_secondary_visa
• onfido_doc_confirmation_button_secondary_generic
• onfido_video_capture_header_challenge_turn_left
• onfido_video_capture_header_challenge_turn_right
• onfido_video_intro_button_primary
• onfido_selfie_intro_button_primary
• onfido_doc_select_button_license
• onfido_doc_select_button_permit
• onfido_welcome_subtitle
• onfido_welcome_list_item_doc
• onfido_welcome_list_item_selfie
• onfido_welcome_list_item_video
• onfido_video_intro_title
• onfido_doc_select_title
• onfido_doc_select_subtitle
• onfido_country_select_bottom_sheet_details
• onfido_country_select_bottom_sheet_link_doc_select
• onfido_selfie_intro_subtitle
• onfido_selfie_intro_list_item_face_forward
• onfido_selfie_intro_list_item_no_glasses
• onfido_selfie_capture_body
• onfido_selfie_confirmation_body
• onfido_doc_capture_detail_visa_front
• onfido_doc_capture_detail_visa_back
• onfido_selfie_confirmation_alert_no_face_title
• onfido_selfie_confirmation_alert_no_face_detail
• onfido_doc_confirmation_alert_no_doc_detail
• onfido_doc_confirmation_body_visa
• onfido_doc_confirmation_body_generic
• onfido_doc_capture_detail_permit_front
• onfido_doc_capture_detail_permit_back
• onfido_doc_capture_detail_license_front
• onfido_doc_capture_detail_license_back
• onfido_doc_capture_detail_id_front
• onfido_doc_capture_detail_id_back
• onfido_doc_capture_detail_permit_work_front
• onfido_doc_capture_detail_generic_front
• onfido_doc_capture_detail_permit_work_back
• onfido_doc_capture_detail_generic_back
• onfido_doc_capture_alert_glare_title
• onfido_video_intro_subtitle
• onfido_video_intro_list_item_move_speak
• onfido_video_intro_list_item_time_limit
• onfido_video_capture_prompt_detail_timeout
• onfido_video_confirmation_button_audio_unmute
• onfido_country_select_error_no_country_title
• onfido_country_select_error_no_country_body
• onfido_doc_capture_alert_manual_capture_detail
• onfido_doc_confirmation_alert_blur_title
• onfido_doc_confirmation_alert_blur_detail
• onfido_doc_capture_alert_no_barcode_title
• onfido_doc_capture_header_passport
• onfido_permission_body_mic
• onfido_permission_body_both
• onfido_doc_confirmation_button_primary_passport
• onfido_doc_confirmation_button_primary_id
• onfido_doc_confirmation_button_primary_visa
• onfido_doc_confirmation_button_primary_generic
• onfido_doc_confirmation_button_primary_barcode
• onfido_doc_confirmation_button_primary_folded_doc
• onfido_selfie_confirmation_button_secondary
• onfido_selfie_confirmation_button_primary
• onfido_app_title_doc_select
• onfido_welcome_button_primary_doc
• onfido_video_intro_video_accessibility
• onfido_video_capture_frame_success_accessibility
• onfido_video_confirmation_video_accessibility
• onfido_video_capture_header_challenge_digit_instructions_accessibility
• onfido_video_capture_header_challenge_turn_instructions_accessibility
• onfido_video_capture_header_extra_instructions_accessibility
• onfido_video_capture_header_challenge_turn_left_accessibility
• onfido_video_capture_header_challenge_turn_right_accessibility
• onfido_video_confirmation_button_play_and_pause_accessibility
• onfido_doc_capture_button_accessibility

9.2.0 -> 9.3.0

Platform changes

• Migrated from JCenter to Maven Central. You will need to add mavenCentral() into the repositories block, if it is not already added.

9.0.0 -> 9.1.0

String Changes

Added

The following string keys have been added:

• onfido_user_consent_button_primary
• onfido_user_consent_button_secondary
• onfido_user_consent_prompt_no_consent_title
• onfido_user_consent_prompt_no_consent_detail
• onfido_user_consent_prompt_button_primary
• onfido_user_consent_prompt_button_secondary
• onfido_app_title_user_consent

Deprecated API Changes

• CAMERA_PERMISSION_DENIED in ExitCode enum is deprecated as permissions are being handled inside the SDK.

8.1.0 -> 9.0.0

Breaking changes

• Updated to OkHttp4. In order to prevent runtime issues due to library conflicts, the host app must match the major version of the OkHttp.

7.4.0 -> 8.0.0

Breaking changes

• Minimum Android API level (minSdkVersion) support has been updated from 16 to 21. Onfido SDK will stop supporting Android 4.x starting with this version.

String Changes

Added:

The following string keys have been added:

• onfido_outro_body

Changed

The following string keys have been changed:

• onfido_video_confirmation_button_primary

7.3.0 -> 7.4.0

String Changes

Added:

The following string keys have been added:

• onfido_app_title_doc_capture_id_za

Changed

• ⚠️ Most of the localisation keys have been renamed. If you have customised any of the Onfido SDK's strings in your project, you may use migrate-keys.rb script and key mapping file key_migration_7_3_0_mapping.json to migrate from 7.3.0 to 7.4.0

1migrate-keys.rb --files-path <app/src/main/res/> --platform android --key-mapping-file key_migration_7_3_0_mapping.json

7.0.0 -> 7.1.0

Deprecated API Changes

• EnterpriseFeatures class' constructor is deprecated. Please use EnterpriseFeatures.Builder instead.

Before:

Kotlin

1EnterpriseFeatures(true)

Java

1new EnterpriseFeatures(true);

After:

Kotlin

1val enterpriseFeatures: EnterpriseFeatures = EnterpriseFeatures.Builder().withHideOnfidoLogo(true).build()

Java

1EnterpriseFeatures enterpriseFeatures = EnterpriseFeatures.builder().withHideOnfidoLogo(true).build();

6.0.0 -> 7.0.0

Breaking changes

• Migrated to AndroidX. If your app hasn't completed AndroidX migration yet, please see AndroidX Migration.

String Changes

Changed:

The following string keys have been changed:

• onfido_autocapture_manual_fallback_title
• onfido_autocapture_manual_fallback_description

5.6.0 -> 6.0.0

Breaking changes

• Removed out-of-the-box Portuguese (pt) translation. If you would like to keep supporting Portuguese by providing your own XML files, please see README
• SDK will return DocumentType.UNKNOWN to mirror the Onfido API response as part of the Captures object which is provided by handleActivityResult if residence permit or generic is selected

String Changes

Added

The following string keys have been added:

• onfido_accessibility_video_pause
• onfido_accessibility_video_play

5.5.0 -> 5.6.0

Deprecated API Changes

• The CaptureScreenStep class is deprecated. We now recommend DocumentCaptureStepBuilder to customise document capture steps

Before:

Java

1new CaptureScreenStep(DocumentType.NATIONAL_IDENTITY_CARD, CountryCode.GB);

Kotlin

1CaptureScreenStep(DocumentType.NATIONAL_IDENTITY_CARD, CountryCode.GB)

After:

Java

1DocumentCaptureStepBuilder.forNationalIdentity()
2                .withCountry(CountryCode.GB)
3                .build();

Kotlin

1DocumentCaptureStepBuilder.forNationalIdentity()
2                .withCountry(CountryCode.GB)
3                .build()

• The FaceCaptureStep class is deprecated. We now recommend FaceCaptureStepBuilder to customise face capture steps

Before:

Java

1FlowStep selfieCaptureStep = new FaceCaptureStep(new FaceCaptureVariantPhoto(false));
2
3FlowStep videoCaptureStep = new FaceCaptureStep(new FaceCaptureVariantVideo(false));

Kotlin

1val selfieCaptureStep = FaceCaptureStep(FaceCaptureVariantPhoto(false))
2
3val videoCaptureStep = FaceCaptureStep(FaceCaptureVariantVideo(false))

After:

Java

1FlowStep selfieCaptureStep = FaceCaptureStepBuilder.forPhoto()
2                .withIntro(false)
3                .build();
4
5FlowStep videoCaptureStep = FaceCaptureStepBuilder.forVideo()
6                .withIntro(false)
7                .build();

Kotlin

1val selfieCaptureStep = FaceCaptureStepBuilder.forPhoto()
2                .withIntro(false)
3                .build()
4
5        val videoCaptureStep = FaceCaptureStepBuilder.forVideo()
6                .withIntro(false)
7                .build()

String Changes

Added:

The following string keys have been added:

• onfido_mrz_not_detected_title
• onfido_mrz_not_detected_subtitle

5.3.3 -> 5.4.0

String Changes

Added:

The following string keys have been added:

• onfido_italian_id_capture_title
• onfido_french_driving_license_capture_title
• onfido_folded_paper_option
• onfido_plastic_card_option
• onfido_driving_license_type_selection_title
• onfido_national_identity_type_selection_title
• onfido_folded_paper_front_capture_title
• onfido_folded_paper_front_capture_subtitle
• onfido_folded_paper_back_capture_title
• onfido_folded_paper_back_capture_subtitle
• onfido_folded_paper_confirmation_title
• onfido_upload_photo
• onfido_retake_photo

Deprecation

• Deprecated properties of DocumentType class

4.5.0-F5 -> 5.3.2 - [enterprise]

Breaking API changes

• Removed OnfidoCertificatePinningSettings class which has ONFIDO_API parameter to provide root certificate's hash value. For more information, please visit our README.md

5.2.0 -> 5.3.0

String Changes

Added

The following string keys have been added:

• onfido_label_doc_type_generic_up

Changed

The following string keys have been changed:

• onfido_accessibility_liveness_video_example

5.1.0 -> 5.2.0

String Changes

Added

The following string keys have been added:

• onfido_accessibility_liveness_face_detected

5.0.1 -> 5.1.0

String Changes

Added

The following string keys have been added:

• onfido_accessibility_camera_document_capture_view
• onfido_accessibility_face_confirmation_view
• onfido_accessibility_document_confirmation_view
• onfido_accessibility_liveness_confirmation_view
• onfido_accessibility_video_preview_recorded
• onfido_accessibility_liveness_digits
• onfido_accessibility_liveness_move
• onfido_accessibility_then
• onfido_accessibility_liveness_left
• onfido_accessibility_liveness_right
• onfido_accessibility_liveness_play_pause
• onfido_accessibility_take_picture

5.0.0 -> 5.0.1

Changed

• No longer obfuscating com.monadtek.mvp package

4.11.0 -> 5.0.0

Applicant removal and Token change

Breaking change

• Applicant class removed from the SDK
• Applicant parameter removed from the OnfidoResultListener callback methods
• Removed deprecated withApplicant(Applicant) method on the OnfidoConfig.Builder class as SDK no longer creates applicants

Deprecation

• The withApplicant(String) and the withToken(String) methods are deprecated from the OnfidoConfig.Builder, we now recommend that create a SDK Token on your backend which contains applicantId and use withSDKToken(String) method to initialise the OnfidoConfig

Before

The initialisation of the SDK by passing the applicant ID and the (static) mobile token:

1val OnfidoConfig config = OnfidoConfig.builder()
2            .withToken("YOUR_MOBILE_TOKEN")
3            .withApplicant("YOUR_APPLICANT_ID")
4            .build();

or if you were using the deprecated withApplicant(Applicant) method:

1val applicant = Applicant.builder()  
2        .withFirstName("Your first name")  
3        .withLastName("Your first name")  
4        .build()  
5  
6val onfidoConfig = OnfidoConfig.builder()  
7        .withApplicant(applicant)
8        .withToken("YOUR_MOBILE_TOKEN")
9        .build();

The SDK callback where the Applicant type object was passed:

1@Override
2protected void onActivityResult(int requestCode, int resultCode, Intent data) {
3    ...
4    onfido.handleActivityResult(resultCode, data, new Onfido.OnfidoResultListener() {
5        @Override
6        public void userCompleted(Applicant applicant, Captures captures) {
7            //communicate with your backend and initiate the check
8        }
9
10        @Override
11        public void userExited(ExitCode exitCode, Applicant applicant) {
12            //User left the sdk flow without completing it
13        }
14
15        @Override
16        public void onError(OnfidoException exception, @Nullable Applicant applicant) {
17            // An exception occurred during the flow
18        }
19    });
20}

After

Neither the (static) mobile token nor the Applicant ID are expected anymore, you are now expected to pass the SDK token which is generated by calling the Onfido API:

1val sdkToken: String = createSdkToken() // https://github.com/onfido/onfido-android-sdk/blob/master/README.md#41-sdk-token 
2  
3val onfidoConfig = OnfidoConfig.builder(context)  
4        .withSDKToken(sdkToken) 
5        .build()

The SDK callback no longer passes an Applicant object:

1@Override
2protected void onActivityResult(int requestCode, int resultCode, Intent data) {
3    ...
4    onfido.handleActivityResult(resultCode, data, new Onfido.OnfidoResultListener() {
5        @Override
6        public void userCompleted(Captures captures) {
7            //communicate with your backend and initiate the check
8        }
9
10        @Override
11        public void userExited(ExitCode exitCode) {
12            //User left the sdk flow without completing it
13        }
14
15        @Override
16        public void onError(OnfidoException exception) {
17            // An exception occurred during the flow
18        }
19    });
20}

US Driver's license optional feature

Breaking change

• Removed withUSDLAutocapture() method from the OnfidoConfig.Builder. Autocapture enabled by default for the US driving licences.

Added strings:

• onfido_autocapture_manual_fallback_title
• onfido_autocapture_manual_fallback_description

Removed strings:

• onfido_autocapture_info
• onfido_press_button_capture
• onfido_barcode_error_subtitle
• onfido_barcode_error_third_title

Changed Strings:

• onfido_barcode_error_title

4.8.0 -> 4.11.0

Added strings:

• onfido_accessibility_liveness_video_example
• onfido_accessibility_camera_face_capture_view

4.7.0 -> 4.8.0

Added strings:

• onfido_label_doc_type_work_permit_up
• onfido_message_side_document_front_generic
• onfido_message_side_document_back_generic
• onfido_message_check_readability_subtitle_generic
• onfido_message_document_capture_info_front_generic
• onfido_message_document_capture_info_back_generic
• onfido_confirm_generic_document

Removed strings:

• onfido_label_doc_type_passport
• onfido_label_doc_type_driving_license
• onfido_label_doc_type_id_card
• onfido_label_doc_type_visa

4.6.0 -> 4.7.0

Changed Strings:

• onfido_country_selection_toolbar_title
• onfido_unsupported_document_description

4.5.1 -> 4.6.0

Added Strings:

• onfido_label_doc_type_visa
• onfido_label_doc_type_visa_up
• onfido_message_document_visa
• onfido_message_check_readability_subtitle_visa
• onfido_confirm_visa
• onfido_liveness_intro_subtitle
• onfido_liveness_intro_step_1_title
• onfido_liveness_intro_step_2_title
• onfido_liveness_intro_loading_video
• onfido_reload
• onfido_unable_load_unstable_network
• onfido_unable_load_offline

Removed strings:

• onfido_next
• onfido_liveness_intro_title
• onfido_liveness_intro_subtitle_1_action
• onfido_liveness_intro_subtitle_2_actions
• onfido_liveness_intro_subtitle_some_actions
• onfido_liveness_intro_third_subtitle_1_action
• onfido_liveness_intro_third_subtitle_2_actions
• onfido_liveness_intro_third_subtitle_some_actions
• onfido_liveness_challenge_open_mouth_title
• onfido_liveness_challenge_next
• onfido_liveness_challenge_stop
• onfido_stop
• onfido_liveness_challenge_recording
• onfido_video_recorded
• onfido_camera_access_recover_instructions_subtitle

3.0.0 -> 4.0.0

• Changed the Applicant parameter on the userCompleted(Applicant applicant, Captures captures) callback to be a non-nullable field, meaning that we guarantee this field will always contain information about the applicant whenever this callback is called. Any null check being applied may now be deleted.
• Changed the Applicant parameter on the onError(OnfidoException exception, @Nullable Applicant applicant) callback to be a nullable value, meaning that depending on the error originating the callback, the applicant details might be null. Therefore, developers should add the correspondent null check before accessing its information.

2.4.0 -> 3.0.0

• Added onError(OnfidoException exception, Applicant applicant) method on the Onfido object, used to get the result of the identity verification flow. This callback will be called whenever an exception that the end-user should not be able to overcome by itself occurs during the flow. The new method should be implemented and the exception handled accordingly.

• Upgraded our infrastructure and SDK client SSL configurations to support TLSv1.2 only. According to the relevant Google documentation, this support comes enabled by default on every device running Android API 20+. In case you need to support devices older than that in your integration with the Onfido Android SDK, we need to access Google Play Services to install the latest security updates, which enable this support. As such, if you don't use Google Play Services on your integration yet, we require you to add the following dependency:

  gradle

  1compile ('com.google.android.gms:play-services-base:x.y.z') {
  2           exclude group: 'com.android.support' // to avoid conflicts with your current support library
  3}

2.0.0 -> 2.1.0

Deprecations

• Deprecated withApplicant(Applicant applicant) method. We now recommend that you create an Onfido applicant yourself on your backend and the withApplicant(String id) method should be called with the id of the created applicant.

1.0.0 -> 2.0.0

Breaking changes

• Removed FlowStep.MESSAGE_FACE_VERIFICATION, which is now automatically added before any face capture with the variant FaceCaptureVariant.PHOTO. This way, any inclusion of this step in a custom flow should be removed

0.9.2 -> 1.0.0

Breaking changes

• Removed the allowMetrics(boolean) method from the OnfidoConfig.Builder object. Every call to this method should be deleted
• Removed the previously deprecated FlowStep.MESSAGE_IDENTIFY_VERIFICATION enum instance, as it was too specific for our generic flow intentions. Every previous inclusion of this object on a flow should be replaced by a custom MessageScreenStep