@finos_sdk/sdk-ekyc 1.4.4 → 1.4.6

package/android/build.gradle

@@ -65,7 +65,7 @@ dependencies {
     implementation 'com.facebook.react:react-android'
 
     // Finos eKYC SDK dependencies from GitHub Packages Maven repository
-    def sdkVersion = "1.4.4"
+    def sdkVersion = "1.4.6.1"
     implementation("finos.sdk.ekyc:ekyc:$sdkVersion")
     implementation("finos.sdk.ekyc:ekycui:$sdkVersion")
     implementation("finos.sdk.ekyc:nfc:$sdkVersion")

package/android/src/main/java/finos/sdk/ekyc/EKYCModule.kt

@@ -2,6 +2,7 @@ package finos.sdk.ekyc
 
 import android.R
 import android.net.Uri
+import com.google.gson.Gson
 import android.os.Handler
 import android.os.Looper
 import android.util.Base64
@@ -26,6 +27,7 @@ import finos.sdk.core.model.sdk.config.AppKeyConfig
 import finos.sdk.core.model.sdk.config.C06Config
 import finos.sdk.core.model.sdk.config.EKYCConfigSDK
 import finos.sdk.core.model.sdk.config.FaceServiceConfig
+import finos.sdk.core.model.sdk.config.LivenessBackConfirmConfig
 import finos.sdk.core.model.sdk.config.LivenessConfig
 import finos.sdk.core.model.sdk.config.NfcConfig
 import finos.sdk.core.model.sdk.config.OcrConfig
@@ -108,6 +110,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         Arguments.createMap().apply {
             putInt("status", result.status)
             putString("msg", result.msg)
+            result.errorCode?.let { putString("errorCode", it) }
             result.data?.let { d ->
                 putMap("data", Arguments.createMap().apply {
                     d.sessionId?.let { putString("sessionId", it) }
@@ -130,6 +133,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         Arguments.createMap().apply {
             putInt("status", result.status)
             putString("msg", result.msg)
+            result.errorCode?.let { putString("errorCode", it) }
             result.data?.let { d ->
                 putMap("data", Arguments.createMap().apply {
                     putString("transactionId", d.transactionId)
@@ -232,7 +236,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                             val eventMap =
                                 Arguments.createMap().apply {
                                     putString("event", event.name.toString())
-                                    putString("data", data.toString())
+                                    putString("data", Gson().toJson(data))
                                 }
                             sendEvent("onNfcScanStart", eventMap)
                         }
@@ -257,7 +261,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                             val eventMap =
                                 Arguments.createMap().apply {
                                     putString("event", event.name.toString())
-                                    putString("data", data.toString())
+                                    putString("data", Gson().toJson(data))
                                 }
                             sendEvent("onNfcEvent", eventMap)
                         }
@@ -311,18 +315,19 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 ekycConfigSDK = ekycConfig,
                 callbackSuccess = { event, data ->
                     Log.d(TAG, "✅ checkC06() success")
+                    val c06Json = Gson().toJson((data as? SDKEkycResult)?.checkC06Response)
 
                     // Create separate maps for event and promise
                     val eventMap =
                         Arguments.createMap().apply {
                             putString("event", event.name.toString())
-                            putString("data", data.toString())
+                            putString("data", c06Json)
                         }
 
                     val promiseMap =
                         Arguments.createMap().apply {
                             putString("event", event.name.toString())
-                            putString("data", data.toString())
+                            putString("data", c06Json)
                         }
                     sendEvent("onC06Success", eventMap)
                     promise.resolve(promiseMap)
@@ -386,7 +391,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     Log.d(TAG, "✅ startOcr() success")
                     val (eventMap, promiseMap) = createSeparateMaps { map ->
                         map.putString("event", event.name.toString())
-                        map.putString("data", (data as SDKEkycResult).ocrResponse.toString())
+                        map.putString("data", Gson().toJson((data as SDKEkycResult).ocrResponse))
                     }
                     sendEvent("onOcrSuccess", eventMap)
                     promise.resolve(promiseMap)
@@ -425,6 +430,8 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         activeActionCount: Int?,
         forceCaptureTimeout: Double?,
         isActiveLivenessColor: Boolean?,
+        isShowBackConfirmation: Boolean?,
+        backConfirmConfigJson: String?,
         promise: Promise
     ) {
         Log.d(TAG, "▶️ startLiveness() called")
@@ -458,6 +465,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 null
             }
 
+            val backConfirmConfig = parseBackConfirmConfig(backConfirmConfigJson)
             val livenessConfig =
                 LivenessConfig(
                     isActiveLiveness = isActiveLiveness ?: false,
@@ -472,7 +480,9 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     activeActionCount = activeActionCount ?: 2,
                     forceCaptureTimeout = (forceCaptureTimeout ?: 0.0).toLong(),
                     selfieImage = imageFile,
-                    transactionId = transactionId
+                    transactionId = transactionId,
+                    isShowBackConfirmation = isShowBackConfirmation ?: false,
+                    backConfirmConfig = backConfirmConfig,
                 )
             val ekycConfig =
                 EKYCConfigSDK(
@@ -483,10 +493,21 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
             eKYCFinOSLiveness.startEkyc(
                 ekycConfigSDK = ekycConfig,
                 callbackSuccess = { event, data ->
+                    // LOG_SUCCESS = internal submit result event (v1.4.6.1), don't resolve promise
+                    if (event == EKYCEvent.LOG_SUCCESS) {
+                        val logDataStr = data?.customData?.let { Gson().toJson(it) } ?: (data as? SDKEkycResult)?.checkLivenessResponse?.let { Gson().toJson(it) } ?: Gson().toJson(data)
+                        Log.d(TAG, "LOG_SUCCESS [Liveness]: $logDataStr")
+                        val logMap = Arguments.createMap().apply {
+                            putString("event", event.name.toString())
+                            putString("data", logDataStr)
+                        }
+                        sendEvent("onLivenessSuccess", logMap)
+                        return@startEkyc
+                    }
                     Log.d(TAG, "✅ startLiveness() success")
                     val (eventMap, promiseMap) = createSeparateMaps { map ->
                         map.putString("event", event.name.toString())
-                        map.putString("data", (data as SDKEkycResult).checkLivenessResponse.toString())
+                        map.putString("data", Gson().toJson((data as SDKEkycResult).checkLivenessResponse))
                     }
                     sendEvent("onLivenessSuccess", eventMap)
                     promise.resolve(promiseMap)
@@ -556,10 +577,37 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 eKYCFinOSFaceService.startEkyc(
                     ekycConfigSDK = ekycConfig,
                     callbackSuccess = { event, data ->
+                        // LOG_SUCCESS = internal submit result event (v1.4.6.1), don't resolve promise
+                        if (event == EKYCEvent.LOG_SUCCESS) {
+                            val faceResponse = (data as? SDKEkycResult)?.checkFaceResponse
+                            val logDataStr = data?.customData?.let { Gson().toJson(it) } ?: faceResponse?.let { Gson().toJson(it) } ?: "null"
+                            Log.d(TAG, "LOG_SUCCESS [FaceCompare]: $logDataStr")
+                            val logMap = Arguments.createMap().apply {
+                                putString("event", event.name.toString())
+                                putString("data", logDataStr)
+                            }
+                            sendEvent("onFaceCompareSuccess", logMap)
+                            return@startEkyc
+                        }
                         Log.d(TAG, "✅ startFaceCompare() success")
+                        val faceResponse = (data as? SDKEkycResult)?.checkFaceResponse
                         val (eventMap, promiseMap) = createSeparateMaps { map ->
                             map.putString("event", event.name.toString())
-                            map.putString("data", data.toString())
+                            val resultMap = Arguments.createMap().apply {
+                                putDouble("conf", faceResponse?.result?.conf?.toString()?.toDoubleOrNull() ?: 0.0)
+                                putString("match", faceResponse?.result?.match?.toString())
+                                putInt("matchScore", faceResponse?.result?.matchScore?.toString()?.toIntOrNull() ?: 0)
+                                putString("toBeReviewed", faceResponse?.result?.toBeReviewed?.toString())
+                            }
+                            val faceMap = Arguments.createMap().apply {
+                                putString("requestId", faceResponse?.requestId?.toString())
+                                putMap("result", resultMap)
+                                putString("status", faceResponse?.status?.toString())
+                                putInt("statusCode", faceResponse?.statusCode?.toString()?.toIntOrNull() ?: 0)
+                                putString("error", faceResponse?.error?.toString())
+                                putString("type", faceResponse?.type?.toString())
+                            }
+                            map.putMap("data", faceMap)
                         }
                         sendEvent("onFaceCompareSuccess", eventMap)
                         promise.resolve(promiseMap)
@@ -758,6 +806,9 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 else -> AppIDType.NONE
             }
 
+            val isShowBackConfirmation = extractBooleanValue(optionConfigJson, "isShowBackConfirmation") ?: false
+            val backConfirmConfig = parseBackConfirmConfig(extractObjectJson(optionConfigJson, "backConfirmConfig"))
+
             val livenessConfig = if (finalFlow.contains(SDKType.LIVENESS)) {
                 LivenessConfig(
                     isActiveLiveness = isActiveLiveness,
@@ -765,6 +816,8 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     isShowCameraFont = switchFrontCamera,
                     customActions = customActionsList?.takeIf { it.isNotEmpty() },
                     activeActionCount = activeActionCount,
+                    isShowBackConfirmation = isShowBackConfirmation,
+                    backConfirmConfig = backConfirmConfig,
                 )
             } else null
 
@@ -782,6 +835,17 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                 activity = currentActivity,
                 ekycConfigSDK = ekycConfigSDK,
                 callbackSuccess = { event, data ->
+                    // LOG_SUCCESS = internal submit result event (v1.4.5), emit event only, don't resolve promise
+                    if (event == EKYCEvent.LOG_SUCCESS) {
+                        val logDataStr = data?.customData?.let { Gson().toJson(it) } ?: Gson().toJson(data)
+                        Log.d(TAG, "LOG_SUCCESS [EkycUI]: $logDataStr")
+                        sendEvent("onEkycUISuccess", Arguments.createMap().apply {
+                            putString("status", "log")
+                            putString("event", event.name.toString())
+                            putString("data", logDataStr)
+                        })
+                        return@startEkyc
+                    }
                     Log.d(TAG, "✅ startEkycUI() callback - event=${event.name}")
                     val result = data as? SDKEkycResult
                     val hasRealData = result?.ekycStateModel != null
@@ -798,7 +862,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                         val (eventMap, promiseMap) = createSeparateMaps { map ->
                             map.putString("status", "success")
                             map.putString("event", event.name.toString())
-                            map.putString("data", data.toString())
+                            map.putString("data", Gson().toJson(data))
                             map.putString("transactionId", ekycTransactionId)
                             ekycFiles?.imageFace?.absolutePath?.let { map.putString("imageFacePath", it) }
                             ekycFiles?.imageOcrFront?.absolutePath?.let { map.putString("imageOcrFrontPath", it) }
@@ -859,32 +923,42 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
     private fun parseOptionConfig(optionConfigJson: String): OptionConfig {
         return try {
             if (optionConfigJson.isBlank() || optionConfigJson == "{}") {
-                // Return default values based on demo OptionConfig.kt
-                OptionConfig(
-                    baseUrl = null,
-                    countMaxRetry = 3,
-                    language = null
-                )
+                OptionConfig()
             } else {
-                // Simple JSON parsing (in real implementation, use proper JSON library)
                 val baseUrl = extractStringValue(optionConfigJson, "baseUrl")
                 val countMaxRetry = extractIntValue(optionConfigJson, "countMaxRetry") ?: 3
                 val language = extractStringValue(optionConfigJson, "language")
+                val networkTimeoutMs = extractLongValue(optionConfigJson, "networkTimeoutMs") ?: 30_000L
 
                 OptionConfig(
                     baseUrl = baseUrl,
                     countMaxRetry = countMaxRetry,
-                    language = language
+                    language = language,
+                    networkTimeoutMs = networkTimeoutMs,
                 )
             }
         } catch (e: Exception) {
             Log.e(TAG, "Error parsing optionConfig: ${e.message}", e)
-            // Return default values
-            OptionConfig(
-                baseUrl = null,
-                countMaxRetry = 3,
-                language = null
+            OptionConfig()
+        }
+    }
+
+    private fun parseBackConfirmConfig(json: String?): LivenessBackConfirmConfig? {
+        if (json.isNullOrBlank() || json == "{}") return null
+        return try {
+            LivenessBackConfirmConfig(
+                titleVi = extractStringValue(json, "titleVi"),
+                titleEn = extractStringValue(json, "titleEn"),
+                bodyVi = extractStringValue(json, "bodyVi"),
+                bodyEn = extractStringValue(json, "bodyEn"),
+                confirmButtonVi = extractStringValue(json, "confirmButtonVi"),
+                confirmButtonEn = extractStringValue(json, "confirmButtonEn"),
+                cancelButtonVi = extractStringValue(json, "cancelButtonVi"),
+                cancelButtonEn = extractStringValue(json, "cancelButtonEn"),
             )
+        } catch (e: Exception) {
+            Log.e(TAG, "Error parsing backConfirmConfig: ${e.message}", e)
+            null
         }
     }
 
@@ -898,6 +972,16 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    private fun extractLongValue(json: String, key: String): Long? {
+        return try {
+            val pattern = "\"$key\"\\s*:\\s*(-?\\d+)".toRegex()
+            val match = pattern.find(json)
+            match?.groupValues?.get(1)?.toLong()
+        } catch (e: Exception) {
+            null
+        }
+    }
+
     private fun extractBooleanValue(json: String, key: String): Boolean? {
         return try {
             val pattern = "\"$key\"\\s*:\\s*(true|false)".toRegex()
@@ -1052,6 +1136,17 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    /** Extract a nested JSON object `{ ... }` for a given key. Returns the raw JSON string or null. */
+    private fun extractObjectJson(json: String, key: String): String? {
+        return try {
+            val obj = JSONObject(json)
+            val nested = obj.optJSONObject(key) ?: return null
+            nested.toString()
+        } catch (e: Exception) {
+            null
+        }
+    }
+
     // ==================== SMS OTP Methods ====================
 
     @ReactMethod

package/dist/EKYCModule.d.ts

@@ -44,6 +44,8 @@ declare class SDKeKYC {
     onLivenessError(callback: (error: any) => void): EmitterSubscription | null;
     onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): EmitterSubscription | null;
     onFaceCompareError(callback: (error: any) => void): EmitterSubscription | null;
+    onEkycUISuccess(callback: (data: any) => void): EmitterSubscription | null;
+    onEkycUIError(callback: (error: any) => void): EmitterSubscription | null;
     removeAllListeners(): void;
     sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
     verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult>;
@@ -146,6 +148,16 @@ declare class SDKeKYC {
         baseUrl?: string;
         countMaxRetry?: number;
         language?: string;
+        networkTimeoutMs?: number;
+        switchFrontCamera?: boolean;
+        isActiveLiveness?: boolean;
+        autoCapture?: boolean;
+        forceCaptureTimeout?: number;
+        customActions?: string[];
+        activeActionCount?: number;
+        appIDType?: string;
+        isShowBackConfirmation?: boolean;
+        backConfirmConfig?: import('./src/types/ekycLivenessType').LivenessBackConfirmConfig;
     }, styleConfig?: {
         textSize?: number;
         textFont?: string;

package/dist/EKYCModule.js

@@ -213,7 +213,10 @@ class SDKeKYC {
         try {
             // Convert SDKFaceDetectStatus enum array to string array
             const customActionsStrings = (_b = (_a = config.customActions) === null || _a === void 0 ? void 0 : _a.map(action => String(action))) !== null && _b !== void 0 ? _b : undefined;
-            return await nativeModule.startLiveness(config.appKey, config.selfieImage, (_c = config.transactionId) !== null && _c !== void 0 ? _c : '', config.isActiveLiveness, config.isShowCameraFont, customActionsStrings, config.activeActionCount, config.forceCaptureTimeout, config.isActiveLivenessColor);
+            const backConfirmConfigJson = config.backConfirmConfig
+                ? JSON.stringify(config.backConfirmConfig)
+                : undefined;
+            return await nativeModule.startLiveness(config.appKey, config.selfieImage, (_c = config.transactionId) !== null && _c !== void 0 ? _c : '', config.isActiveLiveness, config.isShowCameraFont, customActionsStrings, config.activeActionCount, config.forceCaptureTimeout, config.isActiveLivenessColor, config.isShowBackConfirmation, backConfirmConfigJson);
         }
         catch (error) {
             console.error('Liveness Error:', error);
@@ -420,6 +423,38 @@ class SDKeKYC {
             return null;
         }
     }
+    onEkycUISuccess(callback) {
+        try {
+            const emitter = this.ensureEventEmitter();
+            if (!emitter) {
+                console.error('❌ Event emitter not available for onEkycUISuccess');
+                return null;
+            }
+            const listener = emitter.addListener('onEkycUISuccess', callback);
+            this.listeners.push(listener);
+            return listener;
+        }
+        catch (error) {
+            console.error('Failed to add onEkycUISuccess listener:', error);
+            return null;
+        }
+    }
+    onEkycUIError(callback) {
+        try {
+            const emitter = this.ensureEventEmitter();
+            if (!emitter) {
+                console.error('❌ Event emitter not available for onEkycUIError');
+                return null;
+            }
+            const listener = emitter.addListener('onEkycUIError', callback);
+            this.listeners.push(listener);
+            return listener;
+        }
+        catch (error) {
+            console.error('Failed to add onEkycUIError listener:', error);
+            return null;
+        }
+    }
     removeAllListeners() {
         this.listeners.forEach(listener => listener.remove());
         this.listeners = [];

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export type { OcrConfig } from './src/types/ekycOCRType';
 export type { LivenessConfig } from './src/types/ekycLivenessType';
 export { SDKFaceDetectStatus, SDK_LIVENESS_ACTIONS, customActionsToStrings } from './src/types/ekycLivenessType';
 export type { FaceServiceConfig } from './src/types/ekycFaceType';
+export { EKYCEvent, EKYCErrorEvent } from './src/types/EKYCEvent';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, StartEkycUIResult, EKYCError } from './src/types/ekycType';
 export { getEkycError, AppIDType } from './src/types/ekycType';
 export type { NfcError } from './src/types/ekycNFCType';

package/dist/index.js

@@ -33,9 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OCR_FAKE_PORTRAIT_DETECTED_CMND = exports.OCR_FAKE_CHARACTERS_DETECTED_CMND = exports.OCR_USE_NEW_ID_DOCUMENT_2 = exports.OCR_USE_NEW_ID_DOCUMENT_1 = exports.OCR_FAKE_MRZ = exports.OCR_INVALID_GENDER_CODE = exports.OCR_INVALID_ID_CARD = exports.OCR_GLARE_ID_CARD = exports.OCR_BLURRY_ID_CARD = exports.OCR_CUT_CORNER_ID_CARD = exports.OCR_CANNOT_RECOGNIZE_PORTRAIT = exports.OCR_ID_CARD_FROM_OTHER_DEVICE = exports.OCR_NOT_ORIGINAL_ID_CARD = exports.OCR_MISSING_ID_CARD_PART = exports.OCR_CANNOT_GET_ISSUE_PLACE = exports.OCR_CANNOT_GET_GENDER = exports.OCR_CANNOT_GET_HOMETOWN = exports.OCR_CANNOT_GET_RESIDENCE = exports.OCR_CANNOT_GET_ISSUE_DATE = exports.OCR_CANNOT_GET_EXPIRY_DATE = exports.OCR_CANNOT_GET_BIRTH_YEAR = exports.OCR_CANNOT_GET_NAME = exports.OCR_CANNOT_GET_ID_NUMBER = exports.OCR_WRONG_ID_CARD_SIDE = exports.OCR_UNRECOGNIZED_ID_CARD = exports.SDK_MISS_KEY = exports.ERROR_UNKNOWN = exports.SDK_START_ERROR = exports.SDK_START_FLOW_ERROR = exports.getMessage = exports.getErrorResultFromDetails = exports.createCustom = exports.fromCode = exports.getLocalizedMessage = exports.parseNfcResponse = exports.AuthorizationStatus = exports.AppIDType = exports.getEkycError = exports.customActionsToStrings = exports.SDK_LIVENESS_ACTIONS = exports.SDKFaceDetectStatus = exports.flowToStrings = exports.SDK_FLOW_OPTIONS = exports.SDKFlowType = exports.FinosESignModule = exports.FinosESign = exports.FinosEKYCModule = exports.FinosEKYC = exports.SDKeKYC = exports.sdkEKYC = void 0;
-exports.ESIGN_INVALID_RECOVERY_OR_PIN = exports.ESIGN_SESSION_INVALID_REGISTER = exports.ESIGN_INVALID_USER_ACCOUNT = exports.ESIGN_APP_LIMITED = exports.ESIGN_DEVICE_NOT_INIT = exports.ESIGN_INVALID_LICENSE_CONTENT = exports.ESIGN_INVALID_LICENSE = exports.ESIGN_DEVICE_ALREADY_INIT = exports.ESIGN_SESSION_INVALID = exports.FETCH_HISTORY_ERROR = exports.QRCODE_ERROR = exports.SMS_OTP_RATE_LIMIT = exports.SMS_OTP_NOT_FOUND = exports.SMS_OTP_MAX_ATTEMPTS = exports.SMS_OTP_INVALID_PHONE = exports.SMS_OTP_ERROR = exports.NFC_CHIP_AUTH_FAILED = exports.NFC_USER_CANCEL = exports.NFC_UNKNOWN_ERROR = exports.NFC_IO_ERROR = exports.NFC_INVALID_MRZ_KEY = exports.NFC_CONNECTION_LOST = exports.NFC_MUTUAL_AUTH_FAILED = exports.C06_ERROR = exports.SCAN_NFC_ENABLE = exports.SCAN_NFC_CHECK = exports.SCAN_NFC_ERROR = exports.HEAD_IS_TURNED_IN_SELFIE = exports.NUDITY_DETECTED_IN_SELFIE = exports.READING_GLASSES_DETECTED_IN_SELFIE = exports.EYEWEAR_DETECTED_IN_SELFIE = exports.FACE_OCCLUDED_IN_SELFIE = exports.FACE_IS_BLURRED = exports.MASK_PRESENT_IN_SELFIE = exports.EYES_CLOSED_IN_SELFIE = exports.MULTIPLE_FACES_IN_SELFIE = exports.LIVENESS_FAIL = exports.LIVENESS_ERROR = exports.FACE_ERROR = exports.FACE_HAT_ERROR = exports.OCR_ERROR = exports.OCR_FONT_BACK_NOT_MATCH = exports.OCR_PHOTOCOPY_ID_CARD = exports.OCR_FAKE_PORTRAIT_DETECTED = exports.OCR_FAKE_CHARACTERS_DETECTED_2 = exports.OCR_FAKE_CHARACTERS_DETECTED_1 = exports.OCR_UNKNOWN_ID_NUMBER_LENGTH = exports.OCR_MODIFIED_BIRTH_DATE_DETECTED_CMND = exports.OCR_MODIFIED_SYMBOL_DETECTED_CMND = exports.OCR_FAKE_BIRTH_DATE_DETECTED_CMND = void 0;
-exports.SDK_NAME = exports.SDK_VERSION = exports.USER_CANCEL = exports.ESIGN_INVALID_PIN_CODE = exports.ESIGN_INVALID_RECOVERY_CODE = exports.ESIGN_INVALID_LICENSE_CODE = exports.ESIGN_INVALID_CONTEXT = exports.ESIGN_MISSING_REQUEST_ID = exports.ESIGN_MISSING_SERIAL = exports.ESIGN_MISSING_IDENTITY = exports.ESIGN_MISSING_ACCESS_TOKEN = exports.ESIGN_NO_SESSION_ID = exports.ESIGN_MISSING_CONFIRMATION_DOC = exports.ESIGN_MISSING_REQUEST_JSON = exports.ESIGN_MISSING_CCCD = exports.ESIGN_MISSING_TOKEN = exports.ESIGN_ERROR_UNKNOWN = exports.ESIGN_AUTH_REQUEST_EXISTS = exports.ESIGN_INVALID_CERT_FOR_AUTH = exports.ESIGN_INVALID_SIGN_COUNT_OR_TIME = exports.ESIGN_AUTH_EXISTS = exports.ESIGN_SESSION_INVALID_LIST_CERT = void 0;
+exports.OCR_USE_NEW_ID_DOCUMENT_2 = exports.OCR_USE_NEW_ID_DOCUMENT_1 = exports.OCR_FAKE_MRZ = exports.OCR_INVALID_GENDER_CODE = exports.OCR_INVALID_ID_CARD = exports.OCR_GLARE_ID_CARD = exports.OCR_BLURRY_ID_CARD = exports.OCR_CUT_CORNER_ID_CARD = exports.OCR_CANNOT_RECOGNIZE_PORTRAIT = exports.OCR_ID_CARD_FROM_OTHER_DEVICE = exports.OCR_NOT_ORIGINAL_ID_CARD = exports.OCR_MISSING_ID_CARD_PART = exports.OCR_CANNOT_GET_ISSUE_PLACE = exports.OCR_CANNOT_GET_GENDER = exports.OCR_CANNOT_GET_HOMETOWN = exports.OCR_CANNOT_GET_RESIDENCE = exports.OCR_CANNOT_GET_ISSUE_DATE = exports.OCR_CANNOT_GET_EXPIRY_DATE = exports.OCR_CANNOT_GET_BIRTH_YEAR = exports.OCR_CANNOT_GET_NAME = exports.OCR_CANNOT_GET_ID_NUMBER = exports.OCR_WRONG_ID_CARD_SIDE = exports.OCR_UNRECOGNIZED_ID_CARD = exports.SDK_MISS_KEY = exports.ERROR_UNKNOWN = exports.SDK_START_ERROR = exports.SDK_START_FLOW_ERROR = exports.getMessage = exports.getErrorResultFromDetails = exports.createCustom = exports.fromCode = exports.getLocalizedMessage = exports.parseNfcResponse = exports.AuthorizationStatus = exports.AppIDType = exports.getEkycError = exports.EKYCErrorEvent = exports.EKYCEvent = exports.customActionsToStrings = exports.SDK_LIVENESS_ACTIONS = exports.SDKFaceDetectStatus = exports.flowToStrings = exports.SDK_FLOW_OPTIONS = exports.SDKFlowType = exports.FinosESignModule = exports.FinosESign = exports.FinosEKYCModule = exports.FinosEKYC = exports.SDKeKYC = exports.sdkEKYC = void 0;
+exports.ESIGN_INVALID_USER_ACCOUNT = exports.ESIGN_APP_LIMITED = exports.ESIGN_DEVICE_NOT_INIT = exports.ESIGN_INVALID_LICENSE_CONTENT = exports.ESIGN_INVALID_LICENSE = exports.ESIGN_DEVICE_ALREADY_INIT = exports.ESIGN_SESSION_INVALID = exports.FETCH_HISTORY_ERROR = exports.QRCODE_ERROR = exports.SMS_OTP_RATE_LIMIT = exports.SMS_OTP_NOT_FOUND = exports.SMS_OTP_MAX_ATTEMPTS = exports.SMS_OTP_INVALID_PHONE = exports.SMS_OTP_ERROR = exports.NFC_CHIP_AUTH_FAILED = exports.NFC_USER_CANCEL = exports.NFC_UNKNOWN_ERROR = exports.NFC_IO_ERROR = exports.NFC_INVALID_MRZ_KEY = exports.NFC_CONNECTION_LOST = exports.NFC_MUTUAL_AUTH_FAILED = exports.C06_ERROR = exports.SCAN_NFC_ENABLE = exports.SCAN_NFC_CHECK = exports.SCAN_NFC_ERROR = exports.HEAD_IS_TURNED_IN_SELFIE = exports.NUDITY_DETECTED_IN_SELFIE = exports.READING_GLASSES_DETECTED_IN_SELFIE = exports.EYEWEAR_DETECTED_IN_SELFIE = exports.FACE_OCCLUDED_IN_SELFIE = exports.FACE_IS_BLURRED = exports.MASK_PRESENT_IN_SELFIE = exports.EYES_CLOSED_IN_SELFIE = exports.MULTIPLE_FACES_IN_SELFIE = exports.LIVENESS_FAIL = exports.LIVENESS_ERROR = exports.FACE_ERROR = exports.FACE_HAT_ERROR = exports.OCR_ERROR = exports.OCR_FONT_BACK_NOT_MATCH = exports.OCR_PHOTOCOPY_ID_CARD = exports.OCR_FAKE_PORTRAIT_DETECTED = exports.OCR_FAKE_CHARACTERS_DETECTED_2 = exports.OCR_FAKE_CHARACTERS_DETECTED_1 = exports.OCR_UNKNOWN_ID_NUMBER_LENGTH = exports.OCR_MODIFIED_BIRTH_DATE_DETECTED_CMND = exports.OCR_MODIFIED_SYMBOL_DETECTED_CMND = exports.OCR_FAKE_BIRTH_DATE_DETECTED_CMND = exports.OCR_FAKE_PORTRAIT_DETECTED_CMND = exports.OCR_FAKE_CHARACTERS_DETECTED_CMND = void 0;
+exports.SDK_NAME = exports.SDK_VERSION = exports.USER_CANCEL = exports.ESIGN_INVALID_PIN_CODE = exports.ESIGN_INVALID_RECOVERY_CODE = exports.ESIGN_INVALID_LICENSE_CODE = exports.ESIGN_INVALID_CONTEXT = exports.ESIGN_MISSING_REQUEST_ID = exports.ESIGN_MISSING_SERIAL = exports.ESIGN_MISSING_IDENTITY = exports.ESIGN_MISSING_ACCESS_TOKEN = exports.ESIGN_NO_SESSION_ID = exports.ESIGN_MISSING_CONFIRMATION_DOC = exports.ESIGN_MISSING_REQUEST_JSON = exports.ESIGN_MISSING_CCCD = exports.ESIGN_MISSING_TOKEN = exports.ESIGN_ERROR_UNKNOWN = exports.ESIGN_AUTH_REQUEST_EXISTS = exports.ESIGN_INVALID_CERT_FOR_AUTH = exports.ESIGN_INVALID_SIGN_COUNT_OR_TIME = exports.ESIGN_AUTH_EXISTS = exports.ESIGN_SESSION_INVALID_LIST_CERT = exports.ESIGN_INVALID_RECOVERY_OR_PIN = exports.ESIGN_SESSION_INVALID_REGISTER = void 0;
 const EKYCModule_1 = __importStar(require("./EKYCModule"));
 exports.sdkEKYC = EKYCModule_1.default;
 Object.defineProperty(exports, "SDKeKYC", { enumerable: true, get: function () { return EKYCModule_1.SDKeKYC; } });
@@ -59,6 +59,10 @@ var ekycLivenessType_1 = require("./src/types/ekycLivenessType");
 Object.defineProperty(exports, "SDKFaceDetectStatus", { enumerable: true, get: function () { return ekycLivenessType_1.SDKFaceDetectStatus; } });
 Object.defineProperty(exports, "SDK_LIVENESS_ACTIONS", { enumerable: true, get: function () { return ekycLivenessType_1.SDK_LIVENESS_ACTIONS; } });
 Object.defineProperty(exports, "customActionsToStrings", { enumerable: true, get: function () { return ekycLivenessType_1.customActionsToStrings; } });
+// Export event enums (port of Android EKYCEvent.kt & EKYCErrorEvent.kt)
+var EKYCEvent_1 = require("./src/types/EKYCEvent");
+Object.defineProperty(exports, "EKYCEvent", { enumerable: true, get: function () { return EKYCEvent_1.EKYCEvent; } });
+Object.defineProperty(exports, "EKYCErrorEvent", { enumerable: true, get: function () { return EKYCEvent_1.EKYCErrorEvent; } });
 var ekycType_1 = require("./src/types/ekycType");
 Object.defineProperty(exports, "getEkycError", { enumerable: true, get: function () { return ekycType_1.getEkycError; } });
 Object.defineProperty(exports, "AppIDType", { enumerable: true, get: function () { return ekycType_1.AppIDType; } });

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "description": "React Native SDK for eKYC - Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06, eSign, SmsOTP residence verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/src/modules/FinosEKYCModule.d.ts

@@ -146,6 +146,14 @@ export declare class FinosEKYCModule {
     onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onFaceCompareError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for eKYC UI success events (including LOG_SUCCESS from Liveness/FaceService submit)
+     */
+    onEkycUISuccess(callback: (data: any) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for eKYC UI error events
+     */
+    onEkycUIError(callback: (error: any) => void): import("react-native").EmitterSubscription | null;
     /**
      * Remove all event listeners
      */
@@ -300,6 +308,8 @@ export declare class FinosEKYCModule {
         baseUrl?: string;
         countMaxRetry?: number;
         language?: string;
+        /** Network timeout in milliseconds (default: 30000). callTimeout = networkTimeoutMs * 2 */
+        networkTimeoutMs?: number;
         switchFrontCamera?: boolean;
         /** LivenessConfig – SDKeKYCActivity (157-169) */
         isActiveLiveness?: boolean;
@@ -310,6 +320,10 @@ export declare class FinosEKYCModule {
         activeActionCount?: number;
         /** AppIDType: NONE | HD_BANK | VIKKI (default: AppIDType.NONE) */
         appIDType?: AppIDType;
+        /** Show confirmation bottom sheet when user presses back in liveness screen (v1.4.6+) */
+        isShowBackConfirmation?: boolean;
+        /** Text config for the back confirmation bottom sheet (v1.4.6+) */
+        backConfirmConfig?: import('../types/ekycLivenessType').LivenessBackConfirmConfig;
     }, styleConfig?: {
         textSize?: number;
         textFont?: string;

package/dist/src/modules/FinosEKYCModule.js

@@ -345,6 +345,18 @@ class FinosEKYCModule {
     onFaceCompareError(callback) {
         return this.sdk.onFaceCompareError(callback);
     }
+    /**
+     * Listen for eKYC UI success events (including LOG_SUCCESS from Liveness/FaceService submit)
+     */
+    onEkycUISuccess(callback) {
+        return this.sdk.onEkycUISuccess(callback);
+    }
+    /**
+     * Listen for eKYC UI error events
+     */
+    onEkycUIError(callback) {
+        return this.sdk.onEkycUIError(callback);
+    }
     /**
      * Remove all event listeners
      */

package/dist/src/modules/FinosESignModule.d.ts

@@ -286,6 +286,8 @@ export declare class FinosESignModule {
         baseUrl?: string;
         countMaxRetry?: number;
         language?: string;
+        /** Network timeout in milliseconds (default: 30000). callTimeout = networkTimeoutMs * 2 */
+        networkTimeoutMs?: number;
         switchFrontCamera?: boolean;
     }, styleConfig?: {
         textSize?: number;

package/dist/src/types/EKYCEvent.d.ts

@@ -0,0 +1,60 @@
+/**
+ * React Native port of EkycNativeAndroid EKYCEvent.kt
+ * Enum các sự kiện SDK trả về qua callback, đồng bộ 1:1 với Android enum.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCEvent.kt
+ */
+/**
+ * EKYCEvent – tên event trả về từ native callback success.
+ * Giá trị string map chính xác với Android enum name.
+ */
+export declare enum EKYCEvent {
+    /** SDK khởi tạo thành công, activity/flow vừa mở. */
+    SDK_START_SUCCESS = "SDK_START_SUCCESS",
+    /** SDK flow hoàn thành, có data kết quả. */
+    SDK_END_SUCCESS = "SDK_END_SUCCESS",
+    /** Bắt đầu quét NFC (đang chờ thẻ). */
+    SCAN_NFC_START = "SCAN_NFC_START",
+    /** Quét NFC thành công, có dữ liệu thẻ. */
+    SCAN_NFC_SUCCESS = "SCAN_NFC_SUCCESS",
+    /** Xác minh C06 thành công. */
+    C06_SUCCESS = "C06_SUCCESS",
+    /** Liveness detection thành công. */
+    LIVENESS_SUCCESS = "LIVENESS_SUCCESS",
+    /** Face detection đang xử lý (progress). */
+    FACE_PROGRESS = "FACE_PROGRESS",
+    /** Face compare thành công. */
+    FACE_SUCCESS = "FACE_SUCCESS",
+    /** OCR xử lý thành công. */
+    OCR_SUCCESS = "OCR_SUCCESS",
+    /** QR Code quét thành công. */
+    QRCODE_SUCCESS = "QRCODE_SUCCESS",
+    /** Lấy lịch sử giao dịch thành công. */
+    FETCH_LATEST_TRANSACTION_SUCCESS = "FETCH_LATEST_TRANSACTION_SUCCESS",
+    /** Gửi SMS OTP thành công. */
+    SMS_OTP_SEND_SUCCESS = "SMS_OTP_SEND_SUCCESS",
+    /** Xác minh SMS OTP thành công. */
+    SMS_OTP_VERIFY_SUCCESS = "SMS_OTP_VERIFY_SUCCESS",
+    /** Gửi lại SMS OTP thành công. */
+    SMS_OTP_RESEND_SUCCESS = "SMS_OTP_RESEND_SUCCESS",
+    /** Kết quả NFC/Liveness/FaceService đã submit lên server thành công (v1.4.5). */
+    LOG_SUCCESS = "LOG_SUCCESS"
+}
+/**
+ * EKYCErrorEvent – tên event trả về từ native callback error.
+ * Đồng bộ với Android enum EKYCErrorEvent.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCErrorEvent.kt
+ */
+export declare enum EKYCErrorEvent {
+    SDK_START_ERROR = "SDK_START_ERROR",
+    OCR_ERROR = "OCR_ERROR",
+    LIVENESS_ERROR = "LIVENESS_ERROR",
+    FACE_ERROR = "FACE_ERROR",
+    NFC_ERROR = "NFC_ERROR",
+    C06_ERROR = "C06_ERROR",
+    SDK_DETAIL = "SDK_DETAIL",
+    SMS_OTP_ERROR = "SMS_OTP_ERROR",
+    ESIGN_ERROR = "ESIGN_ERROR",
+    USER_CANCEL = "USER_CANCEL"
+}

package/dist/src/types/EKYCEvent.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * React Native port of EkycNativeAndroid EKYCEvent.kt
+ * Enum các sự kiện SDK trả về qua callback, đồng bộ 1:1 với Android enum.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCEvent.kt
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EKYCErrorEvent = exports.EKYCEvent = void 0;
+/**
+ * EKYCEvent – tên event trả về từ native callback success.
+ * Giá trị string map chính xác với Android enum name.
+ */
+var EKYCEvent;
+(function (EKYCEvent) {
+    /** SDK khởi tạo thành công, activity/flow vừa mở. */
+    EKYCEvent["SDK_START_SUCCESS"] = "SDK_START_SUCCESS";
+    /** SDK flow hoàn thành, có data kết quả. */
+    EKYCEvent["SDK_END_SUCCESS"] = "SDK_END_SUCCESS";
+    /** Bắt đầu quét NFC (đang chờ thẻ). */
+    EKYCEvent["SCAN_NFC_START"] = "SCAN_NFC_START";
+    /** Quét NFC thành công, có dữ liệu thẻ. */
+    EKYCEvent["SCAN_NFC_SUCCESS"] = "SCAN_NFC_SUCCESS";
+    /** Xác minh C06 thành công. */
+    EKYCEvent["C06_SUCCESS"] = "C06_SUCCESS";
+    /** Liveness detection thành công. */
+    EKYCEvent["LIVENESS_SUCCESS"] = "LIVENESS_SUCCESS";
+    /** Face detection đang xử lý (progress). */
+    EKYCEvent["FACE_PROGRESS"] = "FACE_PROGRESS";
+    /** Face compare thành công. */
+    EKYCEvent["FACE_SUCCESS"] = "FACE_SUCCESS";
+    /** OCR xử lý thành công. */
+    EKYCEvent["OCR_SUCCESS"] = "OCR_SUCCESS";
+    /** QR Code quét thành công. */
+    EKYCEvent["QRCODE_SUCCESS"] = "QRCODE_SUCCESS";
+    /** Lấy lịch sử giao dịch thành công. */
+    EKYCEvent["FETCH_LATEST_TRANSACTION_SUCCESS"] = "FETCH_LATEST_TRANSACTION_SUCCESS";
+    /** Gửi SMS OTP thành công. */
+    EKYCEvent["SMS_OTP_SEND_SUCCESS"] = "SMS_OTP_SEND_SUCCESS";
+    /** Xác minh SMS OTP thành công. */
+    EKYCEvent["SMS_OTP_VERIFY_SUCCESS"] = "SMS_OTP_VERIFY_SUCCESS";
+    /** Gửi lại SMS OTP thành công. */
+    EKYCEvent["SMS_OTP_RESEND_SUCCESS"] = "SMS_OTP_RESEND_SUCCESS";
+    /** Kết quả NFC/Liveness/FaceService đã submit lên server thành công (v1.4.5). */
+    EKYCEvent["LOG_SUCCESS"] = "LOG_SUCCESS";
+})(EKYCEvent || (exports.EKYCEvent = EKYCEvent = {}));
+/**
+ * EKYCErrorEvent – tên event trả về từ native callback error.
+ * Đồng bộ với Android enum EKYCErrorEvent.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCErrorEvent.kt
+ */
+var EKYCErrorEvent;
+(function (EKYCErrorEvent) {
+    EKYCErrorEvent["SDK_START_ERROR"] = "SDK_START_ERROR";
+    EKYCErrorEvent["OCR_ERROR"] = "OCR_ERROR";
+    EKYCErrorEvent["LIVENESS_ERROR"] = "LIVENESS_ERROR";
+    EKYCErrorEvent["FACE_ERROR"] = "FACE_ERROR";
+    EKYCErrorEvent["NFC_ERROR"] = "NFC_ERROR";
+    EKYCErrorEvent["C06_ERROR"] = "C06_ERROR";
+    EKYCErrorEvent["SDK_DETAIL"] = "SDK_DETAIL";
+    EKYCErrorEvent["SMS_OTP_ERROR"] = "SMS_OTP_ERROR";
+    EKYCErrorEvent["ESIGN_ERROR"] = "ESIGN_ERROR";
+    EKYCErrorEvent["USER_CANCEL"] = "USER_CANCEL";
+})(EKYCErrorEvent || (exports.EKYCErrorEvent = EKYCErrorEvent = {}));

package/dist/src/types/ekycESignType.d.ts

@@ -56,6 +56,7 @@ export interface ESignSignRequestConfirm {
 export interface ESignApiResponse {
     status: number;
     msg: string;
+    errorCode?: string;
     data?: {
         sessionId?: string;
         [key: string]: any;
@@ -69,6 +70,7 @@ export interface ESignApiResponse {
 export interface ESignPdfResult {
     status: number;
     msg: string;
+    errorCode?: string;
     data?: {
         transactionId: string;
         [key: string]: any;

package/dist/src/types/ekycLivenessType.d.ts

@@ -20,6 +20,17 @@ export declare enum SDKFaceDetectStatus {
 export declare const SDK_LIVENESS_ACTIONS: readonly SDKFaceDetectStatus[];
 /** Chuyển customActions enum[] sang string[] khi gửi xuống native. */
 export declare function customActionsToStrings(actions: SDKFaceDetectStatus[]): string[];
+/** Text config for the back-press confirmation bottom sheet (v1.4.6+). All fields optional – fallback to built-in strings. */
+export interface LivenessBackConfirmConfig {
+    titleVi?: string;
+    titleEn?: string;
+    bodyVi?: string;
+    bodyEn?: string;
+    confirmButtonVi?: string;
+    confirmButtonEn?: string;
+    cancelButtonVi?: string;
+    cancelButtonEn?: string;
+}
 export interface LivenessConfig {
     appKey: string;
     transactionId?: string;
@@ -30,6 +41,8 @@ export interface LivenessConfig {
     customActions?: SDKFaceDetectStatus[];
     activeActionCount?: number;
     forceCaptureTimeout?: number;
+    isShowBackConfirmation?: boolean;
+    backConfirmConfig?: LivenessBackConfirmConfig;
 }
 export interface CheckLivenessResponse {
     metadata?: Metadata;

package/ios/EKYCModule.swift

@@ -96,14 +96,14 @@ class EKYCModule: RCTEventEmitter {
         callbackSuccess: { event, data in
           switch event {
           case .SCAN_NFC_START:
-            self?.emit("onNfcScanStart", body: ["event": event.description, "data": "\(String(describing: data))"])
+            self?.emit("onNfcScanStart", body: ["event": event.description, "data": (data as? SDKEkycResult)?.nfcResponse ?? "{}"])
           case .SCAN_NFC_SUCCESS:
             let nfcResponse = (data as? SDKEkycResult)?.nfcResponse ?? ""
             let body: [String: Any] = ["event": event.description, "data": nfcResponse]
             self?.emit("onNfcScanSuccess", body: body)
             resolve(body)
           default:
-            self?.emit("onNfcEvent", body: ["event": event.description, "data": "\(String(describing: data))"])
+            self?.emit("onNfcEvent", body: ["event": event.description, "data": (data as? SDKEkycResult)?.nfcResponse ?? "{}"])
           }
         },
         callbackError: { event, errorResult in
@@ -123,7 +123,8 @@ class EKYCModule: RCTEventEmitter {
     let ekycConfig = EKYCConfigSDK(appKey: AppKeyConfig(appKey: appKey), c06Config: c06Config)
     SdkEkycC06.startEkyc(ekycConfigSDK: ekycConfig,
       callbackSuccess: { [weak self] event, data in
-        let body: [String: Any] = ["event": event.description, "data": "\(String(describing: data))"]
+        let c06Response = (data as? SDKEkycResult)?.checkC06Response?.description ?? "{}"
+        let body: [String: Any] = ["event": event.description, "data": c06Response]
         self?.emit("onC06Success", body: body)
         resolve(body)
       },
@@ -210,7 +211,17 @@ class EKYCModule: RCTEventEmitter {
     DispatchQueue.main.async { [weak self] in
       SdkEkycFaceService.startEkyc(ekycConfigSDK: ekycConfig,
         callbackSuccess: { event, data in
-          let body: [String: Any] = ["event": event.description, "data": "\(String(describing: data))"]
+          let faceResponse = (data as? SDKEkycResult)?.checkFaceResponse
+          var faceDict: [String: Any] = [:]
+          if let v = faceResponse?.requestId { faceDict["requestId"] = v }
+          if let r = faceResponse?.result {
+            faceDict["result"] = ["conf": r.conf, "match": r.match, "matchScore": r.matchScore, "toBeReviewed": r.toBeReviewed]
+          }
+          if let v = faceResponse?.status { faceDict["status"] = v }
+          if let v = faceResponse?.statusCode { faceDict["statusCode"] = v }
+          if let v = faceResponse?.error { faceDict["error"] = v }
+          if let v = faceResponse?.type { faceDict["type"] = v }
+          let body: [String: Any] = ["event": event.description, "data": faceDict]
           self?.emit("onFaceCompareSuccess", body: body)
           resolve(body)
         },
@@ -291,7 +302,16 @@ class EKYCModule: RCTEventEmitter {
             return
           }
           let files = result?.ekycStateModel?.eKYCFileModel
-          var body: [String: Any] = ["status": "success", "event": event.description, "data": "\(String(describing: data))", "transactionId": result?.ekycStateModel?.transactionId ?? ""]
+          var dataDict: [String: Any] = [:]
+          if let v = result?.nfcResponse { dataDict["nfcResponse"] = v }
+          if let v = result?.checkC06Response?.description { dataDict["checkC06Response"] = v }
+          if let v = result?.ocrResponse?.description { dataDict["ocrResponse"] = v }
+          if let v = result?.checkLivenessResponse?.description { dataDict["checkLivenessResponse"] = v }
+          if let v = result?.checkFaceResponse?.description { dataDict["checkFaceResponse"] = v }
+          if let v = result?.customData { dataDict["customData"] = v }
+          let dataJson = (try? JSONSerialization.data(withJSONObject: dataDict))
+            .flatMap { String(data: $0, encoding: .utf8) } ?? "{}"
+          var body: [String: Any] = ["status": "success", "event": event.description, "data": dataJson, "transactionId": result?.ekycStateModel?.transactionId ?? ""]
           if let facePath = files?.imageFace { body["imageFacePath"] = facePath.path }
           if let frontPath = files?.imageOcrFront { body["imageOcrFrontPath"] = frontPath.path }
           if let backPath = files?.imageOcrBack { body["imageOcrBackPath"] = backPath.path }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.4",
+  "version": "1.4.6",
   "description": "React Native SDK for eKYC - Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06, eSign, SmsOTP residence verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/modules/FinosEKYCModule.ts

@@ -361,6 +361,20 @@ export class FinosEKYCModule {
         return this.sdk.onFaceCompareError(callback);
     }
 
+    /**
+     * Listen for eKYC UI success events (including LOG_SUCCESS from Liveness/FaceService submit)
+     */
+    public onEkycUISuccess(callback: (data: any) => void) {
+        return this.sdk.onEkycUISuccess(callback);
+    }
+
+    /**
+     * Listen for eKYC UI error events
+     */
+    public onEkycUIError(callback: (error: any) => void) {
+        return this.sdk.onEkycUIError(callback);
+    }
+
     /**
      * Remove all event listeners
      */
@@ -750,6 +764,8 @@ export class FinosEKYCModule {
             baseUrl?: string;
             countMaxRetry?: number;
             language?: string;
+            /** Network timeout in milliseconds (default: 30000). callTimeout = networkTimeoutMs * 2 */
+            networkTimeoutMs?: number;
             switchFrontCamera?: boolean;
             /** LivenessConfig – SDKeKYCActivity (157-169) */
             isActiveLiveness?: boolean;
@@ -760,6 +776,10 @@ export class FinosEKYCModule {
             activeActionCount?: number;
             /** AppIDType: NONE | HD_BANK | VIKKI (default: AppIDType.NONE) */
             appIDType?: AppIDType;
+            /** Show confirmation bottom sheet when user presses back in liveness screen (v1.4.6+) */
+            isShowBackConfirmation?: boolean;
+            /** Text config for the back confirmation bottom sheet (v1.4.6+) */
+            backConfirmConfig?: import('../types/ekycLivenessType').LivenessBackConfirmConfig;
         },
         styleConfig?: {
             textSize?: number;

package/src/modules/FinosESignModule.ts

@@ -634,6 +634,8 @@ export class FinosESignModule {
             baseUrl?: string;
             countMaxRetry?: number;
             language?: string;
+            /** Network timeout in milliseconds (default: 30000). callTimeout = networkTimeoutMs * 2 */
+            networkTimeoutMs?: number;
             switchFrontCamera?: boolean;
         },
         styleConfig?: {

package/src/types/EKYCEvent.ts

@@ -0,0 +1,76 @@
+/**
+ * React Native port of EkycNativeAndroid EKYCEvent.kt
+ * Enum các sự kiện SDK trả về qua callback, đồng bộ 1:1 với Android enum.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCEvent.kt
+ */
+
+/**
+ * EKYCEvent – tên event trả về từ native callback success.
+ * Giá trị string map chính xác với Android enum name.
+ */
+export enum EKYCEvent {
+  /** SDK khởi tạo thành công, activity/flow vừa mở. */
+  SDK_START_SUCCESS = 'SDK_START_SUCCESS',
+
+  /** SDK flow hoàn thành, có data kết quả. */
+  SDK_END_SUCCESS = 'SDK_END_SUCCESS',
+
+  /** Bắt đầu quét NFC (đang chờ thẻ). */
+  SCAN_NFC_START = 'SCAN_NFC_START',
+
+  /** Quét NFC thành công, có dữ liệu thẻ. */
+  SCAN_NFC_SUCCESS = 'SCAN_NFC_SUCCESS',
+
+  /** Xác minh C06 thành công. */
+  C06_SUCCESS = 'C06_SUCCESS',
+
+  /** Liveness detection thành công. */
+  LIVENESS_SUCCESS = 'LIVENESS_SUCCESS',
+
+  /** Face detection đang xử lý (progress). */
+  FACE_PROGRESS = 'FACE_PROGRESS',
+
+  /** Face compare thành công. */
+  FACE_SUCCESS = 'FACE_SUCCESS',
+
+  /** OCR xử lý thành công. */
+  OCR_SUCCESS = 'OCR_SUCCESS',
+
+  /** QR Code quét thành công. */
+  QRCODE_SUCCESS = 'QRCODE_SUCCESS',
+
+  /** Lấy lịch sử giao dịch thành công. */
+  FETCH_LATEST_TRANSACTION_SUCCESS = 'FETCH_LATEST_TRANSACTION_SUCCESS',
+
+  /** Gửi SMS OTP thành công. */
+  SMS_OTP_SEND_SUCCESS = 'SMS_OTP_SEND_SUCCESS',
+
+  /** Xác minh SMS OTP thành công. */
+  SMS_OTP_VERIFY_SUCCESS = 'SMS_OTP_VERIFY_SUCCESS',
+
+  /** Gửi lại SMS OTP thành công. */
+  SMS_OTP_RESEND_SUCCESS = 'SMS_OTP_RESEND_SUCCESS',
+
+  /** Kết quả NFC/Liveness/FaceService đã submit lên server thành công (v1.4.5). */
+  LOG_SUCCESS = 'LOG_SUCCESS',
+}
+
+/**
+ * EKYCErrorEvent – tên event trả về từ native callback error.
+ * Đồng bộ với Android enum EKYCErrorEvent.
+ *
+ * @see EkycNativeAndroid/Module/SDKCore/src/main/java/finos/sdk/core/define/EKYCErrorEvent.kt
+ */
+export enum EKYCErrorEvent {
+  SDK_START_ERROR = 'SDK_START_ERROR',
+  OCR_ERROR = 'OCR_ERROR',
+  LIVENESS_ERROR = 'LIVENESS_ERROR',
+  FACE_ERROR = 'FACE_ERROR',
+  NFC_ERROR = 'NFC_ERROR',
+  C06_ERROR = 'C06_ERROR',
+  SDK_DETAIL = 'SDK_DETAIL',
+  SMS_OTP_ERROR = 'SMS_OTP_ERROR',
+  ESIGN_ERROR = 'ESIGN_ERROR',
+  USER_CANCEL = 'USER_CANCEL',
+}

package/src/types/ekycESignType.ts

@@ -64,6 +64,7 @@ export interface ESignSignRequestConfirm {
 export interface ESignApiResponse {
   status: number;
   msg: string;
+  errorCode?: string;
   data?: {
     sessionId?: string;
     [key: string]: any;
@@ -78,6 +79,7 @@ export interface ESignApiResponse {
 export interface ESignPdfResult {
   status: number;
   msg: string;
+  errorCode?: string;
   data?: {
     transactionId: string;
     [key: string]: any; // Cho phép các field động khác

package/src/types/ekycLivenessType.ts

@@ -38,11 +38,23 @@ export function customActionsToStrings(actions: SDKFaceDetectStatus[]): string[]
     return actions.map(a => a as string);
 }
 
+/** Text config for the back-press confirmation bottom sheet (v1.4.6+). All fields optional – fallback to built-in strings. */
+export interface LivenessBackConfirmConfig {
+    titleVi?: string;
+    titleEn?: string;
+    bodyVi?: string;
+    bodyEn?: string;
+    confirmButtonVi?: string;
+    confirmButtonEn?: string;
+    cancelButtonVi?: string;
+    cancelButtonEn?: string;
+}
+
 export interface LivenessConfig {
     appKey: string;
     transactionId?: string;
     // old fields usingRandomAction and isStraight removed in 1.3.1
-    // usingRandomAction: boolean; 
+    // usingRandomAction: boolean;
     // isStraight: boolean;
     selfieImage: string;
     // New fields for version 1.3.0
@@ -52,6 +64,9 @@ export interface LivenessConfig {
     customActions?: SDKFaceDetectStatus[];
     activeActionCount?: number;
     forceCaptureTimeout?: number;
+    // New fields for version 1.4.6
+    isShowBackConfirmation?: boolean;
+    backConfirmConfig?: LivenessBackConfirmConfig;
 }
 
 export interface CheckLivenessResponse {