Revalidação Silenciosa

Utiliza o motor da Revalidação Silenciosa, que analisa o contexto comportamental do usuário no efeito de rede Unico, e entrega o sinal de confiança da transação corrente. Ou seja, entregamos o nível de confiança de ser o usuário esperado na transação.

Atributos do PrepareInfo

Atributo	Tipo	Obrigatório	Descrição
externalUserId	String	✅	Identificador do usuário no seu sistema. Automaticamente hasheado com SHA-256 antes da transmissão, nunca enviado em texto plano.

Iniciando uma Revalidação Silenciosa

Passo 1 — Implemente initializeSDK

Crie uma nova classe/objeto UnicoSDK, com um método estático initializeSDK que retorna a instância do UnicoSDK, recebendo o context e um UnicoSDKConfig com seu sdkKey, bundleId e environment. Mantenha a instância retornada — ela será necessária mais tarde para chamar startSilentValidation a partir do Java.

Chame durante a inicialização do app

UnicoSDK.initializeSDK deve ser chamado o mais cedo possível durante a inicialização do app (por exemplo, Application.onCreate). Chamá-lo mais tarde reduz o tempo de processamento em segundo plano e aumenta a chance de respostas de autenticação inconclusivas.

Kotlin

UnicoSDK.initializeSDK(
    context,
    UnicoSDKConfig(
        sdkKey = "your_sdk_key",
        bundleId = "your_bundle_id",
        environment = Environment.UAT
    )
)

Java

UnicoSDK sdk = UnicoSDK.initializeSDK(
    context,
    new UnicoSDKConfig("your_sdk_key", "your_bundle_id", Environment.UAT)
);

Passo 2 — Implemente startSilentValidation

Após o initializeSDK, associe a coleta já em andamento ao usuário identificado chamando startSilentValidation com um PrepareInfo contendo o externalUserId.

Kotlin

val prepareInfo = PrepareInfo(
    externalUserId = "external_user_id"
)

UnicoSDK.startSilentValidation(prepareInfo)
    .onSuccess { result -> /* ... */ }
    .onFailure { error -> /* ... */ }

Java

Java requer uma ponte com Kotlin

startSilentValidation é uma função suspend do Kotlin — o Java não pode chamá-la diretamente. Use a ponte abaixo para fazer a conexão.

interface SilentAuthCallback {
    fun onSuccess(success: Boolean)
    fun onFailure(message: String?)
}

object SilentAuthBridge {

    @JvmStatic
    fun startSilentValidation(
        owner: LifecycleOwner,
        sdk: UnicoSDK,
        externalUserId: String,
        callback: SilentAuthCallback
    ) {
        owner.lifecycleScope.launch {
            val result = sdk.startSilentValidation(PrepareInfo(externalUserId, null))
            result.onSuccess { callback.onSuccess(it.success) }
                .onFailure { callback.onFailure(it.message) }
        }
    }
}

SilentAuthBridge.startSilentValidation(this, sdk, externalUserId, new SilentAuthCallback() {
    @Override
    public void onSuccess(boolean success) {
        /* ... */
    }

    @Override
    public void onFailure(String message) {
        /* ... */
    }
});

Se a validação acontecer no início do fluxo, por exemplo no login, aguarde o callback onSuccess antes de avançar para o Passo 3.

Passo 3 — Crie o processo e autentique

Com a validação em andamento, crie o processo de verificação para concluir a autenticação. Veja Referência da API ▸ API ▸ Criar Processo.

Inclua o mesmo externalUserId enviado no PrepareInfo do Passo 2 no corpo da requisição — é isso que permite ao backend correlacionar a criação do processo com a validação já em andamento.

curl -X POST https://api.id.unico.app/processes/v1 \
  -H "Authorization: Bearer $TOKEN" \
  -H "APIKEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": {
      "duiType": 1,
      "code": "12345678909",
      "name": "Luke Skywalker",
      "gender": "M",
      "birthDate": "2000-05-20",
      "email": "[email protected]",
      "phone": "5519725570707"
    },
    "useCase": "Onboarding",
    "externalUserId": "external_user_id"
  }'

A resposta inclui o campo silentAuth.result com o resultado da autenticação:

{
    "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
    "status": 3,
    "silentAuth": {
        "result": "yes"
    }
}

Campo	Tipo	Descrição
silentAuth.result	string	yes ou no — veja os valores possíveis abaixo.

silentAuth.result — valores possíveis

Valor	Significado
yes	Autenticação aprovada, usuário reconhecido com confiança suficiente, nenhuma captura adicional necessária.
no	Dados insuficientes para aprovar silenciosamente. É recomendado autenticar via biometria (selfie) ou outro método alternativo.