@finos_sdk/sdk-ekyc 1.3.9 → 1.3.10

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

@@ -1848,12 +1848,49 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     Log.d(TAG, "✅ signPdfMultiplePositions() callbackSuccess - rawResponse: $rawResponse")
                     Log.d(TAG, "   📦 Response length: ${rawResponse.length}")
                     
-                    // Bắn raw data lên - để EKYCModule.ts xử lý
-                    val (eventMap, promiseMap) = createSeparateMaps { map ->
-                        map.putString("response", rawResponse)
+                    // Parse JSON response và trả về object thay vì string
+                    try {
+                        val jsonObject = org.json.JSONObject(rawResponse)
+                        val promiseMap = Arguments.createMap().apply {
+                            putInt("status", jsonObject.optInt("status", 0))
+                            putString("msg", jsonObject.optString("msg", ""))
+                            
+                            // Parse data object nếu có
+                            if (jsonObject.has("data") && !jsonObject.isNull("data")) {
+                                val dataJson = jsonObject.getJSONObject("data")
+                                val dataMap = Arguments.createMap().apply {
+                                    putString("transactionId", dataJson.optString("transactionId", ""))
+                                    val keys = dataJson.keys()
+                                    while (keys.hasNext()) {
+                                        val key = keys.next()
+                                        if (key != "transactionId") {
+                                            when (val value = dataJson.get(key)) {
+                                                is String -> putString(key, value)
+                                                is Int -> putInt(key, value)
+                                                is Boolean -> putBoolean(key, value)
+                                                is Double -> putDouble(key, value)
+                                                else -> putString(key, value.toString())
+                                            }
+                                        }
+                                    }
+                                }
+                                putMap("data", dataMap)
+                            }
+                        }
+                        
+                        val eventMap = Arguments.createMap().apply {
+                            putString("response", rawResponse)
+                        }
+                        sendEvent("onESignSignPdfMultiplePositionsSuccess", eventMap)
+                        promise.resolve(promiseMap)
+                    } catch (e: Exception) {
+                        Log.e(TAG, "❌ signPdfMultiplePositions() JSON parse error: ${e.message}")
+                        val (eventMap, promiseMap) = createSeparateMaps { map ->
+                            map.putString("response", rawResponse)
+                        }
+                        sendEvent("onESignSignPdfMultiplePositionsSuccess", eventMap)
+                        promise.resolve(promiseMap)
                     }
-                    sendEvent("onESignSignPdfMultiplePositionsSuccess", eventMap)
-                    promise.resolve(promiseMap)
                 },
                 callbackError = { event, error ->
                     val errorMessage = error.message ?: ""
@@ -1862,27 +1899,59 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     Log.d(TAG, "🔍 signPdfMultiplePositions() callbackError - Code: $errorCode, Message: $errorMessage")
 
                     // Check if message contains "thành công" or code == "0" -> treat as success
-                    // NOTE: error.message có thể chứa full JSON response trong một số trường hợp
                     if (errorMessage.contains("thành công", ignoreCase = true) || errorCode == "0") {
                         Log.d(TAG, "✅ signPdfMultiplePositions() success (via error callback) - Message: $errorMessage")
                         
-                        // Kiểm tra xem errorMessage có phải là JSON response đầy đủ không
                         val responseJson = if (errorMessage.trim().startsWith("{") && errorMessage.contains("\"data\"")) {
-                            // errorMessage chứa full JSON response
                             Log.d(TAG, "   📦 Using full JSON from errorMessage")
                             errorMessage
                         } else {
-                            // Tạo synthetic response (fallback)
                             Log.d(TAG, "   ⚠️ Creating synthetic response (no data available)")
                             "{\"status\":0,\"msg\":\"$errorMessage\"}"
                         }
                         
-                        val (eventMap, promiseMap) = createSeparateMaps { map ->
-                            map.putString("response", responseJson)
-                            map.putString("message", errorMessage)
+                        // Parse JSON và trả về object
+                        try {
+                            val jsonObject = org.json.JSONObject(responseJson)
+                            val promiseMap = Arguments.createMap().apply {
+                                putInt("status", jsonObject.optInt("status", 0))
+                                putString("msg", jsonObject.optString("msg", ""))
+                                
+                                if (jsonObject.has("data") && !jsonObject.isNull("data")) {
+                                    val dataJson = jsonObject.getJSONObject("data")
+                                    val dataMap = Arguments.createMap().apply {
+                                        putString("transactionId", dataJson.optString("transactionId", ""))
+                                        val keys = dataJson.keys()
+                                        while (keys.hasNext()) {
+                                            val key = keys.next()
+                                            if (key != "transactionId") {
+                                                when (val value = dataJson.get(key)) {
+                                                    is String -> putString(key, value)
+                                                    is Int -> putInt(key, value)
+                                                    is Boolean -> putBoolean(key, value)
+                                                    is Double -> putDouble(key, value)
+                                                    else -> putString(key, value.toString())
+                                                }
+                                            }
+                                        }
+                                    }
+                                    putMap("data", dataMap)
+                                }
+                            }
+                            
+                            val eventMap = Arguments.createMap().apply {
+                                putString("response", responseJson)
+                            }
+                            sendEvent("onESignSignPdfMultiplePositionsSuccess", eventMap)
+                            promise.resolve(promiseMap)
+                        } catch (e: Exception) {
+                            val (eventMap, promiseMap) = createSeparateMaps { map ->
+                                map.putString("response", responseJson)
+                                map.putString("message", errorMessage)
+                            }
+                            sendEvent("onESignSignPdfMultiplePositionsSuccess", eventMap)
+                            promise.resolve(promiseMap)
                         }
-                        sendEvent("onESignSignPdfMultiplePositionsSuccess", eventMap)
-                        promise.resolve(promiseMap)
                     } else {
                         Log.e(TAG, "❌ signPdfMultiplePositions() failed - Event: $event, Code: $errorCode, Message: $errorMessage")
                         val errorMap = Arguments.createMap().apply {
@@ -2006,12 +2075,52 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     Log.d(TAG, "✅ signPdf() callbackSuccess - rawResponse: $rawResponse")
                     Log.d(TAG, "   📦 Response length: ${rawResponse.length}")
                     
-                    // Bắn raw data lên - để EKYCModule.ts xử lý
-                    val (eventMap, promiseMap) = createSeparateMaps { map ->
-                        map.putString("response", rawResponse)
+                    // Parse JSON response và trả về object thay vì string
+                    try {
+                        val jsonObject = org.json.JSONObject(rawResponse)
+                        val promiseMap = Arguments.createMap().apply {
+                            putInt("status", jsonObject.optInt("status", 0))
+                            putString("msg", jsonObject.optString("msg", ""))
+                            
+                            // Parse data object nếu có
+                            if (jsonObject.has("data") && !jsonObject.isNull("data")) {
+                                val dataJson = jsonObject.getJSONObject("data")
+                                val dataMap = Arguments.createMap().apply {
+                                    putString("transactionId", dataJson.optString("transactionId", ""))
+                                    // Thêm các field khác nếu có
+                                    val keys = dataJson.keys()
+                                    while (keys.hasNext()) {
+                                        val key = keys.next()
+                                        if (key != "transactionId") {
+                                            when (val value = dataJson.get(key)) {
+                                                is String -> putString(key, value)
+                                                is Int -> putInt(key, value)
+                                                is Boolean -> putBoolean(key, value)
+                                                is Double -> putDouble(key, value)
+                                                else -> putString(key, value.toString())
+                                            }
+                                        }
+                                    }
+                                }
+                                putMap("data", dataMap)
+                            }
+                        }
+                        
+                        // Event vẫn gửi raw response để backward compatible
+                        val eventMap = Arguments.createMap().apply {
+                            putString("response", rawResponse)
+                        }
+                        sendEvent("onESignSignPdfSuccess", eventMap)
+                        promise.resolve(promiseMap)
+                    } catch (e: Exception) {
+                        Log.e(TAG, "❌ signPdf() JSON parse error: ${e.message}")
+                        // Fallback: trả về raw response nếu không parse được
+                        val (eventMap, promiseMap) = createSeparateMaps { map ->
+                            map.putString("response", rawResponse)
+                        }
+                        sendEvent("onESignSignPdfSuccess", eventMap)
+                        promise.resolve(promiseMap)
                     }
-                    sendEvent("onESignSignPdfSuccess", eventMap)
-                    promise.resolve(promiseMap)
                 },
                 callbackError = { event, error ->
                     val errorMessage = error.message ?: ""
@@ -2020,27 +2129,60 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     Log.d(TAG, "🔍 signPdf() callbackError - Code: $errorCode, Message: $errorMessage")
                     
                     // Check if message contains "thành công" or code == "0" -> treat as success
-                    // NOTE: error.message có thể chứa full JSON response trong một số trường hợp
                     if (errorMessage.contains("thành công", ignoreCase = true) || errorCode == "0") {
                         Log.d(TAG, "✅ signPdf() success (via error callback) - Message: $errorMessage")
                         
                         // Kiểm tra xem errorMessage có phải là JSON response đầy đủ không
                         val responseJson = if (errorMessage.trim().startsWith("{") && errorMessage.contains("\"data\"")) {
-                            // errorMessage chứa full JSON response
                             Log.d(TAG, "   📦 Using full JSON from errorMessage")
                             errorMessage
                         } else {
-                            // Tạo synthetic response (fallback)
                             Log.d(TAG, "   ⚠️ Creating synthetic response (no data available)")
                             "{\"status\":0,\"msg\":\"$errorMessage\"}"
                         }
                         
-                        val (eventMap, promiseMap) = createSeparateMaps { map ->
-                            map.putString("response", responseJson)
-                            map.putString("message", errorMessage)
+                        // Parse JSON và trả về object
+                        try {
+                            val jsonObject = org.json.JSONObject(responseJson)
+                            val promiseMap = Arguments.createMap().apply {
+                                putInt("status", jsonObject.optInt("status", 0))
+                                putString("msg", jsonObject.optString("msg", ""))
+                                
+                                if (jsonObject.has("data") && !jsonObject.isNull("data")) {
+                                    val dataJson = jsonObject.getJSONObject("data")
+                                    val dataMap = Arguments.createMap().apply {
+                                        putString("transactionId", dataJson.optString("transactionId", ""))
+                                        val keys = dataJson.keys()
+                                        while (keys.hasNext()) {
+                                            val key = keys.next()
+                                            if (key != "transactionId") {
+                                                when (val value = dataJson.get(key)) {
+                                                    is String -> putString(key, value)
+                                                    is Int -> putInt(key, value)
+                                                    is Boolean -> putBoolean(key, value)
+                                                    is Double -> putDouble(key, value)
+                                                    else -> putString(key, value.toString())
+                                                }
+                                            }
+                                        }
+                                    }
+                                    putMap("data", dataMap)
+                                }
+                            }
+                            
+                            val eventMap = Arguments.createMap().apply {
+                                putString("response", responseJson)
+                            }
+                            sendEvent("onESignSignPdfSuccess", eventMap)
+                            promise.resolve(promiseMap)
+                        } catch (e: Exception) {
+                            val (eventMap, promiseMap) = createSeparateMaps { map ->
+                                map.putString("response", responseJson)
+                                map.putString("message", errorMessage)
+                            }
+                            sendEvent("onESignSignPdfSuccess", eventMap)
+                            promise.resolve(promiseMap)
                         }
-                        sendEvent("onESignSignPdfSuccess", eventMap)
-                        promise.resolve(promiseMap)
                     } else {
                         Log.e(TAG, "❌ signPdf() failed - Event: $event, Code: $errorCode, Message: $errorMessage")
                         val errorMap = Arguments.createMap().apply {

package/dist/EKYCModule.d.ts

@@ -6,7 +6,7 @@ import { OcrConfig } from './src/types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus } from './src/types/ekycLivenessType';
 import { FaceServiceConfig } from './src/types/ekycFaceType';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from './src/types/ekycSmsOtpType';
-import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, AuthorizeInfo } from './src/types/ekycESignType';
+import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, AuthorizeInfo, ESignPdfResult } from './src/types/ekycESignType';
 export declare const SDK_VERSION: string;
 export declare const SDK_NAME: string;
 declare class SDKeKYC {
@@ -76,9 +76,7 @@ declare class SDKeKYC {
     registerRemoteSigning(requestJson: string): Promise<{
         response: string;
     }>;
-    signPdf(requestJson: string): Promise<{
-        response: string;
-    }>;
+    signPdf(requestJson: string): Promise<ESignPdfResult>;
     sendConfirmationDocument(requestJson: string): Promise<{
         response: string;
     }>;
@@ -92,7 +90,7 @@ declare class SDKeKYC {
     initAuthorize(serial: string, quantity: number, time: number, message: string): Promise<any>;
     listAuthorize(pageNumber: number, pageSize: number, status: string): Promise<any>;
     registerAuthorize(authId: string, authData: string, authorizeRequestId: string, userPin: string, confirm: boolean): Promise<any>;
-    signPdfMultiplePositions(requestJson: string): Promise<any>;
+    signPdfMultiplePositions(requestJson: string): Promise<ESignPdfResult>;
     onESignInitAuthorizeSuccess(callback: (data: {
         code: string;
         message: string;

package/dist/EKYCModule.js

@@ -665,25 +665,11 @@ class SDKeKYC {
             console.log('📄 signPdf called with requestJson length:', (requestJson === null || requestJson === void 0 ? void 0 : requestJson.length) || 0);
             const result = await nativeModule.signPdf(requestJson);
             console.log('📄 signPdf result:', JSON.stringify(result));
-            // Validate response format
+            // Native module now returns parsed JSON object with status, msg, data
             if (!result) {
                 console.warn('⚠️ signPdf: result is null/undefined');
                 throw new Error('signPdf returned null/undefined result');
             }
-            // Ensure response field exists
-            if (!result.response) {
-                console.warn('⚠️ signPdf: result.response is missing:', result);
-                // Try to create a valid response from what we have
-                // Check if result itself is a string
-                if (typeof result === 'string') {
-                    return { response: result };
-                }
-                // Check if result has message field
-                if (result.message) {
-                    return { response: result.message };
-                }
-                throw new Error('signPdf result missing response field');
-            }
             return result;
         }
         catch (error) {

package/dist/index.d.ts

@@ -20,7 +20,7 @@ export type { LivenessError } from './src/types/ekycLivenessType';
 export type { FaceCompareError } from './src/types/ekycFaceType';
 export type { SDKTransactionResponse } from './src/types/ekycTransactionType';
 export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from './src/types/ekycSmsOtpType';
-export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, UserEsignModel, AuthorizeInfo, } from './src/types/ekycESignType';
+export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, UserEsignModel, AuthorizeInfo, ESignPdfResult, } from './src/types/ekycESignType';
 export { AuthorizationStatus } from './src/types/ekycESignType';
 export { parseNfcResponse } from './src/utils/utils';
 export type { EKYCErrorResultLanguage, EKYCErrorResultLike } from './src/types/EKYCErrorResult';

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "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",
@@ -44,6 +44,7 @@
   "scripts": {
     "clear": "cd android && if [ -d \"../node_modules\" ]; then ./gradlew clean; else rm -rf build app/build; fi && cd .. && rm -rf node_modules && npm cache clean --force",
     "npm-install": "npm install",
+    "npm-install-legacy": "npm install --legacy-peer-deps",
     "build": "tsc && mkdir -p dist && cp package.json dist/",
     "publish-sdk-local": "npm run build && npm pack",
     "publish-sdk": "npm run build && npm publish --access public",

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

@@ -6,7 +6,7 @@ import { OcrConfig } from '../types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus } from '../types/ekycLivenessType';
 import { FaceServiceConfig } from '../types/ekycFaceType';
 import { SmsOtpConfig, SmsOtpResult } from '../types/ekycSmsOtpType';
-import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest } from '../types/ekycESignType';
+import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignPdfResult } from '../types/ekycESignType';
 import { SDKFlowType } from '../types/ekycFlowType';
 /**
  * Finos eKYC SDK Module
@@ -241,10 +241,9 @@ export declare class FinosEKYCModule {
      * Sign PDF document
      * @param accessToken JWT access token
      * @param requestJson JSON request body
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
-    signPdf(requestJson: string): Promise<{
-        response: string;
-    }>;
+    signPdf(requestJson: string): Promise<ESignPdfResult>;
     /**
      * Send confirmation document
      * @param accessToken JWT access token

package/dist/src/modules/FinosEKYCModule.js

@@ -566,6 +566,7 @@ class FinosEKYCModule {
      * Sign PDF document
      * @param accessToken JWT access token
      * @param requestJson JSON request body
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
     async signPdf(requestJson) {
         this.validateSDKReady();

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

@@ -1,6 +1,6 @@
 import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { SmsOtpConfig, SmsOtpResult } from '../types/ekycSmsOtpType';
-import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, AuthorizeInfo } from '../types/ekycESignType';
+import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, AuthorizeInfo, ESignPdfResult } from '../types/ekycESignType';
 import { LivenessConfig } from '../types/ekycLivenessType';
 import { FaceServiceConfig } from '../types/ekycFaceType';
 import { SDKEkycResultStringWithEvent, SDKEkycResultWithEvent, EKYCError } from '../types/ekycType';
@@ -167,10 +167,9 @@ export declare class FinosESignModule {
     /**
      * Sign PDF Multiple Positions
      * @param requestJson Request JSON
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
-    signPdfMultiplePositions(requestJson: string): Promise<{
-        response: string;
-    }>;
+    signPdfMultiplePositions(requestJson: string): Promise<ESignPdfResult>;
     /**
      * Register remote signing certificate
      * @param requestJson JSON request body
@@ -181,10 +180,9 @@ export declare class FinosESignModule {
     /**
      * Sign PDF document
      * @param requestJson JSON request body
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
-    signPdf(requestJson: string): Promise<{
-        response: string;
-    }>;
+    signPdf(requestJson: string): Promise<ESignPdfResult>;
     /**
      * Send confirmation document
      * @param requestJson JSON string containing request data

package/dist/src/modules/FinosESignModule.js

@@ -292,6 +292,7 @@ class FinosESignModule {
     /**
      * Sign PDF Multiple Positions
      * @param requestJson Request JSON
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
     async signPdfMultiplePositions(requestJson) {
         this.validateSDKReady();
@@ -309,6 +310,7 @@ class FinosESignModule {
     /**
      * Sign PDF document
      * @param requestJson JSON request body
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
     async signPdf(requestJson) {
         this.validateSDKReady();

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

@@ -46,6 +46,19 @@ export interface ESignSignRequestConfirm {
     authId?: string;
     authData?: string;
 }
+/**
+ * eSign Sign PDF Result
+ * Response from signPdf and signPdfMultiplePositions
+ */
+export interface ESignPdfResult {
+    status: number;
+    msg: string;
+    data?: {
+        transactionId: string;
+        [key: string]: any;
+    };
+    response?: string;
+}
 /** eSign error – dùng chung EKYCError (event, code, message). */
 export type ESignError = import('./ekycType').EKYCError;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "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",
@@ -44,6 +44,7 @@
   "scripts": {
     "clear": "cd android && if [ -d \"../node_modules\" ]; then ./gradlew clean; else rm -rf build app/build; fi && cd .. && rm -rf node_modules && npm cache clean --force",
     "npm-install": "npm install",
+    "npm-install-legacy": "npm install --legacy-peer-deps",
     "build": "tsc && mkdir -p dist && cp package.json dist/",
     "publish-sdk-local": "npm run build && npm pack",
     "publish-sdk": "npm run build && npm publish --access public",

package/src/modules/FinosEKYCModule.ts

@@ -7,7 +7,7 @@ import { OcrConfig, OcrError } from '../types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus, LivenessError } from '../types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareError } from '../types/ekycFaceType';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
-import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
+import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, ESignPdfResult } from '../types/ekycESignType';
 import { SDKFlowType, flowToStrings } from '../types/ekycFlowType';
 
 /**
@@ -641,10 +641,11 @@ export class FinosEKYCModule {
      * Sign PDF document
      * @param accessToken JWT access token
      * @param requestJson JSON request body
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
     public async signPdf(
         requestJson: string
-    ): Promise<{ response: string }> {
+    ): Promise<ESignPdfResult> {
         this.validateSDKReady();
 
         try {

package/src/modules/FinosESignModule.ts

@@ -1,7 +1,7 @@
 import { Platform } from 'react-native';
 import sdkEKYC, { SDKeKYC, SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
-import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, AuthorizeInfo } from '../types/ekycESignType';
+import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, AuthorizeInfo, ESignPdfResult } from '../types/ekycESignType';
 import { LivenessConfig, LivenessError } from '../types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareError } from '../types/ekycFaceType';
 import { SDKEkycResultStringWithEvent, SDKEkycResultWithEvent, EKYCError, getEkycError } from '../types/ekycType';
@@ -352,10 +352,11 @@ export class FinosESignModule {
     /**
      * Sign PDF Multiple Positions
      * @param requestJson Request JSON
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
     public async signPdfMultiplePositions(
         requestJson: string
-    ): Promise<{ response: string }> {
+    ): Promise<ESignPdfResult> {
         this.validateSDKReady();
         return await this.sdk.signPdfMultiplePositions(requestJson);
     }
@@ -375,10 +376,11 @@ export class FinosESignModule {
     /**
      * Sign PDF document
      * @param requestJson JSON request body
+     * @returns ESignPdfResult with status, msg, and data.transactionId
      */
     public async signPdf(
         requestJson: string
-    ): Promise<{ response: string }> {
+    ): Promise<ESignPdfResult> {
         this.validateSDKReady();
         // Pass through to SDK - error handling is done in EKYCModule.ts
         return await this.sdk.signPdf(requestJson);

package/src/types/ekycESignType.ts

@@ -54,6 +54,21 @@ export interface ESignSignRequestConfirm {
   authData?: string;
 }
 
+/**
+ * eSign Sign PDF Result
+ * Response from signPdf and signPdfMultiplePositions
+ */
+export interface ESignPdfResult {
+  status: number;
+  msg: string;
+  data?: {
+    transactionId: string;
+    [key: string]: any; // Cho phép các field động khác
+  };
+  // Fallback field khi không parse được JSON
+  response?: string;
+}
+
 /** eSign error – dùng chung EKYCError (event, code, message). */
 export type ESignError = import('./ekycType').EKYCError;