v15.2.0 release

RN SDK Release User · RN SDK Release User · commit 780305bae8bb · 2025-09-15T13:37:59.000Z
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## Future version
 
+## [15.2.0] - 2025-09-12
+
+### Added:
+
+- Support for Generic Document
+
+### Changed:
+
+- Updated underlying Onfido native SDK version:
+  - Android 23.2.x (up from 23.1.x)
+
+## [15.1.0] - 2025-09-03
+
 ### Fixed:
 
 - Fixed Kosovo XKX country code support
diff --git a/README.md b/README.md
@@ -580,9 +580,13 @@ export default class App extends Component {
   * **`proofOfAddress`**: **Optional**. This toggles the proof of address screen on or off. If omitted, this screen does not appear in the flow. Valid values are `true` or `false`
   * **`captureDocument`**: **Optional**. This object contains configurations for the document capture screen. If `docType` and `countryCode` are not specified, a screen will appear allowing the user to choose the document type and issuing country. If all parameters are not specified or the step is omitted, this screen will not appear in the flow.
     * **`docType`**: **Required** if `countryCode` is specified.
-      * Valid values in `OnfidoDocumentType`: `PASSPORT`, `DRIVING_LICENCE`, `NATIONAL_IDENTITY_CARD`, `RESIDENCE_PERMIT`, `RESIDENCE_PERMIT`, `VISA`, `WORK_PERMIT`. <br>
+      * Valid values in `OnfidoDocumentType`: `PASSPORT`, `DRIVING_LICENCE`, `NATIONAL_IDENTITY_CARD`, `RESIDENCE_PERMIT`, `RESIDENCE_PERMIT`, `VISA`, `WORK_PERMIT`, `GENERIC`. <br>
     * **`countryCode`**: **Required** if `docType` is specified.
       * Valid values in `OnfidoCountryCode`: Any ISO 3166-1 alpha-3 code. For example: `OnfidoCountryCode.USA`.
+    * **`pages`**: **Required** if `docType` is `GENERIC`, will have no effect otherwise.
+      * Valid values in `OnfidoDocumentPages`: `SINGLE`, `FRONT_AND_BACK`.
+    * **`title`**: **Required** if `docType` is `GENERIC`, will have no effect otherwise.
+      * This is used to specify the type of document, any string is permitted here. (`Tax Id`, `Voter Id`, etc.)
     * **`allowedDocumentTypes`**: **Optional**. If specified, `docType` and `countryCode` must not be specified. This parameter allows you to specify a list of document types that can be selected for all available issuing countries.
       * Valid values in `OnfidoDocumentType`: `PASSPORT`, `DRIVING_LICENCE`, `NATIONAL_IDENTITY_CARD`, `RESIDENCE_PERMIT`, `RESIDENCE_PERMIT`, `VISA`, `WORK_PERMIT`.
   * **`captureFace`**: **Optional**. This object contains configuration options for the face capture screen. If omitted, this screen does not appear in the flow.
diff --git a/android/build.gradle b/android/build.gradle
@@ -13,7 +13,7 @@
 def DEFAULT_COMPILE_SDK_VERSION = 34
 def DEFAULT_MIN_SDK_VERSION = 21
 def DEFAULT_TARGET_SDK_VERSION = 34
-def NATIVE_ANDROID_SDK_VERSION = "23.1.+"
+def NATIVE_ANDROID_SDK_VERSION = "23.2.+"
 
 def safeExtGet(prop, fallback) {
     rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
diff --git a/android/src/main/AndroidManifest.xml b/android/src/main/AndroidManifest.xml
@@ -8,6 +8,6 @@
 
         <meta-data
             android:name="onfido_integration_version"
-            android:value="15.1.0" />
+            android:value="15.2.0" />
     </application>
 </manifest>
diff --git a/android/src/main/java/com/onfido/reactnative/sdk/OnfidoSdkModule.java b/android/src/main/java/com/onfido/reactnative/sdk/OnfidoSdkModule.java
@@ -23,6 +23,7 @@
 import com.onfido.android.sdk.capture.analytics.OnfidoAnalyticsEventListener;
 import com.onfido.android.sdk.capture.config.BiometricTokenCallback;
 import com.onfido.android.sdk.capture.config.MediaCallback;
+import com.onfido.android.sdk.capture.document.DocumentPages;
 import com.onfido.android.sdk.capture.errors.EnterpriseFeatureNotEnabledException;
 import com.onfido.android.sdk.capture.errors.EnterpriseFeaturesInvalidLogoCobrandingException;
 import com.onfido.android.sdk.capture.model.NFCOptions;
@@ -437,11 +438,32 @@ private static void extractDocTypeAndCountryForCaptureStep(
         String countryCodeString = captureDocument.getString("alpha2CountryCode");
         CountryCode countryCodeEnum = findCountryCodeByAlpha2(countryCodeString);
 
-    if (countryCodeEnum == null) {
-      System.err.println("Unexpected countryCode value: [" + countryCodeString + "]");
-      throw new Exception("Unexpected countryCode value.");
-    }
-    flowStepList.add(getFlowStep(docTypeEnum, countryCodeEnum));
+        if (countryCodeEnum == null) {
+          System.err.println("Unexpected countryCode value: [" + countryCodeString + "]");
+          throw new Exception("Unexpected countryCode value.");
+        }
+
+        if (docTypeString.equals("GENERIC")) {
+            final boolean pagesExists = captureDocument.hasKey("pages");
+
+            if (pagesExists) {
+                String pagesString = captureDocument.getString("pages");
+                try {
+                    DocumentPages documentPagesEnum = DocumentPages.valueOf(pagesString);
+                    flowStepList.add(
+                        DocumentCaptureStepBuilder
+                            .forGenericDocument()
+                            .withCountry(countryCodeEnum)
+                            .withDocumentPages(documentPagesEnum)
+                            .build()
+                    );
+                } catch (IllegalArgumentException e) {
+                    throw new IllegalArgumentException("Unsupported pages value: " + pagesString);
+                }
+            }
+        } else {
+            flowStepList.add(getFlowStep(docTypeEnum, countryCodeEnum));
+        }
   }
 
   private static FlowStep getFlowStep(
diff --git a/ios/OnfidoConfigBuilder.swift b/ios/OnfidoConfigBuilder.swift
@@ -149,9 +149,19 @@ struct OnfidoConfigBuilder {
                     type: .workPermit(config: WorkPermitConfiguration(country: countryCode))
                 )
             case .generic:
-                builder.withDocumentStep(
-                    type: .generic(config: GenericDocumentConfiguration(country: countryCode))
-                )
+                if let title = steps.captureDocument?.title,
+                let pages = steps.captureDocument?.pages {
+                    switch pages {
+                    case .single:
+                        builder.withDocumentStep(
+                            type: .generic(config: try GenericDocumentConfiguration(title: title, country: countryCode, pages: .single))
+                        )
+                    case .frontAndBack:
+                        builder.withDocumentStep(
+                            type: .generic(config: try GenericDocumentConfiguration(title: title, country: countryCode, pages: .frontAndBack))
+                        )
+                    }
+                }
             }
 
         } else if let allowedDocumentTypes = steps.captureDocument?.allowedDocumentTypes {
diff --git a/ios/OnfidoPluginConfig.swift b/ios/OnfidoPluginConfig.swift
@@ -31,6 +31,8 @@ struct OnfidoCaptureDocument: Codable {
     let alpha2CountryCode: String?
     let docType: OnfidoDocumentType?
     let allowedDocumentTypes: [OnfidoDocumentType]?
+    let pages: OnfidoDocumentPages?
+    let title: String?
 }
 
 struct OnfidoCaptureFace: Codable {
@@ -64,6 +66,11 @@ enum OnfidoDocumentType: String, Codable {
     case generic = "GENERIC"
 }
 
+enum OnfidoDocumentPages: String, Codable {
+    case single = "SINGLE"
+    case frontAndBack = "FRONT_AND_BACK"
+}
+
 enum OnfidoCaptureType: String, Codable {
     case photo = "PHOTO"
     case video = "VIDEO"
diff --git a/ios/OnfidoSdkTests/OnfidoSdkTests.swift b/ios/OnfidoSdkTests/OnfidoSdkTests.swift
@@ -41,7 +41,14 @@ class OnfidoSdkTests : XCTestCase {
                 sdkToken: "demo",
                 workflowRunId: nil,
                 flowSteps: .init(captureDocument: .init(
-                    .init(countryCode: nil, alpha2CountryCode: nil, docType: nil, allowedDocumentTypes: nil))
+                    .init(
+                        countryCode: nil,
+                        alpha2CountryCode: nil,
+                        docType: nil,
+                        allowedDocumentTypes: nil,
+                        pages: nil,
+                        title: nil
+                    ))
                 ),
                 localisation: nil,
                 theme: nil,
@@ -81,7 +88,9 @@ class OnfidoSdkTests : XCTestCase {
                             countryCode: "USA",
                             alpha2CountryCode: "US",
                             docType: .drivingLicence,
-                            allowedDocumentTypes: nil
+                            allowedDocumentTypes: nil,
+                            pages: nil,
+                            title: nil
                         )
                     ),
                     captureFace: .init(
@@ -134,7 +143,9 @@ class OnfidoSdkTests : XCTestCase {
                             countryCode: "USA",
                             alpha2CountryCode: "US",
                             docType: .drivingLicence,
-                            allowedDocumentTypes: nil
+                            allowedDocumentTypes: nil,
+                            pages: nil,
+                            title: nil
                         )
                     ),
                     captureFace: .init(
@@ -190,7 +201,9 @@ class OnfidoSdkTests : XCTestCase {
                             .passport,
                             .nationalIdentityCard,
                             .residencePermit
-                        ]
+                        ],
+                        pages: nil,
+                        title: nil
                     )
                 )),
                 localisation: nil,
@@ -235,7 +248,9 @@ class OnfidoSdkTests : XCTestCase {
                             .nationalIdentityCard,
                             .residencePermit,
                             .drivingLicence
-                        ]
+                        ],
+                        pages: nil,
+                        title: nil
                     )
                 )),
                 localisation: nil,
diff --git a/ios/PluginMetadata.m b/ios/PluginMetadata.m
@@ -13,7 +13,7 @@ - (instancetype)init
     self = [super init];
     if (self) {
         _pluginPlatform = @"react-native";
-        _pluginVersion = @"15.1.0";
+        _pluginVersion = @"15.2.0";
     }
     return self;
 }
diff --git a/js/Onfido.ts b/js/Onfido.ts
@@ -4,6 +4,7 @@ import {
     OnfidoCaptureType,
     OnfidoConfig,
     OnfidoCountryCode,
+    OnfidoDocumentPages,
     OnfidoDocumentType,
     OnfidoError,
     OnfidoMediaResult,
@@ -66,6 +67,16 @@ const Onfido = {
                     return configError("docType is invalid");
                 }
 
+                if (config.flowSteps.captureDocument.docType === OnfidoDocumentType.GENERIC) {
+                    if (!config.flowSteps.captureDocument.title) {
+                        return configError("title is required for GENERIC docType");
+                    }
+
+                    if (!config.flowSteps.captureDocument.pages || !(config.flowSteps.captureDocument.pages in OnfidoDocumentPages)) {
+                        return configError("pages is required and must one of OnfidoDocumentPages for GENERIC docType");
+                    }
+                }
+
 
                 if (config.flowSteps.captureDocument.countryCode) {
                     if (!(config.flowSteps.captureDocument.countryCode in OnfidoCountryCode)) {
diff --git a/js/__tests__/Onfido.spec.ts b/js/__tests__/Onfido.spec.ts
@@ -1,5 +1,5 @@
 import { Platform } from "react-native";
-import { OnfidoCountryCode, OnfidoCaptureType, OnfidoDocumentType, OnfidoConfig, OnfidoFlowSteps } from "../config_constants";
+import { OnfidoCountryCode, OnfidoCaptureType, OnfidoDocumentType, OnfidoConfig, OnfidoFlowSteps, OnfidoDocumentPages } from "../config_constants";
 import Onfido from "../Onfido";
 
 // add mock
@@ -92,6 +92,10 @@ testCases.forEach((platform) => {
         }).then(result => expect(result).toBe(RESOLVED))
     });
 
+    test('resolve with GENERIC docType, title, and supported number of pages', () => {
+      return start({ ...baseConfig, flowSteps: { ...flowSteps, captureDocument: { docType: OnfidoDocumentType.GENERIC, countryCode: OnfidoCountryCode.GBR, pages: OnfidoDocumentPages.SINGLE, title: "Test Title Doc" }}} as unknown as OnfidoConfig).then(result => expect(result).toBe(RESOLVED))
+    });
+
     // Invalid Configuration Tests
     test('reject when using allowedDocumentTypes together with docType/docCountry', () => {
       return start(
@@ -143,6 +147,18 @@ testCases.forEach((platform) => {
       return start({ ...baseConfig, flowSteps: { ...flowSteps, captureDocument: {}, captureFace: {} } } as unknown as OnfidoConfig).then(result => expect(result).toBe(REJECTED))
     });
 
+    test('reject with GENERIC docType and missing number of pages', () => {
+      return start({ ...baseConfig, flowSteps: { ...flowSteps, captureDocument: { docType: OnfidoDocumentType.GENERIC, countryCode: OnfidoCountryCode.GBR, title: "Test Title Doc" }}} as unknown as OnfidoConfig).then(result => expect(result).toBe(REJECTED))
+    });
+
+    test('reject with GENERIC docType and missing title', () => {
+      return start({ ...baseConfig, flowSteps: { ...flowSteps, captureDocument: { docType: OnfidoDocumentType.GENERIC, countryCode: OnfidoCountryCode.GBR, pages: OnfidoDocumentPages.FRONT_AND_BACK }}} as unknown as OnfidoConfig).then(result => expect(result).toBe(REJECTED))
+    });
+
+    test('reject with GENERIC docType and unsupported number of pages', () => {
+      return start({ ...baseConfig, flowSteps: { ...flowSteps, captureDocument: { docType: OnfidoDocumentType.GENERIC, countryCode: OnfidoCountryCode.GBR, pages: "MULTIPLE_PAGES", title: "Test Title Doc" }}} as unknown as OnfidoConfig).then(result => expect(result).toBe(REJECTED))
+    });
+
     test('base 64 helper function converts data array correctly to base64', () => {
       // pass nothing, see nothing
       const base64DataNothing = Onfido.byteArrayStringToBase64("")
diff --git a/js/config_constants.ts b/js/config_constants.ts
@@ -5,6 +5,8 @@ export type OnfidoFlowSteps = {
     alpha2CountryCode?: OnfidoAlpha2CountryCode;
     docType?: OnfidoDocumentType;
     allowedDocumentTypes?: OnfidoDocumentType[];
+    pages?: OnfidoDocumentPages;
+    title?: string;
   };
   captureFace?: OnfidoFaceCapture;
   proofOfAddress?: boolean;
@@ -100,6 +102,11 @@ export enum OnfidoDocumentType {
   GENERIC = "GENERIC"
 }
 
+export enum OnfidoDocumentPages {
+  SINGLE = "SINGLE",
+  FRONT_AND_BACK = "FRONT_AND_BACK"
+}
+
 export enum OnfidoCaptureType {
   PHOTO = "PHOTO",
   VIDEO = "VIDEO",
diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@onfido/react-native-sdk",
   "title": "React Native Onfido Sdk",
-  "version": "15.1.0",
+  "version": "15.2.0",
   "description": "Onfido React Native SDK",
   "main": "index.ts",
   "scripts": {

Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ - (instancetype)init`
`13`	`13`	`self = [super init];`
`14`	`14`	`if (self) {`
`15`	`15`	`_pluginPlatform = @"react-native";`
`16`		`- _pluginVersion = @"15.1.0";`
	`16`	`+ _pluginVersion = @"15.2.0";`
`17`	`17`	`}`
`18`	`18`	`return self;`
`19`	`19`	`}`