Pular para o conteúdo principal

Verificação Silenciosa

A Verificação Silenciosa permite que uma identidade recorrente e previamente validada conclua uma transação da Verificação de Cartão Não Presente sem uma tela de captura visível. Em vez de pedir ao usuário uma nova selfie, a tecnologia da Unico avalia sinais e recorrência em segundo plano para decidir se a transação pode ser aprovada silenciosamente.

A Verificação Silenciosa não é um produto separado — é uma etapa extra sobre o mesmo fluxo de criação de transação descrito em Transações de pagamento e Onboarding de cartão de crédito. Coletar sinais de contexto com o SDK e enviar essa mesma chave externa ao criar a transação é o que possibilita a aprovação silenciosa.

Quando se aplica
  • A Verificação Silenciosa se aplica quando há histórico suficiente para que a tecnologia da Unico avalie a identidade por meio de sinais.
  • Quando essa avaliação não é possível — por falta de histórico ou por outros motivos — a transação recai no fluxo visual padrão. Isso pode acontecer, por exemplo, na primeira vez que uma determinada identidade é vista na rede.
1. Colete os metadados do dispositivo com o SDK

Instale e inicialize o Capture SDK para a sua plataforma como de costume — a Verificação Silenciosa não muda essa configuração. Siga o guia de Coleta de Dados de Monitoramento da plataforma para enviar o externalUserId:

informação

O Flutter ainda não é suportado para a Verificação Silenciosa.

Aqui não é apenas um metadado de observabilidade

Os guias de Coleta de Dados de Monitoramento descrevem o externalUserId como telemetria opcional que "não altera o comportamento de captura do SDK nem a resposta da API". Isso é verdade para o SDK isoladamente. Na Verificação de Cartão Não Presente, esse mesmo campo é o que o backend usa para decidir se a transação pode ser aprovada silenciosamente. Enviá-lo é o que habilita a Verificação Silenciosa para essa transação — aqui ele não é inerte.

Dois ajustes na configuração de captura padrão são necessários para manter o fluxo silencioso:

  • Mobile (Android / iOS): use a sobrecarga de prepareCamera / prepareSelfieCamera que recebe um objeto PrepareInfo com externalUserId, e não chame o método de abertura da câmera dentro do callback de sucesso — a menos que você realmente queira o fluxo visual completo para aquela sessão.
unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        // Não é necessário chamar cameraOpener?.open() aqui — a coleta em segundo plano já foi iniciada.
    }
    override fun onCameraFailed(message: String?) { /* handle error */ }
}, PrepareInfo("YOUR_EXTERNAL_USER_ID"))
  • Web: chame setSilentInfo(externalUserId, useCase) na instância do UnicoCheckBuilder antes de chamar prepareCamera / prepareSelfieCamera, e da mesma forma evite abrir a câmera no callback de sucesso.
unicoCamera.setSilentInfo("YOUR_EXTERNAL_USER_ID");
await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);
// Não é necessário abrir a câmera aqui — a coleta em segundo plano já foi iniciada.
Janela de tempo

O SDK coleta os dados em segundo plano, então é necessário um intervalo mínimo antes de criar a transação:

  • Inicie a preparação do SDK pelo menos 4 segundos antes de chamar a API de transação — muito cedo, e a coleta pode não ter terminado.
  • Os dados coletados são válidos por até 5 minutos — muito tarde, e eles já terão expirado quando a transação for criada.
2. Crie a transação com o mesmo externalUserID

O externalUserID é opcional — mas sem ele, a Verificação Silenciosa não pode ocorrer para essa transação. Ao criar a transação — via Transações de pagamento ou Onboarding de cartão de crédito — envie o exato mesmo externalUserID usado no SDK, dentro de additionalInfo:

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

Omiti-lo não causa nenhum erro — a transação ainda é criada normalmente, apenas sempre segue o fluxo padrão com fricção visual.

3. Trate a resposta

Se a transação for elegível e for aprovada silenciosamente, nenhuma ação adicional é necessária:

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

Caso contrário, a resposta inclui um link para concluir o fluxo visual padrão, exatamente como uma transação criada sem a Verificação Silenciosa:

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

Para qualquer outro status, siga o fluxo padrão usando o link retornado — veja Controlando a experiência e Enumerados para a lista completa de status.

Última atualização em