Перейти к основному содержимому

Частые вопросы по MandarinID

Частые вопросы по MandarinID​

Немного про работу СМЭВ​

Банк обязуется по поручению организации (при наличии договора), проводить Упрощенную идентификацию клиента, через СМЭВ, в целях заключения с указанным клиентом договора потребительского кредита (займа), предоставляемого клиенту посредством перевода денежных средств в соответствии с законодательством о национальной платежной системе.

Нужно принимать во внимание, что СМЭВ является государственный информационной системой и не всегда доступен. Возможно как его полное отключение, так и частичное (например определенный регион).

По какому протоколу у вас СМЭВ?​

Протокол СМЭВ-4

Как определить доступность СМЭВ?​

Однозначного способа понять доступен СМЭВ или нет, к сожалению, нет, поскольку у них нет каких-либо обязательств по доступности, однако это можно выяснить по косвенным признакам:

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

Взимается ли оплата за запросы на идентификацию в тестовом режиме?​

В тестовом режиме оплата не взимается за отправку запросов.

Является ли поле personVerificationFinished финальным маркером, который обозначает что идентификация этого пользователя закончена?​

Да, personVerificationFinished обозначает что идентификация этого пользователя закончена, она может быть либо true, либо false.

Возможен ли кейс: personVerificationFinished: true; phoneVerificationFinished: false?​

Такой кейс возможен: personVerificationFinished: true; phoneVerificationFinished: false. В документации имеется описание. Если phoneVerificationFinished: false, значит на этапе подтверждения номера телефона был введен неверный код из смс.

Можно ли как-то оттестировать идентификацию без отправки смс-кода?​

Да, можно, в таком случае в запросе не нужно передавать поле phone.

В течение какого времени по id сессии можно получить результат идентификации?​

Срока у id сессии нет. (По id сессии можно получить результат идентификации даже через неделю/месяц/год)

Идентификация клиента и идентификация телефона это два разных независимых процесса или один?​

Это разные процедуры - "personVerified" (проверка персональных данных в СМЭВ) и "phoneVerified" (валидация номера).

На тестовом проекте невалидные данные паспортов будут выдавать успешную идентификацию?​

Общий принцип для тестовых запросов такой: если в ФИО вот такое (см. ниже), то это будет "personVerified":true. Любое другое ФИО будет false.

"firstName": "Шариков",
"lastName": "Полиграф",
"patronymic": "Полиграфович",

ВАЖНО! это не отменяет необходимость отправлять паспорт и другие данные, просто проверка идет по ФИО.

При подтверждении телефона код будет из всех нулей (реальное СМС не отправляется).

Для упрощённой идентификации можно ли поменять количество символов смс-кода при проверке номера телефона?​

Да, можем поменять на любое количество, для этого необходимо обратиться в нашу службу поддержки.

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

Система СМЭВ предоставляет результат проверки, как правило, в пределах 10 минут. Но время проверки может увеличиться по причинам, не зависящим от Mandarin. Максимальное регламентное время ответа на СМЭВ-запрос может составить до 5 рабочих дней, однако такие случаи бывают крайне редко.

Можно получить перечень проверок данных, который проводится Вашим сервисом, чтобы поставить такие же проверки и не пропускать некорректные данные? Пример: Проверка на кол-во цифр в снилс; Проверка на кол-во цифр в номере телефона; английская буква и тд.​

Валидации данных у нас нет. В каком виде получили запрос, так и передадим в СМЭВ - а они проверяют. После чего будет предоставлен ответ.

На текущий момент времени, клиент, проходящий УПРИД, получает СМС от "Mandarin" с текстом: Код для подтверждения: ...". Можно ли изменить имя отправителя в смс, при проверке телефона и отправке кода?​

Такой возможности нет. Это стандартный текст и нет возможности индивидуально его отредактировать.

Сколько времени есть у клиента на то, чтобы вести код из смс для проверки телефона?​

Код в смс бессрочный до тех пор, пока не отправлен новый код.

PersonVerified - false - что означает?​

Данный ответ означает, что данные клиента не верны. Какие конкретно данные не верны, СМЭВ не возвращает. Возможно ошибка в ФИО, данных паспорта или СНИЛС/ИНН. Либо данные паспорта и СНИЛ недействительны/не совпадают. Если все введено корректно, в таком случае клиенту нужно обратиться в ФМС с вопросом, почему данные паспорта не проходят проверку упрощённой идентификации.

Почему статус запроса в ожидании (Pending)?​

В редких случаях СМЭВ может отвечать с задержкой, по этой причине статус запроса может находиться длительное время в ожидании. Пример ответа на запрос проверки статуса в такой ситуации:

{
    "id": "e2c3c860-1d68-427c-a16d-9666e0ffb706",
    "phoneVerified": null,
    "phoneVerificationFinished": false,
    "personVerified": null,
    "personVerificationFinished": false,
    "personVerificationError": null,
    "inn": {
        "status": "NotProcessed",
        "description": "Не указан ИНН, проверка не производилась"
    },
    "snils": {
        "status": "Processing",
        "description": "В обработке"
    },
    "passport": {
        "status": "Valid",
        "description": "Сведения соответствуют"
    },
    "passportDeferred": null
}

Рекомендуем в таком случае проверять статус повторно в течение какого-то времени (в рамках вашего SLA).

GET https://secure.mandarinpay.com/api/personidentification/v2/{id}

Если длительное время не получен ответ, отправить запрос повторно на проверку.

POST https://secure.mandarinpay.com/api/v2/personidentification

Ошибки запросов MandarinID​

PersonIdentificationError: ESIA-000001 Внутренняя ошибка​

Внутренняя ошибка на стороне ЕСИА, СМЭВ. Можно повторить запрос.

PersonIdentificationError: Внутренняя ошибка сервера​

Данная ошибка уточняется для каждого запроса, т.к. может иметь различные значения, например:

  1. наблюдались проблемы на стороне СМЭВ, получили от них ошибку: connection time out;

  2. наблюдались проблемы на стороне провайдера услуги. Необходимо повторно отправить запрос повторно на проверку.

Ошибка СМЭВ(SAXException): Content is not allowed in​

Данная ошибка означает, что в этот промежуток времени наблюдались/наблюдаются неполадки на стороне СМЭВ. Запросы с ошибками необходимо повторить после восстановления.

"personVerificationError":"Ошибка СМЭВ. Обратитесь в службу технической поддержки."​

Данное описание ошибки говорит о том, что наблюдались проблемы на стороне СМЭВ. Необходимо повторить запрос.

{"status":"PROCESSING","errorStatusInfo":[{"code":"0","message":"java.net.ConnectException: Connection timed out: connect"}]}​

Данную ошибку возвращает СМЭВ, означает, что наблюдаются перебои на их стороне.

{"status":"PROCESSING","errorStatusInfo":[{"code":"0","message":"Код ответа: 500, сообщение: Internal service error"}]}​

При получении данной ошибки, требуется уточнение, чаще всего ошибку возвращает СМЭВ, означает, что наблюдаются перебои на их стороне, однако для полной уверенности, необходимо уточнение у провайдера.

PersonIdentificationError: Ошибка при выполнении запроса​

СМЭВ ошибкой ответил "status":"FAILED","errorStatusInfo":[{"code":"-1","message":"Ошибка при выполнении запроса". Сервис был недоступен на их стороне. При необходимости можно повторить запрос.

Содержание