Pular para o conteúdo principal

Verificação Silenciosa

MarkdownChatGPTClaude

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.

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