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

Тихая верификация

Тихая верификация позволяет ранее подтверждённой личности, обращающейся повторно, завершить транзакцию Верификации без предъявления карты без видимого экрана захвата. Вместо того чтобы запрашивать у пользователя новое селфи, технология Unico оценивает сигналы и повторяемость в фоновом режиме, чтобы решить, можно ли одобрить транзакцию в тихом режиме.

Тихая верификация — это не отдельный продукт, а дополнительный шаг поверх того же процесса создания транзакции, описанного в разделах Платёжные транзакции и Onboarding кредитной карты. Сбор контекстных сигналов с помощью SDK и отправка того же внешнего ключа при создании транзакции — вот что делает возможным тихое одобрение.

Когда это применяется
  • Тихая верификация применяется, когда истории достаточно для того, чтобы технология Unico могла оценить личность по сигналам.
  • Если такая оценка невозможна — из-за недостатка истории или по другим причинам — транзакция переключается на стандартный визуальный поток. Это может произойти, например, когда определённая личность впервые встречается в сети.
1. Сбор метаданных устройства с помощью SDK

Установите и инициализируйте Capture SDK для вашей платформы как обычно — Тихая верификация не меняет эту настройку. Следуйте руководству по сбору данных мониторинга для вашей платформы, чтобы отправить externalUserId:

информация

Flutter пока не поддерживается для Тихой верификации.

Здесь это не просто метаданные для наблюдаемости

В руководствах по сбору данных мониторинга поле externalUserId описывается как необязательная телеметрия, которая «не изменяет поведение захвата SDK или ответ API». Это верно для самого SDK. В Верификации без предъявления карты это же поле используется бэкендом, чтобы решить, можно ли одобрить транзакцию в тихом режиме. Его отправка — это то, что включает Тихую верификацию для данной транзакции: здесь оно не является нейтральным.

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

  • Мобильные платформы (Android / iOS): используйте перегрузку prepareCamera / prepareSelfieCamera, принимающую объект PrepareInfo с externalUserId, и не вызывайте метод открытия камеры внутри callback успеха — если только вы действительно не хотите полный визуальный поток для этой сессии.
unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        // Здесь не нужно вызывать cameraOpener?.open() — сбор данных в фоновом режиме уже начался.
    }
    override fun onCameraFailed(message: String?) { /* handle error */ }
}, PrepareInfo("YOUR_EXTERNAL_USER_ID"))
  • Web: вызовите setSilentInfo(externalUserId, useCase) на экземпляре UnicoCheckBuilder до вызова prepareCamera / prepareSelfieCamera, и точно так же не открывайте камеру в callback успеха.
unicoCamera.setSilentInfo("YOUR_EXTERNAL_USER_ID");
await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);
// Здесь не нужно открывать камеру — сбор данных в фоновом режиме уже начался.
Временное окно

SDK собирает данные в фоновом режиме, поэтому перед созданием транзакции должен пройти минимальный интервал:

  • Начните подготовку SDK как минимум за 4 секунды до вызова API транзакции — если сделать это слишком рано, сбор данных может не успеть завершиться.
  • Собранные данные действительны до 5 минут — если сделать это слишком поздно, к моменту создания транзакции они уже истекут.
2. Создание транзакции с тем же externalUserID

externalUserID необязателен — но без него Тихая верификация для данной транзакции невозможна. При создании транзакции — через Платёжные транзакции или Onboarding кредитной карты — отправьте точно такой же externalUserID, который использовался в SDK, внутри additionalInfo:

{
  "additionalInfo": {
    "externalUserID": "YOUR_EXTERNAL_USER_ID"
  }
}

Если его не указать, это не вызовет ошибку — транзакция всё равно создаётся в обычном режиме, просто она всегда следует стандартному потоку с визуальным сопротивлением.

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

Если транзакция соответствует условиям и одобрена в тихом режиме, дальнейших действий не требуется:

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "approved"
}

В противном случае ответ содержит link для завершения стандартного визуального потока, точно так же, как транзакция, созданная без Тихой верификации:

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "waiting",
  "link": "https://aces.so/example",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cC[...]Ok6yJV_adQssw5c"
}

Для любого другого статуса следуйте стандартному потоку, используя возвращённый link — полный список статусов см. в разделах Управление процессом и Перечисления.

Последнее обновление