Рекомендации по использованию API¶
В разделе собраны рекомендации для снижения количества повторных верификаций паспортных данных пользователя.
Ограничения ввода информации в поля формы:¶
Имя (name). Строковое значение до 30 символов, допустимые символы «А-Я», «а-я», «-» и пробел. Отчество (patronymic). Строковое значение до 30 символов, допустимые символы «А-Я», «а-я», «-» и пробел.
Фамилия (surname). Строковое значение до 30 символов, допустимые символы «А-Я», «а-я», «-» и пробел. Дата рождения (birthdate). Строковое значение до 10 символов. Формат ДД.ММ.ГГГГ Рекомендуем сделать маску для ввода даты.
ИНН (inn). В данном поле должны присутствовать только цифры в количестве 12 символов, может начинаться с цифры «0». Перед отправкой рекомендуем проверять введенные данные по алгоритму проверки ИНН 12 знаков.
Серия паспорта (series). В поле должны быть введены только цифры в количестве 4 шт.
Номер паспорта (number). В поле должны быть введены только цифры в количестве 6 шт.
Дата выдачи паспорта (issueDate). Строковое значение до 10 символов. Формат ДД.ММ.ГГГГ Рекомендуем сделать маску для ввода даты.
Кем выдан паспорт (issuedWhom). Строковое значение до 256 символов.
Адрес регистрации (registrationAddress). Строковое значение до 256 символов.
Прикрепляемы изображения. Изображения должны иметь один из форматов .png, .jpeg, .jpg, .gif, .pdf, .webp, .heic, размер не более 10 мб. Минимум одно изображение, если пользователь объединит на одном две страницы из паспорта или сделает pdf-документ, максимум – два изображения.
Подсказки для ввода информации:¶
«Данные (Имя, Отчество, Фамилия, Дата рождения, Серия паспорта, Номер паспорта, Дата выдачи паспорта, Кем выдан паспорт, Адрес регистрации (прописка)) необходимо вводить такие же, как указаны у Вас в паспорте. Буквы Е и Ё – являются разными.»
«ИНН можете уточнить на сайте или в приложении гос.услуг в разделе Документы -> Личные документы.»
«Если у Вас отсутствует адрес регистрации, в поле «Адрес регистрации» заполните последние данные из паспорта.»
«Для подтверждения данных прикрепите изображение главной страницы паспорта и страницы с текущим адресом регистрации.»
«Изображения паспорта можно прислать в виде скана в формате pdf или фотографии. Убедитесь, что края паспорта вмещаются на изображении, и вся информация хорошо читаема: отсутствуют блики, пальцы не закрывают данные, изображение не слишком далеко и не размыто.»
Обработка ошибок¶
| Ошибка | Сообщение для пользователя |
|---|---|
| INVALID_FIELDS. "The fields are uncorrected:{name}, {surname}, ..." | Верификация паспортных данных не пройдена. Некорректно указаны данные: {имя}, {отчество}, {фамилия} … Заполните данные также, как указаны в паспорте, и отправьте на повторную верификацию. |
| Denied. The second page is missing.Отказано. Отсутствует вторая страница. | Верификация паспортных данных не пройдена. Отсутствует страница с адресом регистрации или главная страница паспорта. Заполните данные, прикрепите главную страницу паспорта и страницу с текущим адресом регистрации. Отправьте на повторную верификацию. |
| Denied. The data does not match the image: {name} {patronymic}, {surname}, {birthdate}, {inn}, {series}, {number}, {issueDate}, {issuedWhom}, {registrationAddress} Отказано. Данные не совпадают с изображением: (перечислены, в которых информация заполнена некорректно). | Верификация паспортных данных не пройдена. Некорректно указаны данные: {имя}, {отчество}, {фамилия} … Заполните данные также, как указаны в паспорте, и отправьте на повторную верификацию |
| Denied. INN not found Отказано. ИНН не найден в налоговой | Верификация паспортных данных не пройдена. Ваш ИНН не найден в налоговой. Заполните повторно данные. В одном файле прикрепите изображения главной страницы паспорта и страницы с адресом регистрации, во втором файле прикрепите изображение бумажной версии ИНН или скрин с сайта гос.услуг (раздел Документы -> Личные документы), чтобы видна была информация о паспортных данных и ИНН. Отправьте данные на повторную верификацию. Либо обратитесь в поддержку для консультации. |