# FAQ

# Типы файлов и время хранения

# Какие типы файлов вы принимаете? Есть ли ограничения по размеру файлов?

Медиа-тип	Форматы файлов
`image/jpeg`	`.jpeg`, `.jpg`
`image/png`	`.png`
`application/pdf`	`.pdf`
`video/mp4`	`.mp4`
`video/webm`	`.webm`
`video/quicktime`	`.mov`

Максимальный размер файла – 50 Мб. Вы можете задать минимальные и максимальные значения для размеров файлов в разделе «Интеграция SDK».

# Как долго вы храните документы?

У нас нет ограничений по времени хранения файлов.

# Проблемы с API

# Я получаю ошибку `405 Method not allowed`.

Убедитесь, что вы используете правильный HTTP-метод. Например, вы не используете GET там, где нужно использовать POST. Также, как правило, следует указывать HTTP-заголовок -H Accept:application/json, если только вы не получаете двоичный файл, например, изображения или PDF-файлы. Подробнее в разделе API-интеграция.

# Я получаю ошибку `415 Unsupported media type`.

Убедитесь, что вы используете HTTP-заголовки, которые соответствуют типу данных ответа. В большинстве случаев это заголовок -H Accept:application/json, а если вы делаете POST-запрос, то укажите заголовки -H Content-Type:application/json или -H Content-Type:multipart/form-data. Подробнее в разделе API-интеграция.

# Я получаю код ошибки `401`

Убедитесь, что все заголовки авторизации были предоставлены в соответствии с документацией:

appToken был создан и использовался в одном и том же окружении (Тестовом или Основном);
зашифрованная подпись запроса содержит тело запроса;
временная метка совпадает с UTC в секундах, а не мс.

# Тестирование в Tестовом окружении (Sandbox)

# Почему анкета пользователя долго находится в статусе `pending` в Тестовом окружении (Sandbox)?

Тестовое окружение (Sandbox) нужно только для того, чтобы проверить интеграцию. Тестовое окружение не осуществляет автоматическую проверку пользователя, если вам нужно изменить статус пользователя, сделайте это самостоятельно. Подробнее в разделе API-запросы.

# Функциональность SDK

# Какие языки поддерживает SDK?

Мы поддерживаем и автоматически обновляем этот список языков.

Вы можете указать любой код ISO 639-1 при инициализации SDK, если у нас нет такого языка, то автоматически произойдет переход на английский язык (en).

# Могу ли я изменить цвета и тексты на экранах SDK?

Вы можете использовать собственные настройки CSS для SDK, задав их в настройках уровня проверки или отправив в качестве параметра .uiConf.customCss/.uiConf.customCssStr при инициализации.

Все тексты SDK можно изменить прямо в Дешборде в разделе «Интеграция SDK» вкладке «Переводы SDK».

# Получение доступа к Основному окружению (Production)

# Как мы можем получить доступ к Основному окружению (Production)?

Прежде чем предоставить вам доступ к Основному окружению (Production), мы хотели бы протестировать интеграцию и пройти верификацию от лица вашего конечного пользователя. Для этого мы просим вас предоставить нам ссылку на ваш сервер/платформу/приложение.

Убедитесь, что:

интеграция в Тестовом окружении (Sandbox) завершена, работает и соответствует вашим требованиям;
в консоли разработчика нет ошибок или предупреждений;
вы сохранили наши applicantId в своей базе данных и установили совпадение с пользователями;
вы получили и успешно обработали тестовые вебхуки с нашей стороны;
вы знаете, как соотнести результаты, полученные в полезной нагрузке вебхука, с вашими пользователями.

Внимание:

Мы можем отправить несколько финальных вебхуков, поэтому будьте готовы к тому, что статус пользователя будет изменен и на вашей стороне. Типичным примером является ситуация, когда пользователь был одобрен, но позже он был признан мошенником, и поэтому мы блокируем его вторым финальным вебхуком RED.

# Как успешно перейти в Основное окружение (Production)?

По возможности, предоставьте нам информацию о предполагаемом количестве входящих пользователей в час/день/месяц.

Настройки не будут перенесены из Тестового окружения (Sandbox) в Основное окружение (Production) автоматически. Поэтому не забудьте:

задать вебхуки в «Панели разработчика» вкладке «Вебхуки» Основного окружения (Production);
задайте настройки на вкладке «Глобальные настройки» Дешборда;
создайте и используйте токен appToken и секретный ключ для авторизации API в Основном окружении (Production).

# Результаты верификации

# Почему ваш сервис поддерживает только асинхронный метод?

Мы предоставляем только асинхронный метод, чтобы гарантировать высокий уровень качества обслуживания. Некоторые сторонние базы данных могут зависать, и поэтому получение результата может занять больше времени. К тому же, в сложных ситуациях, проверку может осуществить наш сотрудник, чтобы вы получили максимально точный результат, благодаря чему, независимо от внешних обстоятельств, мы можем гарантировать вам наилучший ответ в кротчайший срок.

# Почему нам нужно создавать эндпоинт для получения вебхуков от вашего сервиса?

Ваш сервис должен принимать вебхуки от нашего сервиса, чтобы автоматически получать информацию о результатах проверки пользователя и изменять статус верификации в режиме реального времени. Если вы считаете, что результат верификации не был получен вашим сервисом, вы можете в любое время запросить статус пользователя. Подробнее в разделе Начало работы.

# Где искать результат проверки при получении вебхука?

Он находится в поле reviewResult.reviewAnswer. Поддерживаемые значения:

GREEN — пользователь прошел верификацию;
RED — пользователь не прошел верификацию, но в большинстве случаев он может исправить проблему, загрузив новые документы.

# Как я могу получить результат распознавания документов пользователя?

После завершения верификации мы отправим вебхук на ваш эндпоинт. Если в поле reviewAnswer значение GREEN, то вы можете получить результат распознавания документов пользователя. Подробнее в разделе API-интеграция.

# Как я могу получить результат проверки документов?

После завершения верификации мы отправим вам вебхук на ваш эндпоинт. Затем вы сможете запросить результаты верификации каждого документа. Подробнее в разделе API-интеграция.

# В каком формате приходят результаты распознавания документов?

Разные типы документов имеют разные наборы полей. Вы можете узнать результаты с помощью этого запроса после завершения верификации.

# Пример:

"idDocs": [
            {
              "idDocType": "PASSPORT",
              "country": "ALB",
              "firstName": "JOHN",
              "firstNameEn": "JOHN",
              "lastName": "DOE",
              "lastNameEn": "DOE",
              "issuedDate": "2019-06-05",
              "validUntil": "2020-08-08",
              "number": "87988779P",
              "dob": "1990-01-01"
            },
            {
              "idDocType": "ID_CARD",
              "country": "GBR",
              "firstName": "JOHN",
              "firstNameEn": "JOHN",
              "lastName": "DOE",
              "lastNameEn": "DOE",
              "issuedDate": "2018-06-05",
              "validUntil": "2021-08-08",
              "number": "87988779ID",
              "dob": "1990-01-01"
            },
            {
              "idDocType": "DRIVERS",
              "country": "GBR",
              "firstName": "JOHN",
              "firstNameEn": "JOHN",
              "lastName": "DOE",
              "lastNameEn": "DOE",
              "issuedDate": "2015-09-09",
              "validUntil": "2021-08-08",
              "firstIssuedDate": "2010-09-09",
              "number": "87988779DR",
              "dob": "1990-01-01"
            },
            {
              "idDocType": "UTILITY_BILL",
              "country": "GBR",
              "firstName": "JOHN",
              "firstNameEn": "JOHN",
              "lastName": "DOE",
              "lastNameEn": "DOE",
              "issuedDate": "2019-10-15",
              "address": {
                "subStreet": "15A APT 9",
                "subStreetEn": "15A APT 9",
                "street": "GENERIC STREET",
                "streetEn": "GENERIC STREET",
                "state": "STATE",
                "stateEn": "STATE",
                "town": "GENCITY",
                "townEn": "GENCITY",
                "postCode": "987",
                "country": "GBR"
              }
            },
            {
              "idDocType": "RESIDENCE_PERMIT",
              "country": "GBR",
              "firstName": "JOHN",
              "firstNameEn": "JOHN",
              "lastName": "DOE",
              "lastNameEn": "DOE",
              "issuedDate": "2015-08-08",
              "validUntil": "2020-08-08",
              "number": "87988779RP",
              "dob": "1990-01-01"
            }
          ]

# Как уведомить пользователей о результатах верификации?

После завершения верификации мы можем отправить пользователю письмо с результатами. Письмо содержит результат верификации и ссылку, нажав на которую пользователь может повторно загрузить документы, если верификация была завершена неудачно. Чтобы рассылка писем осуществлялась с нашей стороны, необходимо выбрать нужные причины в выпадающем списке «Уведомления по эл. почте» в настройках уровня проверки. В настройках брендинга: вы можете изменить логотип компании, перенаправляющую ссылку, а тексты писем можно изменить на вкладке «Электронные письма» раздела «Переводы SDK».

# Прочее

# Я не получаю электронных писем от IDnGO.

Если вы используете функцию брендирования и установили свою почту в качестве отправителя, убедитесь, что SPF-запись была обработана по инструкции.

Также проверьте, не блокирует ли ваша сторона письма с домена cyberity.ru.

# Что, если у меня есть еще вопросы, на которые я не могу найти ответы?

Свяжитесь с нами по электронной почте или в Telegram. Мы будем рады помочь!