Правила и ограничения¶

В этой статье описаны правила и ограничения, которые касаются как любого вида идентификации (общие), так и каждого в отдельности.

Общие правила¶

productId

Атрибут, который описывает продукт партнёра и его настройки в сервисе идентификации. Для получения productId обратитесь к вашему курирующему менеджеру.

personId

В системе партнёра должен быть создан постоянный внутренний идентификатор клиента — personId. В personId допустимы только буквы латинского алфавита, цифры и дефис — то же, что в стандартном GUID.

bankId

Один и тот же клиент может быть идентифицирован в разных банках, следовательно, для одного personId в сервисе идентификации может быть создано несколько записей о его текущем уровне в определённом банке.

flowchart LR

    C["Иванов Иван Иванович 4606 222144"]

    subgraph Identification Service
    subgraph bankId1[bankId 1]
    prId1["personId 1 SIMPLIFIED"]
    end
    subgraph bankId2[bankId 2]
    prId2["personId 1 FULL"]
    end
    end

    C --> prId1
    C --> prId2

Контроль количества учётных записей

Один и тот же клиент может:

• пользоваться сразу несколькими продуктами: продуктом партнёра, продуктом QIWI и т.д.;
• иметь в рамках продукта несколько аккаунтов — учётных записей.

Каждой учётной записи клиента соответствует свой personId и уровень в сервисе идентификации.

Клиент может иметь не более двух записей, которым присвоен любой из следующих уровней:

• SIMPLIFIED;
• FULL.

Такое ограничение действует для связки:

• bankId;
• productId.

Т.е. при проверке ограничения считается количество всех записей, для которых установлены одинаковые bankId, productId и один из вышеупомянутых уровней.

Передача файлов

Identification API не поддерживает передачу файлов, только текст — обработку загружаемых документов партнёр производит самостоятельно.

Обработка ответов

При обработке ответов необходимо обращать внимание на:

• cтатус заявки;
• код причины;
• http-статус ответа и код ошибки.

Шифрование

Запросы, в которых передаются персональные данные клиента, необходимо шифровать.

Персональные данные

Identification API возвращает персональные данные клиента в маскированном виде. Если по какой-то причине вам нужны немаскированные данные, обратитесь к вашему курирующему менеджеру.

Упрощённая онлайн-идентификация¶

• Идентификация доступна только для граждан РФ.
• Идентификация считается успешно пройденной лишь в том случае, когда заявка на её создание находится в статусе PROCESSING_FINISHED, а её атрибут identificationLevel имеет значение SIMPLIFIED. С описанием статусов можно ознакомиться в документации Identification API.
• Для одного personId в каждый момент времени допускается только одна активная (в статусе IN_PROGRESS) заявка.

Полная идентификация¶

Очная идентификация в офисе

• В офисе клиент должен указать номер телефона, который заранее известен партнёру. В ином случае партнёр не сможет предоставить клиенту возможность подтвердить (завершить) идентификацию в интерфейсе.
• SMS-сообщение с результатом обработки заявки по умолчанию имеет определённые шаблоны для позитивного и негативного сценариев. Для получения актуальных шаблонов и изменения текста сообщения обратитесь к вашему курирующему менеджеру.

Подтверждение идентификации в интерфейсе

• При поиске заявки партнёр должен передать тот же номер телефона, который клиент указал при прохождении очной идентификации. В ином случае партнёр не сможет найти заявку для завершения идентификации. Следует заранее убедиться, что клиент укажет номер, известный партнёру.
• Партнёру разрешается показать клиенту лишь некоторые данные из заявки: фамилию в маскированном виде, имя и сведения о точке идентификации.
• Если для одного клиента найдено несколько заявок, ожидающих подтверждения, можно:
  • отобразить все найденные заявки и предоставить выбор клиенту;
  • выбрать заявку самостоятельно, ориентируясь на дату её создания, сведения о точке идентификации, текущий и максимально допустимый уровни идентификации.
• На подтверждение паспорта и SIM-карты клиенту даётся 3 попытки. Количество неуспешных попыток не кастомизируется.
• Запросы, связанные с подтверждением SIM-карты, совершаются в рамках одной сессии. Идентификатор сессии (confirmationSessionId) может содержать только буквы латинского алфавита, цифры, и дефис — то же, что стандартный GUID.
• SMS-сообщение с OTP по умолчанию имеет определённый шаблон. Для получения актуального шаблона и изменения текста сообщения обратитесь к вашему курирующему менеджеру.