Перейти к содержанию

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

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

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

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 и уровень в сервисе идентификации.

Пример

В сервисе идентификации есть записи:

identifyingDocument personId productId identificationLevel
4606222144 person1 partnerProduct SIMPLIFIED
4606222144 person2 qiwiWalletProduct FULL

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

  • SIMPLIFIED;
  • FULL.

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

  • bankId;
  • productId.

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

Пример

В сервисе идентификации есть записи:

identifyingDocument personId bankId productId identificationLevel
4606222144 person1 qiwiBank partnerProduct1 SIMPLIFIED
4606222144 person2 qiwiBank partnerProduct1 FULL

Успешная попытка идентификации

  1. Клиент:

    • предоставляет персональные данные, которые совпадают с данными, присвоенными person1 и person2 в сервисе идентификации;
    • пытается пройти упрощённую или полную идентификацию
      • в банке, которому присвоен идентификатор qiwiBank в сервисе идентификации;
      • в рамках продукта, которому присвоен идентификатор partnerProduct2 в сервисе идентификации.
  2. Сервис идентифицирует клиента, появляется дополнительная запись.

identifyingDocument personId bankId productId identificationLevel
4606222144 person1 qiwiBank partnerProduct1 SIMPLIFIED
4606222144 person2 qiwiBank partnerProduct1 FULL
4606222144 person3 qiwiBank partnerProduct2 SIMPLIFIED

Неуспешная попытка идентификации

  1. Клиент:

    • предоставляет персональные данные, которые совпадают с данными, присвоенными person1 и person2 в сервисе идентификации;
    • пытается пройти идентификацию
      • в банке, которому присвоен идентификатор qiwiBank в сервисе идентификации;
      • в рамках продукта, которому присвоен идентификатор partnerProduct1 в сервисе идентификации.
  2. Сервис возвращает ошибку, попытка идентификации неуспешна.

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

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

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

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

Шифрование

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

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

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

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

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

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

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

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

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

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