Skip to content

What's new?

This section presents the changes that have been introduced in XpressID v4.11

Listed improvements:

  • Added a state/province selector to the document and country selector for the countries covered at that level (United States, Canada and Australia), enabled with the new regionChooser.
  • Added additionalDocumentTypes, the counterpart of excludedDocumentTypes, to add or remove the document types of a single country or state/province on top of documentKindFilter.
  • Added flowSetup.core.allowedChannels to declare the channels (web for a standard browser, webview for a WebView embedded in a native application) a process is allowed to start from.
  • Added new texts:
    • texts.document.[x].documentSelector.provinceSelectorTitle
    • texts.document.[x].documentSelector.provinceInputLabel
    • texts.document.[x].documentSelector.provinceInputPlaceholder
    • texts.document.[x].documentSelector.stateSelectorTitle
    • texts.document.[x].documentSelector.stateInputLabel
    • texts.document.[x].documentSelector.stateInputPlaceholder
  • Added borderRadius and borderRadiusSelected to styles.components.selectorItem. The card borderRadius is mapped to both of them while the Card component is deprecated.
  • Add new VideoMicrophonePermissionsGranted info event.
  • Add new ChannelNotSupported error event.
  • In desktop to mobile QR flows, all mobile errors are now reported in the desktop status modal. Additionally, the original error event is included in the QRProcessOnboardingError event under the sourceEvent field.
  • Integrate SDK Document version 6.9.0
  • Integrate SDK Selfie version 6.9.0
  • Integrate SDK Video version 6.9.0
  • Minor fixes and improvements.

Recommendation: remove the resize EventListener

We no longer recommend adding a resize EventListener to adjust the SFA dimensions, as described in the Integration guide. This approach can cause buttons rendered at the bottom of the screen to end up hidden behind the browser's navigation bar. If your integration already implements it, we recommend removing it.

Recommendation: check the exact origin of the received events

We recommend comparing the whole event.origin of the received events against the XpressID URL (event.origin === XpressID_URL) instead of looking for a substring in it (event.origin.includes("xpressid")), so no other website whose origin merely contains that text is accepted. The examples of the Integration guide have been updated, including the ones of the Webviews integration, where the check was missing.

Upcoming deprecations in version 2026.7

The following changes are planned for version 2026.7:

  • Deprecation of BlurredImageError Error data: Starting from version 4.8.2, BlurredImageError is deprecated in favor of ImageQualityError, which provides a more comprehensive assessment of image quality conditions.
  • Transitioning from type: info to type: error: The following events, currently deprecated under type: info, will no longer be sent as type: info:
    • DocumentCameraFailurePermissionError
    • DocumentCameraFailureDefaultError
    • DocumentCameraFailureExternalInputError
    • DocumentCameraFailureVideoNotFoundError
    • DocumentCameraAbortError
    • DocumentDetectionTimeout
    • DocumentDependenciesError
    • SelfieCameraFailurePermissionError
    • SelfieCameraFailureDefaultError
    • SelfieCameraFailureExternalInputError
    • SelfieCameraFailureVideoNotFoundError
    • SelfieCameraAbortError
    • SelfieDetectionTimeout
    • SelfieDependenciesError
    • VideoCameraFailurePermissionError
    • VideoCameraFailureDefaultError
    • VideoCameraFailureExternalInputError
    • VideoCameraFailureVideoNotFoundError
    • VideoCameraAbortError
    • VideoDetectionTimeout
    • VideoDependenciesError
  • Removal of legacy camera failure events: The DocumentCameraFailed, SelfieCameraFailed and VideoCameraFailed events will be removed, as they were split into the four more specific events listed above.
  • Removal of duplicated UnknownError on ApiTimeoutError: Currently, when an ApiTimeoutError occurs, an UnknownError event is also dispatched. This additional UnknownError event will no longer be sent.

Upcoming deprecations in version 2027.1

The following changes are planned for version 2027.1:

  • Component styles.card removed: The styles.card component will be replaced by styles.selectorItem. Until then, the values set in styles.card keep being mapped automatically to styles.selectorItem, as described in the Cards section.