API электронной подписи: подписание документов после KYC

​

Уровни подписей

​

Как это работает

​

Перед началом работы

• Верификация личности должна быть одобрена и содержать читаемое имя. Без этого шаг фиксирует SIGNATURE_IDENTITY_NOT_VERIFIED.
• Проверка электронной почты, если код отправляется по электронной почте (по умолчанию), или Проверка телефона, если код отправляется по SMS. Код отправляется только на контакт, подтверждённый в той же сессии.
• Если в сценарии также есть Проверка живости, она должна быть одобрена.

​

Документы

​

Откуда берутся документы

​

Поддерживаемые файлы

​

Поля на документе

{
  "id": "6a2f1c0e-4d8b-4f5e-9a51-0c7b2e9d3f10",
  "key": "occupation",
  "type": "text",
  "role": "verified_person",
  "page": 1,
  "x": 0.34,
  "y": 0.4618,
  "width": 0.57,
  "height": 0.0325,
  "required": true,
  "label": "Occupation",
  "placeholder": "For example, nurse",
  "position": 5,
  "validation": { "kind": "any", "min_length": 0, "max_length": 80, "pattern": null, "message": null },
  "prefill": null,
  "editable_when_prefilled": false,
  "checked_by_default": false,
  "date_format": null
}

​

Валидация

{ "kind": "any", "min_length": 0, "max_length": 80, "pattern": null, "message": null }

• kind: any; letters (буквы в любой системе письма, пробелы, дефисы и апострофы); number (цифры с необязательным десятичным разделителем); email или pattern.
• min_length: от 0 до max_length.
• max_length: от 1 до 500. По умолчанию 120.
• pattern: обязательно при kind: "pattern". Регулярное выражение длиной до 200 символов, которому должно соответствовать значение целиком. Упреждающие и ретроспективные проверки и обратные ссылки не поддерживаются.
• message: до 120 символов, отображается вместо стандартной ошибки.

​

Предзаполненные значения

​

Настройка в консоли

1. Перейдите в раздел Рабочие процессы, откройте сценарий и добавьте шаг Электронная подпись после шагов, проверяющих подписанта.
2. В разделе Документы нажмите Загрузить, чтобы добавить файлы PDF или Word, и перетащите их в том порядке, в котором их увидит подписант. Файлы Word конвертируются в PDF: проверьте сконвертированные страницы перед размещением полей. Кнопка Заменить заменяет файл документа с сохранением полей, кроме тех, что находились на страницах, отсутствующих в новом файле.
3. В блоке Разместите поля в документах выберите Открыть редактор. Перетащите поле из палитры на страницу или выберите его и кликните в нужном месте, затем переместите и измените размер. Для каждого поля укажите Кто заполняет, его метку, обязательно ли оно (Обязательно), какие значения принимает, откуда берётся его значение и его API-ключ (key поля). Предпросмотр для подписанта показывает документ так, как его видит подписант на телефоне или компьютере. Редактор сохраняет изменения автоматически (Сохранено в черновик) и показывает список того, что нужно исправить, перед нажатием кнопки Готово.
4. В разделе Документы выберите источник документов: Этот рабочий процесс, Каждый сеанс или И то и другое. Для документов без полей укажите, должен ли подписант Прочитать до конца перед подписанием и дать Отдельное согласие для каждого документа.
5. В разделе Подпись выберите Подписант, Уровень (Простой по умолчанию или Усовершенствованная (AES); Квалифицированная (QES) отображается со статусом Скоро), Формат и способ отправки кода (Одноразовый код через).
6. В разделе Правила настройте, как каждое предупреждение влияет на решение.
7. В разделе Дополнительно выберите, нужно ли Отправить подписанную копию по электронной почте и Добавить страницу доказательств, а также сколько дней ссылка на подписание остаётся действительной. Вы также можете настроить пользовательские правила статусов.
8. Сохраните сценарий.

​

Процесс подписания

1. Введение. Подписант видит документы, которые ему предстоит подписать.
2. Каждый документ по порядку. Если в документе есть поля, подписант проходит по ним в порядке position. Первое поле подписи или инициалов открывает панель, где он принимает подпись. Необязательные поля отмечены как Необязательно. Значения, предварительно заполненные Didit, отображаются на странице с иконкой замка и не являются шагами ввода. Нажатие на поле на странице перемещает к нему. На телефоне отображается по одному полю за раз в панели, которая фиксируется над клавиатурой. На экранах шириной от 1200 px страница отображается рядом со списком полей. Если подписант пытается завершить работу с документом, оставив обязательное поле пустым, отображается количество оставшихся полей и происходит переход к первому из них. Документ без полей просто прочитывается и согласуется в соответствии с вашей конфигурацией.
3. Проверка. Подписант снова просматривает документы и, если в каком-либо из них есть поля, соглашается подписать их в электронном виде.
4. Код (только для Advanced (AES)). Подписант запрашивает код. Код действует 5 минут, новый код можно отправить через 60 секунд, а всего подписанту доступно до 5 кодов и 3 неверные попытки. После исчерпания лимита фиксируется SIGNATURE_OTP_FAILED. На уровне Simple код отсутствует: подписант переходит сразу от проверки к подписанию.
5. Подписано. После подписания подписант может скачать подписанные документы. Если вы включили эту опцию, Didit также отправит ему копию по электронной почте.
6. Отклонение. Подписант может отказаться от подписания вместо того, чтобы подписать документы. В этом случае фиксируется SIGNATURE_DECLINED. Отклонённое подписание можно возобновить, пока действительна ссылка на подписание, поэтому подписант всё ещё может подписать документ, если передумает.

​

Выбор подписи

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

​

Результаты

​

Цены

​

Удаление данных подписи

• Подписанные документы Верификации бизнеса (KYB) относятся к сессии компании. При удалении этой сессии удаляются и они.
• При удалении документа из сценария удаляется сам документ, его поля и исходный файл Word. Подписант, который уже начал процесс подписания, сохраняет показанную ему копию в рамках своей сессии до тех пор, пока вы не удалите эту сессию. Удаляйте документы только из тех сценариев, в которых нет сессий, ожидающих подписания.
• Копия, которую Didit уже отправил подписанту по электронной почте, находится в его почтовом ящике и не затрагивается удалением.

​

См. также

• Отчёт об электронной подписи: signatures[], подписанный PDF, доказательный PDF и файлы для скачивания.
• Предупреждения электронной подписи: каждое предупреждение и правило, управляющее им.
• Создание сессии: передача документов, полей и значений полей для каждой сессии.
• Конфигурация функций сценария: все настройки шага.