Teydex Android Document
This document contains all the necessary steps, usage examples, and platform-specific technical details for securely and smoothly integrating the Teydex library into the Android platform.
Version Requirements
To use the Teydex Android library smoothly, you need to check your versions.
| Platform | Min version |
|---|---|
| Android | minSdkVersion: 24 |
| compileSdkVersion: 34 | |
| targetSdkVersion: 34 | |
| kotlinVersion: 1.8.0 |
Android Gradle Configuration
You need to add the following configuration along with the GitLab token in the repository definitions under Settings.gradle. Ensure that you enter the necessary credentials for repository access correctly.
{
maven {
isAllowInsecureProtocol = true
name = "GitLab"
url = uri("<REPO_URL>")
credentials(HttpHeaderCredentials::class) {
name = "Private-Token"
value = "GITLAB_TOKEN"
}
authentication {
create<HttpHeaderAuthentication>("header")
}
}
- REPO_URL should be replaced with the URL provided to you.
- Replace the PRIVATE_TOKEN field with the personal access token provided by your organization.
- The
allowInsecureProtocol = truesetting should only be used in secure networks or on internal private servers.
Gradle Configuration
Add the following lines to your android/app/build.gradle file:
implementation("com.innovance:kyc:1.6.0")
The following dependencies must be defined at the minimum specified versions in your project's android/build.gradle file. Using lower versions may result in compilation or runtime errors related to the library.
buildscript {
dependencies {
classpath("com.android.tools.build:gradle:7.4.2") // Minimum supported version: 7.4.2
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.0" // Minimum supported version: 1.8.0
}
}
Info Screen
The Info screen in your KYC application refers to the informational pages displayed before the steps. Optionally, the following parameters can be added for each step.
Info Screen Features
| Parameter | Type | Description |
|---|---|---|
| toolbarTitle | String | Specifies the text for the toolbar. |
| titleText | String | Specifies the text for the title. |
| descriptionText | String | Specifies the text for the description. |
| buttonText | String | Specifies the text for the button that starts the step. |
| imageResId | @RawRes Int | Specifies the image to be used. |
| lottieResId | @RawRes Int | Specifies the Lottie animation. |
| bullets | List<String> | Information about the next step can be presented in bullet points. |
| bulletIcon | @RawRes Int | Specifies the icon for the bullet points. |
Info Screen Usage
Below is an example of how to use the Info screen.
val frontInfo = buildInfo {
toolbarTitle("Kimlik Ön Yüz")
descriptionText("Lütfen aşağıdaki adımları dikkatlice takip ediniz:")
buttonText("Devam")
lottieResId(R.raw.front)
bullets(
listOf(
"Kimliğinizi Yerleştirin\n" +
"Kimliğinizin arka yüzünü, telefon ekranına paralel bir şekilde
tutun. Kimlik, ekranda görünen şablonun içine tam olarak yerleşecek
şekilde konumlandırılmalıdır.",
"Kimlik Bilgilerinin Görünürlüğü\n Kimlik üzerindeki tüm
bilgilerin net bir şekilde göründüğünden emin olun. Kimlik bilgileri
bulanık olmamalı ve kolayca okunabilir olmalıdır")
)
}
Step
The features to be used in all steps are specified in this section. These features are available in every step (Front, Back, Hologram, NFC, Liveness, Passport, VideoCall, Selfie, VideoRecord).
Step Features
| Parameter | Type | Description |
|---|---|---|
| addInfo | Info | Used to add an Info screen to the corresponding step. It is optional. |
| toolbarTitle | String | Represents the text for the Toolbar to be displayed in the corresponding step. |
| toolbarRightCloseIcon | String | Represents the exit icon to terminate the corresponding step. |
| toolbarLeftCloseIcon | String | Represents the exit icon to terminate the corresponding step. |
| identifyTimeout | Long | Specifies the timeout duration for the corresponding step (ms). e.g., 10_000 |
| stepInformationTextToSpeech | String | Specifies the voice guidance message. |
Glare Detection
Starting with v1.1.0, Front, Back, Liveness, and Passport steps support glare detection to help users capture the document under suitable lighting conditions. When the environment is too bright, too dark, or when a glare is detected on the document, a warning message is displayed to the user on the related screen.
The following parameters are available on Front, Back, and Passport steps:
| Parameter | Type | Description |
|---|---|---|
| isGlareDetectionEnable | Boolean | Enables glare detection for the corresponding step. Default is true for Front and Back, and false for Passport. |
| glareDetectedText | String | Warning text shown when a glare is detected on the document. |
| tooBrightText | String | Warning text shown when the environment is too bright. |
| tooDarkText | String | Warning text shown when the environment is too dark. |
| multipleDocumentsDetectedText | String | Warning text shown when multiple documents are detected in the camera frame. |
For the Liveness step, only ambient-light-related parameters are available:
| Parameter | Type | Description |
|---|---|---|
| isGlareDetectionEnable | Boolean | Enables ambient light monitoring in the Liveness step. Default is true. |
| tooBrightText | String | Warning text shown when the environment is too bright. |
| tooDarkText | String | Warning text shown when the environment is too dark. |
If any of these parameters is not provided, the SDK falls back to the built-in default warning texts (Turkish).
Front Step Usage
val front = buildFront {
identifyTimeout(30_000L)
addInfo(frontInfo)
toolbarTitle("Kimlik Ön Yüz")
toolbarRightCloseIcon(R.drawable.ic_close)
isGlareDetectionEnable(true)
glareDetectedText("Glare detected. Please hold the document at a different angle.")
tooBrightText("The environment is too bright. Please reduce the light.")
tooDarkText("The environment is too dark. Please move to a brighter area.")
multipleDocumentsDetectedText("Please show only one document.")
}
Back Step Usage
val back = buildBack {
identifyTimeout(30_000L)
addInfo(backInfo)
toolbarTitle("Kimlik Arka Yüz")
toolbarRightCloseIcon(R.drawable.ic_close)
isGlareDetectionEnable(true)
glareDetectedText("Glare detected. Please hold the document at a different angle.")
tooBrightText("The environment is too bright. Please reduce the light.")
tooDarkText("The environment is too dark. Please move to a brighter area.")
multipleDocumentsDetectedText("Please show only one document.")
}
NFC Step Usage
val nfc = buildNFC {
addInfo(nfcInfo)
toolbarRightCloseIcon(R.drawable.ic_close)
toolbarTitle("NFC")
}
Hologram Step Usage
val hologram = buildHologram {
addInfo(hologramInfo)
toolbarTitle("Hologram")
}
Passport Step Usage
val passport = buildPassport {
identifyTimeout(60_000L)
addInfo(passportInfo)
toolbarTitle("Passport")
toolbarRightCloseIcon(R.drawable.ic_close)
}
VideoCall Step Features
| Parameter | Type | Description |
|---|---|---|
| splashScreenResourceId | @DrawableRes Int | Used to define the splash screen displayed before VideoCall starts. |
Starting with v1.1.0, it is recommended to configure the VideoCall splash screen and external logo image via UIConfig. See the UIConfig section below.
VideoCall Step Usage
val videoCall = buildVideoCall {
addInfo(videoCallInfo)
splashScreenResourceId(R.drawable.bg_splash)
}
Liveness Step Features
| Parameter | Type | Description |
|---|---|---|
| rightText | String | The command telling the user to look right for the liveness photo. |
| leftText | String | The command telling the user to look left for the liveness photo. |
| upText | String | The command telling the user to look up for the liveness photo. |
| downText | String | The command telling the user to look down for the liveness photo. |
| centerYourFaceText | String | The command telling the user to look directly (straight) at the camera for the liveness photo. |
| multipleFaceText | String | The message informing the user when multiple faces are detected during the liveness step. |
| dotColor | @ColorInt Int | The color of the dots indicating a completed command during the liveness step. |
| dotRadius | Int | The size (radius) of the dots indicating a completed command during the liveness step. |
| rightTextToSpeech | String | The voice command telling the user to look right for the liveness photo. |
| leftTextToSpeech | String | The voice command telling the user to look left for the liveness photo. |
| upTextToSpeech | String | The voice command telling the user to look up for the liveness photo. |
| downTextToSpeech | String | The voice command telling the user to look down for the liveness photo. |
| centerTextToSpeech | String | The voice command telling the user to look directly (straight) at the camera for the liveness photo. |
Liveness Step Usage
val liveness = buildLiveness {
dotColor(Color.Green.toArgb())
rightText("yüzünüzü sağa çeviriniz")
leftText("sola çeviriniz")
upText("yüzünüzü yukarı kaldırınız")
downText("aşağı yöne bakınız")
multipleFaceText("birden fazla yüz algılandı")
identifyTimeout(60_000)
addInfo(livenessInfo)
toolbarTitle("Liveness")
isGlareDetectionEnable(true)
tooBrightText("The environment is too bright. Please reduce the light.")
tooDarkText("The environment is too dark. Please move to a brighter area.")
}
Selfie Step Features
Added in v1.6.0. A step where the user verifies themselves by taking a selfie photo.
| Parameter | Type | Description |
|---|---|---|
| identifyTimeout | Long | Timeout for the step (ms). (Default: 30_000) |
| centerYourFaceText | String | Text telling the user to center their face in the frame. |
| tooCloseText | String | Warning text shown when the face is too close to the camera. |
| tooFarText | String | Warning text shown when the face is too far from the camera. |
| captureButtonText | String | Label of the capture button. |
| retakeButtonText | String | Label of the retake button. |
| confirmButtonText | String | Label of the button confirming the captured photo. |
Selfie Step Usage
val selfie = buildSelfie {
identifyTimeout(15_000L)
centerYourFaceText("Center your face in the frame")
tooCloseText("Move your face away")
tooFarText("Move your face closer")
captureButtonText("Take Photo")
retakeButtonText("Retake")
confirmButtonText("Confirm")
addInfo(selfieInfo)
toolbarTitle("Selfie")
toolbarRightCloseIcon(R.drawable.ic_close)
stepInformationTextToSpeech("Center your face in the frame and press the capture button.")
}
VideoRecord Step Features
Added in v1.6.0. A spoken video verification step where the user creates a video recording by reading the text shown on the screen aloud.
The text the user must read aloud during the VideoRecord step (prompt_text) is provided to the SDK by the backend. The text is sent to the backend in the transaction init request inside the options object via the video_record_prompt_text and video_record_prompt_mandatory_texts fields; the backend returns it to the SDK during the video step and scores the reading accuracy against these texts.
| Parameter | Type | Description |
|---|---|---|
| identifyTimeout | Long | Timeout for the step (ms). (Default: 60_000) |
| faceCenterTimeoutMs | Long | Timeout for centering the face before recording (ms). (Default: 15_000) |
| readyCountdownMs | Long | Countdown shown before the recording starts (ms). (Default: 3_000) |
| recordingDurationMs | Long | Maximum video recording duration (ms). (Default: 20_000) |
| videoQuality | VideoRecordQuality | Recording quality: LOW, MEDIUM, HIGH. (Default: MEDIUM) |
| centerYourFaceText | String | Text telling the user to center their face in the frame. |
| tooCloseText | String | Warning text shown when the face is too close to the camera. |
| tooFarText | String | Warning text shown when the face is too far from the camera. |
| moveLeftText | String | Text telling the user to move their face to the left. |
| moveRightText | String | Text telling the user to move their face to the right. |
| moveUpText | String | Text telling the user to move their face up. |
| moveDownText | String | Text telling the user to move their face down. |
| lookStraightText | String | Text telling the user to look straight at the camera. |
| headTiltedText | String | Warning text shown when the user's head is tilted. |
| startButtonText | String | Label of the start-recording button. |
| stopButtonText | String | Label of the stop-recording button. |
| retakeButtonText | String | Label of the re-record button. |
| confirmButtonText | String | Label of the button confirming and submitting the recording. |
| readingInstructionText | String | Instruction text stating that the prompt must be read aloud during the recording. |
VideoRecord Step Usage
val videoRecord = buildVideoRecord {
identifyTimeout(60_000L)
faceCenterTimeoutMs(15_000L)
readyCountdownMs(3_000L)
recordingDurationMs(20_000L)
videoQuality(VideoRecordQuality.MEDIUM)
centerYourFaceText("Center your face in the frame")
tooCloseText("Move your face away")
tooFarText("Move your face closer")
moveLeftText("Move your face to the left")
moveRightText("Move your face to the right")
moveUpText("Move your face up")
moveDownText("Move your face down")
lookStraightText("Look straight at the camera")
headTiltedText("Straighten your head")
startButtonText("Start Recording")
stopButtonText("Stop Recording")
retakeButtonText("Record Again")
confirmButtonText("Confirm and Submit")
readingInstructionText("Read the text shown on the screen aloud")
addInfo(videoRecordInfo)
toolbarTitle("Spoken Video Verification")
toolbarRightCloseIcon(R.drawable.ic_close)
stepInformationTextToSpeech("Create a video recording by reading the text shown on the screen aloud.")
}
UIConfig
Used to define the general design features to be used in the application. As of v1.4.5, UIConfig has a modular structure that configures color, typography, and shape settings under separate sub-blocks (colors, typography, shapes). Any setter that is omitted falls back to the SDK's default, so the configuration is purely additive. As of v1.6.0, the full color and shape setter surface is exposed.
colors
| Parameter | Type | Description |
|---|---|---|
| primaryColor | @ColorInt Int | Primary brand color (MaterialTheme.colorScheme.primary, outline button border). |
| onPrimaryColor | @ColorInt Int | Content color rendered on top of primaryColor. |
| surfaceColor | @ColorInt Int | Surface color (bottom sheets, cards). |
| onSurfaceColor | @ColorInt Int | Content color rendered on top of surfaceColor. |
| backgroundColor | @ColorInt Int | Window background color. |
| errorColor | @ColorInt Int | Error accent color. |
| successColor | @ColorInt Int | Success accent color. |
| textPrimaryColor | @ColorInt Int | Primary text color. |
| textSecondaryColor | @ColorInt Int | Secondary text color. |
| overlayColor | @ColorInt Int | Camera overlay color — the semi-transparent area outside the document/face frame. |
| buttonColor | @ColorInt Int | Background fill color of buttons. (Default: 0xFF1643E4) |
| buttonTextColor | @ColorInt Int | Text/content color of buttons. (Default: white) |
| lineButtonTextColor | @ColorInt Int | Text color of outlined (line) buttons. (Default: black) |
| bulletTextColor | @ColorInt Int | Text color of bullet points on info screens. (Default: 0xFF808080) |
| titleColor | @ColorInt Int | Title text color on info screens. |
| descriptionColor | @ColorInt Int | Description text color on info screens. |
buttonColor/buttonTextColor/bulletTextColor are kept independent from primaryColor/onPrimaryColor/textSecondaryColor for backwards compatibility. To apply a single brand color, set both members of each pair.
typography
| Parameter | Type | Description |
|---|---|---|
| fontFamily | @FontRes Int | Font family used across the SDK (R.font.<file>). If unset, the system font is used. |
| titleFontSize | Int (sp) | Font size for titles. (Default: 28) |
| bodyFontSize | Int (sp) | Font size for body text. (Default: 16) |
| labelFontSize | Int (sp) | Font size for small labels (bullets, camera warnings). (Default: 14) |
| timerFontSize | Int (sp) | Font size for the countdown text on liveness/timer screens. (Default: 32) |
| buttonFontSize | Int (sp) | Font size for button labels. (Default: 16) |
| titleFontWeight | Int | Font weight for title text (100–900). (Default: 700) |
| bodyFontWeight | Int | Font weight for body/label text. (Default: 400) |
shapes
| Parameter | Type | Description |
|---|---|---|
| buttonCornerRadius | Int (dp) | Corner radius of buttons. (Default: 12) |
| cardCornerRadius | Int (dp) | Corner radius of warning cards / hint boxes. (Default: 8) |
| imageFrameCornerRadius | Int (dp) | Corner radius of image / animation frames. (Default: 18) |
| bottomSheetCornerRadius | Int (dp) | Corner radius of bottom sheet top edges. (Default: 28) |
| cameraOverlayCornerRadius | Int (dp) | Corner radius of the camera overlay cutout. (Default: 12) |
VideoCall images (root level)
| Parameter | Type | Description |
|---|---|---|
| setVideoCallExternalLogoImage | @DrawableRes Int | Added in v1.1.0. Specifies the external logo image to be displayed on the VideoCall screen. |
| setVideoCallSplashScreenImage | @DrawableRes Int | Added in v1.1.0. Specifies the splash screen image displayed before VideoCall starts. |
UIConfig Usage
val uiConfig = buildUIConfig {
colors {
primaryColor(0xFF1643E4.toInt())
buttonColor(0xFF1643E4.toInt())
buttonTextColor(0xFFFFFFFF.toInt())
bulletTextColor(0xFF808080.toInt())
lineButtonTextColor(0xFF000000.toInt())
surfaceColor(0xFFFFFFFF.toInt())
overlayColor(0x80141414.toInt())
}
typography {
fontFamily(R.font.brand_regular)
titleFontSize(28)
buttonFontSize(16)
}
shapes {
buttonCornerRadius(30)
bottomSheetCornerRadius(28)
}
setVideoCallExternalLogoImage(R.drawable.ic_logo_sample)
setVideoCallSplashScreenImage(R.drawable.ic_logo_sample)
}
KYC
This is the main function that will start the KYC process. All specified features are added here, and a KYC flow is initiated with the process function.
KYC Features
| Parameter | Type | Description |
|---|---|---|
| baseUrl | String | The baseUrl to be used globally in the application, the URL from the on-premise server. |
| videoCallBaseUrl | String | The URL to be used for the VideoCall flow, the URL from the on-premise video call server. |
| addUIConfig | UIConfig | Used to specify UI configuration features globally across the SDK. |
| showCompletedScreen | Boolean | Specifies whether to display the success screen when all steps are successfully completed. |
| completedScreenTexts | CompletedScreenTexts | Added in v1.6.0. Used to customize the title, description and button text of the success screen. |
| language | String | Added in v1.6.0. Sets the SDK language ("tr", "en", "ru"). Falls back to the device language when unset. |
| identifierSteps | MutableList<Step> | Ensures all steps are included in the system with the created features. |
| addClientToken | String | Used to pass the client token required to initialize the SDK. |
| addApplicationId | String | Used to pass the applicationId required to initialize the SDK. |
| addErrorMessages | HashMap<KYCErrorString> | Used to display custom error messages in the SDK. |
| onEvent | KYCEvent | Can be used to forward events from the SDK to third-party analytics tools like Firebase, Mixpanel, or Countly. |
| onError | KYCError | Can be used to log error messages generated by the SDK. |
| onCompletion | Boolean | Deprecated; use onProcessFinished instead. Will be removed entirely in the next major version; still called for backward compatibility for now. |
| onProcessFinished | KYCProcessResult | Notifies the host app when the KYC flow finishes as successful, failed, or cancelled. |
| shouldGetCustomerLocation | Boolean | Specifies whether the user's location information should be collected. |
| sslPins | List<String> | Used to add the necessary sha256 keys for SSL pinning. |
| process | Context | Used to initialize the SDK for a KYC flow with the specified features. |
| dismissKYC | Boolean | Used to stop and close the active KYC flow programmatically. |
KYC Usage
val kyc = buildKYC {
addUIConfig(uiConfig)
showCompletedScreen(true)
completedScreenTexts(CompletedScreenTexts.buildCompletedScreenTexts {
titleText("Your account is verified!")
descriptionText("You can now continue using the app.")
buttonText("Continue")
})
language("en")
identifierSteps(mutableListOf(front,hologram,back,nfc,liveness,passport,videoCall,selfie,videoRecord))
addClientToken(AppSharedPref.getClientToken(context))
addApplicationId(AppSharedPref.getAppId(context))
addErrorMessages(hashMapOf(
KYCNFCError.NOT_ENABLE to "not enable",
KYCCameraError.FLASH_MODE to " flash mode"))
onEvent { Log.i("TEST_LOG", "KYC Event:${it.name}")}
onError { Log.i("TEST_LOG", "KYC Error:${it.type} - ${it.message}")}
onProcessFinished { result ->
when (result) {
KYCProcessResult.Successful -> Log.i("TEST_LOG", "KYC Successful")
is KYCProcessResult.Failed -> Log.i("TEST_LOG", "KYC Failed step:${result.stepName} reason:${result.reason}")
is KYCProcessResult.Cancelled -> Log.i("TEST_LOG", "KYC Cancelled step:${result.stepName} reason:${result.reason}")
}
}}
kyc.process(context)
kyc.dismissKYC()
KYCProcessResult.Failed and KYCProcessResult.Cancelled also carry a reason field alongside stepName (Failed.reason: String, Cancelled.reason: KYCCancelReason). This field holds the actual reason the flow failed or was cancelled; it's recommended to log result.reason as well for diagnostics and support.
KYCError
The type and descriptions of errors that may come from the SDK can be accessed here. Error messages that need to be changed can be modified using addErrorMessages in the form of KYCError,String. For example: KYCCameraError.FLASH_MODE to "flash mode".
| Parameter | Description |
|---|---|
| UNKNOWN | Bilinmeyen hata |
| FIRST_STEP_UNDEFINED | İlk adım null olamaz! |
| APP_IDENTIFIER_STEPS_IS_NOT_SAME_API | Uygulamada tanımladığınız adımlar ile API'de tanımladığınız adımların aynı olması gerekmektedir. |
KYCCameraError
| Parameter | Description |
|---|---|
| UNKNOWN | Bilinmeyen bir hata oluştu. Lütfen tekrar deneyin. |
| PERMISSION_NOT_GRANTED | Kamera izinleri verilmedi. Lütfen kamera izinlerinizi veriniz. |
| CAMERA_PERMISSION_REQUIRED | Kamera izni gerekli. Lütfen kamera izni veriniz. |
| CAMERA_PERMISSION_PERMANENTLY_DENIED | Kamera izni kalıcı olarak reddedildi. Lütfen ayarlardan kamera izni veriniz. |
| RECORD_AUDIO_REQUIRED | Ses kaydı izni gerekli. Lütfen ses kaydı izni veriniz. |
| RECORD_AUDIO_PERMANENTLY_DENIED | Ses kaydı izni kalıcı olarak reddedildi. Lütfen ayarlardan ses kaydı izni veriniz. |
| CAMERA_SOURCE_PREVIEW_NOT_FOUND | Kamera ön izlemesi oluşturulamadı. Lütfen tekrar deneyin. |
| CAMERA_SOURCE_NOT_FOUND | Kamera bulunamadı. Lütfen kamerayı kontrol edin. |
| FLASH_MODE | Flash aç/kapa işlemi sırasında bir hata oluştu. Lütfen tekrar deneyin. |
| VIDEO_WRITE_FAILED | Video kaydedilirken bir hata oluştu. Lütfen tekrar deneyin. |
| VIDEO_READ_FAILED | Video bulunamadı. Lütfen dosyanın varlığını kontrol edin. |
| VIDEO_EXECUTE_COMMAND_CANCELLED_BY_USER | Video düzenleme işlemi kullanıcı tarafından iptal edildi. |
| VIDEO_EXECUTE_COMMANDS_FAILED | Video düzenleme işlemi başarısız oldu. Lütfen tekrar deneyin. |
| VIDEO_COMPRESS_FAILED | Video sıkıştırma işlemi başarısız oldu. Lütfen tekrar deneyin. |
| CODEC_NOT_SUPPORTED | Video düzenleme işlemi başarısız oldu. Lütfen tekrar deneyin. |
KYCNFCError
| Parameter | Description |
|---|---|
| UNKNOWN | Bilinmeyen bir hata oluştu. Lütfen tekrar deneyin. |
| DEVICE_NOT_HAVE_NFC | Cihazda NFC modülü bulunmuyor. Bu özellik yalnızca NFC destekli cihazlarda çalışır. |
| DISABLE_NFC_ADAPTER | NFC modülü devre dışı bırakılırken bir hata oluştu. Lütfen NFC'yi tekrar etkinleştirin. |
| NOT_ENABLE | NFC modülü aktif değil. Lütfen NFC'yi etkinleştirin. |
| NOT_DISCOVERED | NFC açıkken kimlik taranamadı. Lütfen kimliği tekrar yaklaştırın. |
| TAG_NOT_SUPPORTED | Kimlik bilgisi desteklenmiyor. Bu kimlik kartı desteklenmemektedir. |
| TAG_LOST | Kimlik bilgisi okunamadı. Lütfen kimliği tekrar yaklaştırın. |
| ISODEP_NOT_FOUND | Kimlik bilgisi okunamadı. Lütfen kimliği tekrar yaklaştırın. |
| PASSIVE_AUTH_FAILED | Kimlik bilgisi algılanamadı. Lütfen geçerli bir kimlik kullanın. |
| PHOTO_NOT_FOUND | Kimlik kartında fotoğraf bilgisi yok. Lütfen geçerli bir kimlik kullanın. |
| PERSON_DETAIL_NOT_FOUND | Kişi bilgisine ihtiyaç var. Lütfen kimliği doğru yerleştirin. |
| CARD_AUTH_FAILED | Kimlik bilgileri tanımlanamadı. |
| WRONG_MRZ_STRING | MRZ bilgisi algılanamadı. Lütfen kimliği tekrar yaklaştırın. |