--- title: Создание процесса description: Создание процесса верификации. Возвращает URL пути и токены SDK, которые передают пользователя на захват, размещённый на стороне Unico. canonical: https://developer.unico.io/ru/dual-api/developers/api-reference/web-sdk/post-process locale: ru generated_by: markdown-export --- - [/ru/](/ru/) - [Справочник API](/ru/dual-api/developers/api-reference/) - [Web и нативный](/ru/dual-api/developers/api-reference/web-sdk/) - Create Process **На этой странице# Создание процесса Это точка входа для каждой интеграции Web & SDK. Ваш бэкенд вызывает его для создания процесса; ваш фронтенд использует возвращённые токены для отображения iFrame, перенаправления пользователя или инициализации нативного SDK. Полный поток интеграции см. в [Обзор Web & SDK](/ru/dual-api/developers/api-reference/web-sdk/). ### Эндпоинт​ ОкружениеURL**Production**`POST https://api.idcloud.unico.app/client/v1/process`**Sandbox**`POST https://api.idcloud.uat.unico.app/client/v1/process` ### Запрос​ Заголовки ЗаголовокЗначение`Authorization``Bearer ` (см. [Аутентификация](/ru/dual-api/developers/api-reference/authentication))`Content-Type``application/json` Параметры тела запроса ПолеТипОбязательныйОписание`callbackUri`stringдаURL, на который пользователь перенаправляется после завершения пути. Используйте `/` для потоков нативного SDK, где обратный вызов обрабатывается внутри приложения.`flow`stringдаИдентификатор потока -- определяет, какие возможности выполняются. Примеры: `idunicodocs`, `idunicosign`, `idchecktrust`, `idtoken`, `idsmart`. См. [Доступные потоки](/ru/dual-api/capabilities/available-flows).`purpose`stringдаБизнес-назначение. Допустимые значения: `creditprocess`, `biometryonboarding`, `carpurchase`, `ageverification`.`person.duiType`enumнетТип документа. Допустимые значения: `DUI_TYPE_AR_PASSPORT`, `DUI_TYPE_AR_DNI`, `DUI_TYPE_AR_LNC`, `DUI_TYPE_AT_STNR`, `DUI_TYPE_BE_NN`, `DUI_TYPE_BR_CPF`, `DUI_TYPE_BR_PASSPORT`, `DUI_TYPE_BR_CNPJ`, `DUI_TYPE_CA_SIN`, `DUI_TYPE_CH_AHV`, `DUI_TYPE_CL_RUN`, `DUI_TYPE_CL_PASSPORT`, `DUI_TYPE_CL_LICENCIA_CONDUCIR`, `DUI_TYPE_CO_NIT`, `DUI_TYPE_CO_PASSPORT`, `DUI_TYPE_CO_LICENCIA_CONDUCCION`, `DUI_TYPE_CO_CC`, `DUI_TYPE_DE_IDNR`, `DUI_TYPE_DK_CPR`, `DUI_TYPE_EC_NI`, `DUI_TYPE_ES_NIE`, `DUI_TYPE_ES_DNI`, `DUI_TYPE_FI_HETU`, `DUI_TYPE_FR_SPI`, `DUI_TYPE_GB_NINO`, `DUI_TYPE_GT_CUI`, `DUI_TYPE_ID_NIK`, `DUI_TYPE_IE_PPSN`, `DUI_TYPE_IT_CF`, `DUI_TYPE_LU_MATRICULE`, `DUI_TYPE_MX_CURP`, `DUI_TYPE_MX_RFC_PERSONA_FISICA`, `DUI_TYPE_MX_LICENCIA_CONDUCIR`, `DUI_TYPE_NG_NIN`, `DUI_TYPE_NG_BVN`, `DUI_TYPE_NG_BVN_TOKEN`, `DUI_TYPE_NG_NIN_TOKEN`, `DUI_TYPE_NL_BSN`, `DUI_TYPE_NO_FNR`, `DUI_TYPE_PE_RUC`, `DUI_TYPE_PE_DNI`, `DUI_TYPE_PE_PASSPORT`, `DUI_TYPE_PL_PESEL`, `DUI_TYPE_PT_NIF`, `DUI_TYPE_SE_PNR`, `DUI_TYPE_SE_SAMORDNINGSNUMMER`, `DUI_TYPE_TR_TCKN`, `DUI_TYPE_US_SSN`, `DUI_TYPE_US_PASSPORT`, `DUI_TYPE_US_DRIVER_LICENSE`, `DUI_TYPE_US_PASSPORT_CARD`, `DUI_TYPE_US_POLYCARBONATE_PASSPORT`, `DUI_TYPE_US_ID_CARD`, `DUI_TYPE_UY_CI`, `DUI_TYPE_ZZ_EMAIL`, `DUI_TYPE_ZZ_PHONE_NUMBER`.`person.duiValue`stringнетНомер документа, без форматирования.`person.friendlyName`stringнетОтображаемое имя пользователя, показываемое в интерфейсе пути. Максимум 50 символов.`person.phone`stringнетНомер телефона в формате DDI + DDD + номер, без разделителей. Обязателен при отправке уведомлений по SMS или WhatsApp.`person.email`stringнетАдрес электронной почты. Обязателен для потоков с электронной подписью.`person.notifications`arrayнетКаналы уведомлений для отправки ссылки на путь. Каждый элемент содержит `notificationChannel`: `NOTIFICATION_CHANNEL_WHATSAPP`, `NOTIFICATION_CHANNEL_SMS` или `NOTIFICATION_CHANNEL_EMAIL`.`bioTokenId`string (UUID)условно**Устарело.** Используйте `references` вместо этого. ID ссылочного биометрического процесса. Обязателен для потоков Валидации 1:1 (`idtoken`, `idtokentrust`, `idtokensign`) и Умной ревалидации (`idsmart`).`references`arrayусловноВходные данные для потоков Валидации 1:1 и Умной ревалидации, заменяющие `bioTokenId`. Каждый элемент содержит `referenceType` (`REFERENCE_TYPE_IMAGE_BASE64` или `REFERENCE_TYPE_PROCESS_ID`) и `referenceContent` (base64-изображение или UUID процесса).`useCase`stringусловноСценарий Умной ревалидации. Обязателен для `idsmart`. Примеры: `USE_CASE_LOGIN`, `USE_CASE_IDENTITY_REVALIDATION_7_DAYS`, `USE_CASE_FIN_TRANSACTIONS`.`clientReference`stringусловноУникальный идентификатор пользователя в вашей системе. **Обязателен для возможности [Мультиаккаунт](/ru/capabilities/multi-accounts).** Уникален в вашей базе, максимум 256 символов, без пробелов.`companyBranchId`string (UUID)нетID филиала. Обязателен только если у сервисного аккаунта более одного связанного филиала.`expiresIn`stringнетОкно действия процесса с момента создания. Формат: `"3600s"`. По умолчанию 7 дней, если не указано.`flow_config`objectнетПереопределения конфигурации для каждого потока.`flow_config.biometry_capture.enabled_back_camera`booleanнетИспользовать заднюю камеру устройства. Несовместимо с потоками захвата документов или электронной подписи.`contextualization`objectнетКонтекст транзакции, показываемый пользователю во время пути для объяснения захвата.`contextualization.company_name`stringнетНазвание компании, отображаемое во время пути. Максимум 20 символов.`contextualization.currency`stringнетКод валюты, отображаемый пользователю. Допустимые значения: `BRL`, `MXN`, `USD`.`contextualization.price`numberнетСумма транзакции, отображаемая пользователю.`contextualization.locale`objectнетЛокализованный текст, отображаемый во время пути. Ключи: `ptBr`, `enUs`, `esMx`.`contextualization.locale.{ptBr|enUs|esMx}.reason`stringнетКраткая причина захвата, отображаемая во время пути. Максимум 50 символов.`contextualization.locale.{ptBr|enUs|esMx}.title`stringнетЗаголовок уведомления для клиента, отображаемый во время пути. Максимум 100 символов. Должен указываться вместе с `text`. HTML-теги удаляются.`contextualization.locale.{ptBr|enUs|esMx}.text`stringнетТекст уведомления для клиента, отображаемый во время пути. Максимум 210 символов. Должен указываться вместе с `title`. HTML-теги удаляются. ### Пример​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "callbackUri": "https://app.client.com/callback", "flow": "idunicodocs", "purpose": "biometryonboarding", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909", "friendlyName": "Luke Skywalker", "phone": "5511912345678", "email": "luke@example.com" } }' ``` ``` import fetch from 'node-fetch';const res = await fetch('https://api.idcloud.unico.app/client/v1/process', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ callbackUri: 'https://app.client.com/callback', flow: 'idunicodocs', purpose: 'biometryonboarding', person: { duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678909', friendlyName: 'Luke Skywalker', phone: '5511912345678', email: 'luke@example.com' } })});const { process: proc } = await res.json();// proc.userRedirectUrl, proc.token, proc.webAppToken ``` ### Ответы​ 200 OK ``` { "process": { "id": "53060f52-f146-4c12-a234-5bb5031f6f5b", "state": "PROCESS_STATE_CREATED", "flow": "idunicosign", "purpose": "biometryonboarding", "callbackUri": "https://app.client.com/callback", "clientReference": "your-internal-id-123", "companyBranchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "userRedirectUrl": "https://cadastro.unico.app/process/53060f52-f146-4c12-a234-5bb5031f6f5b", "token": "eyJhbGciOiJSUzI1NiIs...", "webAppToken": "eyJhbGciOiJSUzI1NiIs...", "createdAt": "2023-10-09T09:15:25.417105Z", "expiresAt": "2023-10-09T16:15:25.417105Z", "capacities": [], "authenticationInfo": {}, "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909", "friendlyName": "Luke Skywalker", "phone": "5511912345678", "email": "luke@example.com", "notifications": [] }, "companyData": { "branchId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "countryCode": "BR" } }} ``` ПолеТипОписание`process.id`string (UUID)Идентификатор процесса. Используйте его для получения результата через [Получение процесса](/ru/dual-api/developers/api-reference/web-sdk/get-process).`process.state`enum`PROCESS_STATE_CREATED` -- процесс создан, путь ещё не начат. `PROCESS_STATE_FAILED` -- создание процесса не удалось.`process.flow`stringИдентификатор потока, отправленный при создании.`process.purpose`stringБизнес-назначение, отправленное при создании.`process.callbackUri`stringURI обратного вызова, отправленный при создании.`process.clientReference`stringВаш внутренний идентификатор, отправленный при создании. Присутствует только если указан в запросе.`process.companyBranchId`string (UUID)ID филиала. Присутствует только если указан в запросе.`process.userRedirectUrl`stringURL для перенаправления пользователя (интеграции Web Redirect и iFrame). Не изменяйте этот URL.`process.token`stringJWT для инициализации **Web SDK iFrame**.`process.webAppToken`stringJWT для инициализации **нативных SDK** (Android, iOS, Flutter).`process.createdAt`string (date-time)Временная метка создания процесса.`process.expiresAt`string (date-time)Временная метка, после которой процесс истекает и не может быть завершён.`process.capacities`arrayВозможности, настроенные для данного процесса.`process.authenticationInfo`objectИнформация об аутентификации для процесса (пустая при создании).`process.person`objectЭхо объекта `person`, отправленного при создании.`process.companyData.branchId`string (UUID)ID филиала, связанного с процессом.`process.companyData.countryCode`stringКод страны, связанный с филиалом (например, `BR`, `MX`). ### Коды ошибок​ 400 Bad Request401 Unauthorized429 Too Many Requests500 Internal Server ErrorКодСообщениеОписание`3`invalid flowКогда указанный поток не существует.`3`invalid person: friendly name exceeds 50 characters.Когда отображаемое имя превышает 50 символов.`3`invalid purposeКогда указанное назначение недействительно.`3`invalid callbackUri: unable to parse callbackUri: parse "": empty url, invalid callbackUri: url:Когда указанный callbackUri недействителен.`3`invalid person: email required for notification channel NOTIFICATION_CHANNEL_EMAIL, invalid email address for notification channel NOTIFICATION_CHANNEL_EMAILКогда указанный email недействителен и настроено уведомление по email.`3`invalid person: phone number required for notification channel NOTIFICATION_CHANNEL_WHATSAPP, phone number does not contain 13 chars for notification channel NOTIFICATION_CHANNEL_WHATSAPPКогда указанный номер телефона недействителен и настроено уведомление по SMS или WhatsApp.`3`idnsv2/GetPublicID request error: rpc error: code = InvalidArgument desc = invalid dui valueКогда указанный идентификатор (duiValue) недействителен.`3`invalid expiresIn argumentКогда значение `expiresIn` недействительно.`3`invalid company_name argument in process contextualization, max length is 20Когда значение `contextualization.company_name` превышает 20 символов.`3`title and text must be provided together in process contextsКогда указано только одно из полей `title` или `text` в локали.`3`invalid title argument in process contexts, max length is 100Когда значение `title` в локали превышает 100 символов.`3`invalid text argument in process contexts, max length is 210Когда значение `text` в локали превышает 210 символов.`3`invalid reason argument in process contexts, max length is 50Когда значение `reason` в локали превышает 50 символов.`9`XX ID Apikeys are not setКогда API-ключ не настроен должным образом.Bearer-токен отсутствует, истёк или недействителен. См. [Аутентификация](/ru/dual-api/developers/api-reference/authentication).СообщениеОписаниеJwt header is an invalid JSONКогда используемый access-token содержит некорректные символы.Jwt is expiredКогда используемый access-token истёк.Достигнут лимит запросов. Когда ваша система получает ошибку HTTP 429, необходимо реализовать механизмы для предотвращения каскадных сбоев и ухудшения ограничения.**Лучшие практики:** **Период ожидания (backoff):** Немедленно остановите или ограничьте последующие запросы из вашей системы. Не повторяйте неудачные запросы непрерывно в плотном цикле. **Очередь и ограничение:** Буферизуйте или ставьте в очередь исходящие запросы на вашей стороне для управления потоком трафика перед повторной отправкой. **Экспоненциальный backoff с jitter:** При повторных попытках увеличивайте время ожидания экспоненциально между попытками (например, 1 с, 2 с, 4 с, 8 с) и добавляйте небольшую случайную задержку ("jitter"), чтобы предотвратить эффект стада, когда все поставленные в очередь запросы повторяются в один и тот же момент. предупреждениеНепрерывные запросы к эндпоинту с ограничением без отступления могут **продлить период ограничения** и серьёзно повлиять на операционную пропускную способность вашей системы. Правильное ограничение запросов на вашей стороне обеспечивает более плавную и устойчивую интеграцию.Для получения информации о лимитах по умолчанию, увеличении запросов и дополнительных деталях см. [Лимиты запросов](/ru/dual-api/developers/api-reference/rate-limits).КодСообщениеОписание`99999`Internal failure! Try again laterВнутренняя ошибка. ### Что дальше​ После завершения пути пользователем вызовите [Получение процесса](/ru/dual-api/developers/api-reference/web-sdk/get-process) для получения результата или дождитесь [вебхука](/ru/developers/webhooks-and-events). Чтобы увидеть все комбинации рецептов и их возможные значения результата, см. [Потоки](/ru/dual-api/developers/api-reference/web-sdk/flows). Последнее обновление 8 окт. 2026 г.**