> For the complete documentation index, see [llms.txt](https://docs.identomat.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.identomat.com/identomat-documentation-ukr/sdks/android-sdk.md).

# Android SDK

{% hint style="info" %}
Остання версія: **Version 1.1.188**
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>Детальний посібник дивіться в нашій документації на <strong>GitLab</strong>.</td><td></td><td></td><td></td><td><a href="https://gitlab.identomat.com/world/identomat-example-app-android">https://gitlab.identomat.com/world/identomat-example-app-android</a></td><td></td></tr></tbody></table>

## Документація з інтеграції

Бібліотека Identomat пропонує потік ідентифікації користувача, що складається з різних кроків, поєднуючи типи документів із зображеннями чи відео користувача.

### Для початку сесії за допомогою API Identomat необхідні такі кроки

{% stepper %}
{% step %}
[Отримати токен сесії та налаштувати сесію](#id-1.-otrimati-token-sesiyi-ta-nalashtuvati-sesiyu)
{% endstep %}

{% step %}
[Отримати екземпляр Identomat SDK](#id-2.-otrimati-ekzemplyar-identomat-sdk-ta-peredati-dani)
{% endstep %}

{% step %}
[Передати токен сесії та обробити колбек](#id-3.-peredati-token-sesiyi-ta-obrobiti-kolbek)
{% endstep %}

{% step %}
[Запустити Identomat SDK](#id-4.-zapustiti-identomat-sdk)
{% endstep %}

{% step %}
[Передати додаткові змінні](#id-5.-peredati-dodatkovi-zminni)
{% endstep %}
{% endstepper %}

## 1. Отримати токен сесії та налаштувати сесію

Щоб почати сесію, спочатку потрібно отримати `session_token`, викликавши ендпоінт `begin/` та налаштувавши ваш потік верифікації.

> ⚠️ **Примітка:** Цей процес ідентичний для веб- та SDK-інтеграцій.

Повні деталі щодо генерації токена сесії, налаштування кроків та прапорців, а також запуску сесії див. у [**Посібнику з веб-інтеграції — ініціалізація сесії**.](/identomat-documentation-ukr/posibnik-dlya-rozrobnikiv.md)

Отримавши токен сесії, ви можете продовжити інтеграцію його у ваш потік SDK.

## 2. Отримати екземпляр Identomat SDK та передати дані

Основний клас Identomat SDK — це клас `IdentomatManager`.\
`IdentomatManager` — клас-синглтон в Identomat SDK (з використанням класу Kotlin `Object`).

Щоб отримати екземпляр SDK, ви можете зробити таке:

* **Для Java:**\
  Ви можете отримати екземпляр за допомогою:

```java
IdentomatManager identomatSdk = IdentomatManager.INSTANCE;
```

* **Для Kotlin:**\
  Ви можете використовувати його як `IdentomatManager`, що відноситься до класу Kotlin `Object`.

## 3. Передати токен сесії та обробити колбек

* **sessionToken** – Відповідь від API: тип `String`.

Щоб передати токен сесії, ми використовуємо функцію `setUp`, яку можна викликати так:

```java
IdentomatManager.INSTANCE.setUp(token: sessionToken);
```

Останній крок — передати функцію колбека, яка буде запущена після завершення взаємодії користувача з бібліотекою. Для цього використовуйте функцію `.setCallback`, яка приймає функцію як аргумент:

```java
IdentomatManager.INSTANCE.setCallback(() -> {
    // Go to result page;
});
```

## 4. Запустити Identomat SDK

Бібліотека надасть нам `Intent` для головної активності SDK, яку ми можемо запустити так:

```java
startActivity(IdentomatManager.INSTANCE.getIdentomatActivity(MainActivity.this));
```

## 5. Передати додаткові змінні

Для налаштування бібліотеки Identomat під застосунок у нас є декілька додаткових функцій:

1. `setColors(colors: Map)` - встановлює конкретні кольори
2. `setStrings(dict : Map)` - встановлює конкретні текстові рядки
3. `setVariables(variables : Map<String, Any?>)` - встановлює багато настроюваних змінних
4. `setLogo(() -> View?)` - встановлює анімацію завантаження, приймає функцію, яка повертає view, приклад використання:
5. `back_button_icon`- Змінює іконку кнопки «назад».
6. `primary_button_width` – Налаштовує ширину основної кнопки.
7. `primary_button_height` – Налаштовує висоту основної кнопки.
8. `liveness_smile_icon`– Змінює іконку посмішки перевірки живості. Приклад: *UIImage(named: "liveness\_smile\_icon")*

### Застарілі функції (Після версії 1.0.21)

Наступні функції застаріли після версії 1.0.21:

5.0 `skipLivenessInstructions()` - пропускає інструкції перевірки живості

5.1 `setLivenessIcons(neutralFace: Int, smileFace: Int)` - встановлює іконки перевірки живості, надсилайте int ресурсу так: `R.drawable.ic_liveness_neutral_icon`

5.2 `setLivenessRetryIcon(retryIcon: Int?, size : Int)` - встановлює головну іконку панелі повторних спроб перевірки живості, size встановлює розмір іконки

5.3 `setRetryIcon(retryIcon: Int?, size : Int)` - встановлює головну іконку панелі повторних спроб перегляду сканування документа, size встановлює розмір іконки

5.4 `setCameraDenyIcon(cameraDenyIcon: Int?, size : Int)` - встановлює головну іконку панелі повторних спроб перегляду сканування документа

5.5 `setButtonCornerRadius(radius : Int)` - встановлює радіус закруглення кутів кожної кнопки

5.6 `setPanelElevation(elevation : Int)` - встановлює підняття панелей

***

### 1. Налаштування кольорів

Використовуйте функцію `setColors`, щоб налаштувати кольори в бібліотеці відповідно до теми застосунку. Передайте словник, що містить відповідні ключі кольорів та їхні відповідні шістнадцяткові значення:

```
"background",
"text_primary",
"text_secondary",
"text_placeholder",
"text_disabled",
"text_inverse",
"text_link",
"primary_color",
"neutral_color",
"danger_color",
"success_color",
"warning_color",
"black",
"white"
```

Приклад словника

* **для Java:**

```java
static HashMap colors = new HashMap(){{
    put("background", "#222222");
    put("text_primary", "#A4A4A4");
    put("text_secondary", "#676767");
    put("text_placeholder", "#7848FF");
    put("text_disabled", "#A4A4A4");
    put("text_inverse", "#676767");
    put("text_link", "#7848FF");
    put("primary_color", "#FFFFFF");
    put("neutral_color", "#222222");
    put("danger_color", "#FFFFFF");
    put("success_color", "#2D2D2D");
    put("warning_color", "#FFFFFF");
}};
```

* **для Kotlin:**

```kotlin
var colors : Map<String, String> = mapOf(
    "background" to "#222222",
    "text_primary" to "#FFFFFF",
    ...
    )
```

Спосіб передачі кольорів у бібліотеку: `IdentomatManager.setColors(colors: colors)`

### 2. Налаштування рядків

Щоб налаштувати рядки, які бібліотека відображає в конкретних місцях, у нас є функція `setStrings(string: Map)`.

Функція `setStrings` приймає `Map`, де ключі відповідають ідентифікаторам рядків, що використовуються в бібліотеці, а значення — рядки, які ви хочете відображати для різних мов. Структура виглядає так:

**Приклад для Java:**

```java
static HashMap strings = new HashMap(){{
    put("en",  new HashMap<String, String>() {{
        put("identomat_agree", "Yes I agree");
        put("identomat_disagree", "Disagree");
    }});
    put("ru",  new HashMap<String, String>() {{
        put("identomat_agree", "Согласен");
        put("identomat_disagree", "Не согласен");
    }});
    put("es",  new HashMap<String, String>() {{
        put("identomat_agree", "Acepto");
        put("identomat_disagree", "No acepto");
    }});
    put("ka",  new HashMap<String, String>() {{
        put("identomat_agree", "ვეთანხმები");
        put("identomat_disagree", "არ ვეთანხმები");
    }});
}};
```

**для Kotlin:**

```kotlin
 var strings : Map<String, Map<String,String>> = mapOf(
            "en" to mapOf(
                    "identomat_agree" to "Yes I agree",
                    "identomat_disagree" to "Disagree",
            ),
            "ru" to mapOf(
                    "identomat_agree" to "Согласен",
                    "identomat_disagree" to "Не согласен",
            ),
            "es" to mapOf(
                    "identomat_agree" to "Acepto",
                    "identomat_disagree" to "No acepto",
            ),
            "ka" to mapOf(
                "identomat_agree" to "ვეთანხმები",
                "identomat_disagree" to "არ ვეთანხმები",
            )
    )
```

Кожен рядок має свій власний ключ у бібліотеці, і його можна змінити. Список ключів рядків наведено в кінці.

### 3. Налаштування змінних

Для будь-якого іншого налаштування ми використовуємо функцію `setVariables(variables: Map<String, Any?>)`, куди ми передаємо мапу пар ключ-значення змінних.

Структура мапи виглядає так:

```
var variables : MutableMap<String, Any?> = mutableMapOf(
   
    "liveness_neutral_icon" to R.drawable.ic_liveness_neutral_icon,     -- sets liveness neutral face icon.     type -> int
    "liveness_smile_icon" to R.drawable.ic_liveness_smile_icon,         -- sets liveness smile face icon.       type -> int

    "liveness_retry_icon" to R.drawable.image,                          -- sets liveness retry page icon.       type -> int
    "liveness_retry_text_icon_1" to R.drawable.image,                   -- sets liveness retry page instruction icon 1.       type -> int
    "liveness_retry_text_icon_2" to R.drawable.image,                   -- sets liveness retry page instruction icon 2.       type -> int
    "liveness_retry_text_icon_3" to R.drawable.image,                   -- sets liveness retry page instruction icon 3.       type -> int
    "liveness_retry_text_icon_4" to R.drawable.image,                   -- sets liveness retry page instruction icon 4.       type -> int

    "scan_retry_icon" to R.drawable.image,                              -- sets scan document retry page icon.  type -> int
    "camera_deny_icon" to R.drawable.image,                             -- sets camera deny page icon.          type -> int
    "upload_retry_icon" to R.drawable.image,                            -- sets upload retry page icon.         type -> int

    "liveness_retry_icon_size" to 200,                                  -- sets save icon sizes.                type -> int
    "scan_retry_icon_size" to 200,
    "camera_deny_icon_size" to 200,
    "upload_retry_icon_size" to 200,
    
    "location_instruction_icon_1" to R.drawable.image,  
    "location_instruction_icon_2" to R.drawable.image,  

    "geolocation_icon" to R.drawable.image,  
    "geolocation_success_icon" to R.drawable.image,  
    "geolocation_deny_icon" to R.drawable.image,  

    "liveness_retry_count" to 3,                        -- new liveness video upload retry count

    "skip_liveness_instructions" to false,              -- skips liveness instructions                          type -> boolean
    "liveness_type" to 1,                               -- chooses liveness icons display type values 1 or 2    type -> int
    "button_corner_radius" to null,                     -- sets button corner radious, if it's null button will be round cornered              
    "panel_elevation" to 1,                             -- sets panels elevation,                               type -> int

    "liveness_info_main_icon" or "liveness_info_main_anim",      -- instruction page  
    "liveness_frame_face_icon" or "liveness_frame_face_anim",    -- frame page
    "instruction_smile_icon" or "instruction_smile_anim"         -- Liveness processing page 
    
    //Sets  font sizes
    "title_medium_size" to 16,
    "title_small_size" to 14,
    "headline_medium_size" to 28,
    "headline_small_size" to 24,
    "body_medium_size" to 16,
    "body_small_size" to 14
 
    //Sets font
    "title_font" to "font-name",
    "headline_font" to "font-name",
    "body_font" to "font-name"
    
    "default_country_code" to "GE"                      -- sets default country for country code picker
)
```

Ключі рядків (залишено англійською, оскільки це значення за замовчуванням у файлі ресурсів коду):

```xml
<resources>

  //ID verification
  <string name="identomat_select_document">Select document</string>
 
  <string name="identomat_card">ID card</string>
  <string name="identomat_card_front_instructions">Scan FRONT SIDE of ID CARD</string>
  <string name="identomat_card_front_upload">Upload FRONT SIDE of ID CARD</string>
  <string name="identomat_card_rear_instructions">Scan BACK SIDE of ID CARD</string>
  <string name="identomat_card_rear_upload">Upload BACK SIDE of ID CARD</string>
 
  <string name="identomat_driver_license">Driver license</string>
  <string name="identomat_driver_license_front_instructions">Scan FRONT SIDE of DRIVER LICENSE</string>
  <string name="identomat_driver_license_front_upload">Upload FRONT SIDE of DRIVER LICENSE</string>
  <string name="identomat_driver_license_rear_instructions">Scan BACK SIDE of DRIVER LICENSE</string>
  <string name="identomat_driver_license_rear_upload">Upload BACK SIDE of DRIVER LICENSE</string>
   
  <string name="identomat_passport">Passport</string>
  <string name="identomat_passport_instructions">Passport photo page</string>
  <string name="identomat_passport_upload">Upload passport photo page</string>
   
  <string name="identomat_residence_permit">Residence permit</string>
  <string name="identomat_residence_permit_front_instructions">Scan FRONT SIDE of RESIDENCE PERMIT</string>
  <string name="identomat_residence_permit_front_upload">Upload FRONT SIDE of RESIDENCE PERMIT</string>
  <string name="identomat_residence_permit_rear_instructions">Scan BACK SIDE of RESIDENCE PERMIT</string>
  <string name="identomat_residence_permit_rear_upload">Upload BACK SIDE of RESIDENCE PERMIT</string>
   
  <string name="identomat_capture_method_title">Choose a method</string>
  <string name="identomat_take_photo">Take a photo</string>
  <string name="identomat_upload_file">Upload a file</string>
  <string name="identomat_upload_another_file">Upload another file</string>
   
  <string name="identomat_upload_instructions_1">Upload a color image of the entire document</string>
  <string name="identomat_upload_instructions_2">JPG or PNG format only</string>
  <string name="identomat_upload_instructions_3">Screenshots are not allowed</string>
  <string name="identomat_choose_file">Choose a file</string>
   
  <string name="identomat_verifying">Verifying...</string>
  <string name="identomat_uploading">Uploading...</string>
   
  <string name="identomat_scan_retry_title">Capture failed</string>
  <string name="identomat_scan_retry_instruction">Please try again in better lighting</string>
  <string name="identomat_scan_retry_again">Try again</string>
  <string name="identomat_upload_success">Successfully uploaded!</string>
   
  <string name="identomat_no_document_in_image">Frame your document</string>
  <string name="identomat_document_align">Frame your document</string>
  <string name="identomat_document_blurry">Document is blurry</string>
  <string name="identomat_document_face_blurry">Face on document is blurry</string>
  <string name="identomat_document_face_require_brighter">Low light</string>
  <string name="identomat_document_face_too_bright">Avoid direct light</string>
  <string name="identomat_document_move_away">Please move document away</string>
  <string name="identomat_document_move_closer">Please move document closer</string>
  <string name="identomat_document_move_down">Please move document down</string>
  <string name="identomat_document_move_left">Please move document to the left</string>
  <string name="identomat_document_move_right">Please move document to the right</string>
  <string name="identomat_document_move_up">Please move document up</string>
  <string name="identomat_document_covered">Document is covered</string>
  <string name="identomat_document_grayscale">Document is grayscale</string>
  <string name="identomat_document_type_mismatch">Wrong document</string>
  <string name="identomat_document_not_readable">Document not readable</string>
  <string name="identomat_document_face_align">Document face align</string>
  <string name="identomat_document_spoofing_detected2">Document spoofing detected</string>
  <string name="identomat_document_page_mismatch">Wrong page</string>
  <string name="identomat_document_nfc_chip_damaged">Document NFC chip damaged</string>
   
   
  //Passive liveness
  <string name="identomat_face_instructions">Place your FACE within OVAL</string>
  <string name="identomat_processing">Processing, please wait</string>
   
   
  // Active liveness
  <string name="identomat_record_begin_section_1">Take a neutral expression</string>
  <string name="identomat_record_begin_section_2">Smile on this sign</string>
  <string name="identomat_record_begin_section_3">Take a neutral expression again</string>
  <string name="identomat_record_begin_title">Get ready for your video selfie</string>
  <string name="identomat_record_instructions">Place your FACE within OVAL and follow the on-screen instructions</string>
  <string name="identomat_im_ready">I\'m ready</string>
  <string name="identomat_neutral_expression">Neutral face</string>
  <string name="identomat_smile">Smile</string>
   
   
  // Adaptive liveness
 <string name="identomat_passive_record_begin_title">Get ready for your video selfie</string>
 <string name="identomat_passive_record_begin_subtitle">Follow the on-screen instructions when prompted.</string>
 <string name="identomat_passive_record_begin_subtitle_smile">When prompted, repeat the facial expression shown on the icons.</string>
 <string name="identomat_passive_record_begin_section_title">Tips</string>
 <string name="identomat_passive_record_begin_section_1">Frame your face</string>
 <string name="identomat_passive_record_begin_section_2">Hold still until success notify</string>
 <string name="identomat_smile">Smile</string>
 <string name="identomat_im_ready">I\'m ready</string>
   
   
  //Cascading liveness
  <string name="identomat_cascading_instructions">When prompted, repeat the facial expression shown on the icons: \n\n<b>• Keep neutral face \n• Smile</b></string>
  <string name="identomat_cascading_instructions_title">When prompted, repeat the facial expression shown on the icons:</string>
  <string name="identomat_cascading_instructions_1">• Keep neutral face</string>
  <string name="identomat_cascading_instructions_2">• Smile</string>
  <string name="identomat_cascading_button">Start Liveness Check</string>
  <string name="identomat_cascading_neutral_face">Keep neutral face</string>
  <string name="identomat_cascading_start">Position your face!</string>
  <string name="identomat_cascading_smile">Smile!</string>
  <string name="identomat_cascading_fail">Liveness Failed</string>
  <string name="identomat_cascading_success">That\'s it!</string>
   
  <string name="identomat_liveness_retry_title">We can\'t detect your face</string>
  <string name="identomat_liveness_retry_instruction">But first, please take a look at the instructions</string>
  <string name="identomat_liveness_retry_again">Try again</string>
  <string name="identomat_liveness_retry_instruction_1">Make sure to be in a place with good lighting</string>
  <string name="identomat_liveness_retry_instruction_2">Make sure your eyes are clearly visible</string>
  <string name="identomat_liveness_retry_instruction_3">Make sure to remove masks or other items that cover your face. Eyeglasses are okay</string>
  <string name="identomat_liveness_retry_instruction_4">Make sure to only show your face, we don't need to see your ID</string>
   
  <string name="identomat_lets_try">Let\'s try</string>
   
  <string name="identomat_low_neutral_frequency">Untimely smile detected</string>
  <string name="identomat_not_smile">Smile not detected</string>
  <string name="identomat_eyes_closed">Eyes are closed</string>
  <string name="identomat_face_hold">Hold still</string>
  <string name="identomat_no_face">Face is missing</string>
  <string name="identomat_face_covered">Face is covered</string>
  <string name="identomat_face_align">Frame your face</string>
  <string name="identomat_face_away_from_center">Center your Face</string>
  <string name="identomat_face_blurry">Face is blurry</string>
  <string name="identomat_face_far_away">Move closer</string>
  <string name="identomat_face_require_brighter">Low light</string>
  <string name="identomat_face_too_bright">Avoid direct light</string>
  <string name="identomat_face_too_close">Move away</string>
  <string name="identomat_smile_detected">Get neutral face</string>
  <string name="identomat_multiple_face">Keep only your face visible</string>
   
   
  //Camera permission
  <string name="identomat_camera_deny_title">Camera access denied</string>
  <string name="identomat_camera_deny_settings">Allow access</string>
  <string name="identomat_camera_deny_cancel">Cancel process</string>
   
   
  //Phone number collect&verify
  <string name="identomat_resend_code">Resend Code</string>
  <string name="identomat_get_code">Get Code</string>
  <string name="identomat_sms_title">Verify Phone Number</string>
  <string name="identomat_sms_subtitle">Enter your correct phone number\nto get verification code</string>
  <string name="identomat_resend_in">Resend code in </string>
  <string name="identomat_invalid_number">Please enter valid number</string>
  <string name="identomat_invalid_code">The code is not valid</string>
  <string name="identomat_sms_code_sent">Enter the 4-digit verification code sent to </string>
  <string name="identomat_enter_sms_code">Enter SMS code</string>
  <string name="identomat_phone_number_hint">Phone number</string>
  <string name="identomat_enter_phone_number">Enter phone number</string>
  <string name="identomat_enter_correct_number">Enter your correct phone number</string>
  <string name="identomat_confirm">Confirm</string>
  <string name="identomat_search">Search</string>
  <string name="identomat_verify_enter_code_hint">Enter code</string>
   
   
  // Email collect & verify
  <string name="identomat_enter_email_address">Enter email address</string>
  <string name="identomat_enter_correct_email">Enter your correct email address</string>
  <string name="identomat_enter_valid_email">Please enter valid email</string>
  <string name="identomat_email_hint">Email address</string>
  <string name="identomat_confirm">Confirm</string>
  <string name="identomat_email_check_title">Verify Email</string>
  <string name="identomat_email_check_subtitle">Enter your correct email address\nto get verification code</string>
  <string name="identomat_get_code">Get Code</string>
  <string name="identomat_resend_in">Resend code in </string>
  <string name="identomat_resend_code">Resend Code</string>
  <string name="identomat_verify_email_code_title">Enter code</string>
  <string name="identomat_verify_email_code_subtitle">Enter the 6-digit verification code sent to </string>
  <string name="identomat_verify_email_invalid_code">The code is not valid</string>
  <string name="identomat_verify_enter_code_hint">Enter code</string>
   
   
  //Page titles
  <string name="identomat_require_email_header"> </string>
  <string name="identomat_require_phone_number_header"> </string>
  <string name="identomat_require_phone_number_check_header"> </string>
  <string name="identomat_enter_sms_code_header"> </string>
  <string name="identomat_select_documents_header"> </string>
  <string name="identomat_capture_methods_header"> </string>
  <string name="identomat_upload_header"> </string>
  <string name="identomat_new_liveness_header"> </string>
  <string name="identomat_camera_access_header"> </string>
  <string name="identomat_select_country">Select country</string>
  <string name="identomat_retry_header"> </string>
   
   
  //Geolocation
  <string name="identomat_send_location_button">Send Location</string>
  <string name="identomat_geolocation_title">Allow location access</string>
  <string name="identomat_geolocation_subtitle">To continue the verification, we need access to your device\'s location.</string>
  <string name="identomat_geolocation_success">Your profile has been verified.</string>
   
  <string name="identomat_geolocation_deny_title">Location access denied</string>
  <string name="identomat_geolocation_deny_subtitle">We can't identify you without your location</string>
  <string name="identomat_geolocation_deny_instruction_1">You can recover location access through your device settings</string>
  <string name="identomat_geolocation_deny_instruction_2">Go to app settings and enable location access for this app</string>
  <string name="identomat_geolocation_enable_button">Enable in settings</string>
  <string name="identomat_geolocation_cancel_button">Cancel process</string>
   
   
  //Proof of Address
  <string name="identomat_bank_statement">Bank Statement</string>
  <string name="identomat_utility_bill">Utility bill</string>
  <string name="identomat_vehicle_registration_certificate">Vehicle registration certificate</string>
  <string name="identomat_yellow_slip">Yellow slip</string>
  <string name="identomat_drivers_license">Driver\'s license</string>
   
  <string name="identomat_upload_bank_statement">Upload Bank Statement</string>
  <string name="identomat_upload_utility_bill">Upload Utility bill</string>
  <string name="identomat_upload_vehicle_registration_certificate">Upload Vehicle registration certificate</string>
  <string name="identomat_upload_yellow_slip">Upload Yellow slip</string>
  <string name="identomat_upload_drivers_license">Upload Driver\'s license</string>
  <string name="identomat_upload_document_subtitle">Make sure that all the information on the photo is visible and easy to read</string>
   
  <string name="identomat_select_document_title">Select Document</string>
  <string name="identomat_proof_of_address_title">Proof of Address</string>
  <string name="identomat_proof_of_address_subtitle">Please upload a document that confirms your residential address.</string>
  <string name="identomat_uploaded">Uploaded</string>
  <string name="identomat_document_errors">Document Errors</string>
   
  <string name="identomat_expired_date_was_not_found">Expiry date was not found in the document</string>
  <string name="identomat_issued_date_was_not_found">Issue date was not found in the document</string>
  <string name="identomat_full_name_does_not_match">Full name does not match</string>
  <string name="identomat_full_name_was_not_found">Full name was not found in the document</string>
  <string name="identomat_issuing_authority_name_was_not_found">Issuing authority name was not found in the document</string>
  <string name="identomat_street_address_was_not_found">Street address was not found in the document</string>
  <string name="identomat_document_expired">Document is expired</string>
  <string name="identomat_address_not_valid">Address not valid</string>
  <string name="identomat_document_date_is_in_the_future">Document date is in the future</string>
  <string name="identomat_document_not_matched">Document not matched</string>
  <string name="identomat_oversized_file">Oversized File: Maximum file size is 5MB</string>
  <string name="identomat_unsupported_file_type">File Format Mismatch</string>
  <string name="identomat_too_many_pages">Too many Pages: Maximum pages is 20</string>
   
  <string name="identomat_continue">Continue</string>
  <string name="identomat_no_connection">No internet connection</string>
  
  
  <string name="identomat_nfc_next">Next</string>
  <string name="identomat_nfc_start_scanning">Start Scanning</string>
  <string name="identomat_nfc_check_id">Check for the NFC chip in your ID</string>
  <string name="identomat_nfc_check_passport">Check for the NFC chip in your Passport</string>
  <string name="identomat_nfc_subtitle_id">Make sure the ID card has appropriate symbols on it</string>
  <string name="identomat_nfc_subtitle_id_1">Flip the ID card and scan the back side</string>
  <string name="identomat_nfc_subtitle_passport">Make sure the passport has appropriate symbols on it</string>
  <string name="identomat_nfc_subtitle_passport_1">Open the passport to the photo page and scan it</string>
  <string name="identomat_nfc_scan_the_document">Scan the document</string>
  <string name="identomat_nfc_read_id_error_1">Remove your document and phone covers</string>
  <string name="identomat_nfc_read_id_error_2">Ensure that your document has NFC capability</string>
  <string name="identomat_nfc_read_id_error_3">Keep your document and phone still until the progress bar is filled</string>
  <string name="identomat_nfc_read_error_key_missmatch">Please scan the document again or choose another method</string>
  <string name="identomat_nfc_read_error_button_1">Retry reading</string>
  <string name="identomat_nfc_read_error_button_2">Try another method</string>
  <string name="identomat_nfc_read_id_title">Read the NFC chip on your ID</string>
  <string name="identomat_nfc_read_desc">Follow instructions below</string>
  <string name="identomat_nfc_read_warning">Do not separate the document and the phone during the reading process</string>
  <string name="identomat_nfc_read_warning_1">Keep your phone and document still</string>
  <string name="identomat_nfc_reading">Reading...</string>
  <string name="identomat_nfc_dialog_title">NFC not enabled</string>
  <string name="identomat_nfc_dialog_message">To enable it, please navigate to the NFC settings and toggle the switch to on.</string>
  <string name="identomat_nfc_dialog_settings">Settings</string>
  <string name="identomat_nfc_dialog_cancel">Cancel</string>
  
  <string name="identomat_nfc_scan_passport_title">Passport photo page</string>
  <string name="identomat_nfc_error_title">We couldn\'t read NFC on your document</string>
  <string name="identomat_nfc_ready_to_read">Ready to read</string>
  <string name="identomat_nfc_id_place_phone">Place your phone on your ID</string>
  <string name="identomat_nfc_passport_place_phone">Place your phone on your passport</string>
  <string name="identomat_nfc_read_passport_title">Read the NFC chip on your Passport</string>
  <string name="identomat_nfc_read_id_inst_1">Place your ID card at the back of your phone</string>
  <string name="identomat_nfc_read_passport_inst_1">Place your passport at the back of your phone</string>
  <string name="identomat_nfc_read_inst_2">Slowly slide your document up and down</string>
  <string name="identomat_nfc_read_inst_3">Once the reading starts, hold your document and phone still</string>
  <string name="identomat_nfc_button_start_reading">Start reading</string>
  <string name="identomat_nfc_scan">NFC Scan</string>
  
  <string name="identomat_nfc_header"> </string>
  <string name="identomat_nfc_reading_complete">Reading Complete</string>
  
  //Social Security Number verification
  <string name="identomat_ssn_consent_header">SSN verification</string>
  <string name="identomat_ssn_consent_title">Authorization for the Social Security Administration to disclose your social security number verification</string>
  <string name="identomat_ssn_consent_document">I authorize the Social Security Administration (SSA) to verify and disclose to the requesting party whether the name, Social Security Number (SSN), and date of birth I have submitted matches information in SSA records.</string>
  <string name="identomat_ssn_consent_agree">Agree</string>
  <string name="identomat_ssn_verification_header"> </string>
  <string name="identomat_ssn_title">Confirm your identity</string>
  <string name="identomat_ssn_subtitle">Enter your details exactly as they appear on your government-issued ID.</string>
  <string name="identomat_ssn_first_name_hint">First Name</string>
  <string name="identomat_ssn_last_name_hint">Last Name</string>
  <string name="identomat_ssn_dob_hint">Choose date</string>
  <string name="identomat_ssn_hint">000-00-0000</string>
  <string name="identomat_ssn_confirm_hint">000-00-0000</string>
  <string name="identomat_ssn_mismatch_error">The numbers you entered don\'t match. Please try again.</string>
  <string name="identomat_ssn_api_error">An error occurred. Please try again.</string>
  <string name="identomat_ssn_verify">Verify</string>
  <string name="identomat_ssn_consent_declined_title">Verification Declined</string>
  <string name="identomat_ssn_consent_declined_description">SSN consent was declined. This verification session has ended.</string>
  <string name="identomat_ssn_mismatch_title">Verification Failed</string>
  <string name="identomat_ssn_mismatch_description">Your information did not match SSA records. This session has ended.</string>
  <string name="identomat_ssn_deceased_title">Verification Failed</string>
  <string name="identomat_ssn_deceased_description">We Couldn\'t validate your SSN</string>

  <string name="identomat_ssn_confirm_identity_title">Confirm your identity</string>
  <string name="identomat_ssn_confirm_identity_subtitle">Enter your details exactly as they appear on your government-issued ID.</string>
  <string name="identomat_ssn_first_name_label">First name</string>
  <string name="identomat_ssn_middle_name_label">First name (optional)</string>
  <string name="identomat_ssn_middle_name_hint">Middle name</string>
  <string name="identomat_ssn_last_name_label">Last name</string>
  <string name="identomat_ssn_dob_label">Date of birth</string>
  <string name="identomat_ssn_choose_date">Choose date</string>
  <string name="identomat_ssn_section_title">Enter your Social Security Number</string>
  <string name="identomat_ssn_section_subtitle">Provide your 9-digit SSN for identity verification. Your number is used solely to confirm your identity and is not stored on our servers.</string>
  <string name="identomat_ssn_number_label">Social Security Number</string>
  <string name="identomat_ssn_confirm_number_label">Confirm Social Security Number</string>
  <string name="identomat_ssn_mismatch_detail_error">The numbers you entered don\'t match. Please try again.</string>
  <string name="identomat_ssn_encrypted_title">Your data is encrypted</string>
  <string name="identomat_ssn_encrypted_message">Your information is encrypted in transit using 256-bit SSL and sent directly to the SSA. We do not store your full SSN.</string>
  <string name="identomat_ssn_consent_disclosure_title">One-time disclosure consent</string>
  <string name="identomat_ssn_consent_disclosure_body">This consent is for a one-time disclosure and is valid for 90 days from the date of signature.</string>
  <string name="identomat_ssn_success_title">Verification successful</string>
  <string name="identomat_ssn_success_description">Your SSN has been validated</string>
  
</resources>
```

### 4. Встановлення користувацького логотипу

`setLogo(() -> View?)` Ця функція використовується для встановлення користувацького логотипу в бібліотеці. Ви можете передати власний користувацький view та відображати на ньому будь-що (анімації, зображення тощо). Цей логотип відображатиметься, коли бібліотека щось обробляє.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.identomat.com/identomat-documentation-ukr/sdks/android-sdk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.