Requisitos para Integração
Para implementar a integração com nossa aplicação, a empresa parceira deve seguir algumas etapas.
Secret da Empresa
Um identificador único associado à empresa parceira, fornecido por nossa equipe.
IP Autorizado
A empresa parceira deve nos informar o(s) endereço(s) IP que realizarão as chamadas de autenticação.
Esse IP será verificado em todas as requisições como camada adicional de segurança. Chamadas originadas de IPs não autorizados serão rejeitadas com error.invalid.ip.address (HTTP 401).
SCORE — Regras de Validação
A UNICO utiliza dois modelos de decisão na biometria:
- Aprovação direta
- Aprovação baseada em SCORE, quando a validação inicial não é conclusiva
Para empresas que utilizam o SCORE, é necessário definir previamente as faixas de aprovação, rejeição e análise manual.
Alternativas de resultado
O sistema trabalha com quatro possíveis retornos:
- APROVAR
- REJEITAR por fraude
- MESA — análise manual pela empresa contratante da ScoreHub
- NOVA TENTATIVA
Exemplo de configuração por faixas (RANGE)
A configuração é feita pela empresa, antes de iniciar o uso do fluxo:
| Faixa (SCORE) | Ação |
|---|---|
| +50 a +100 | APROVAR |
| 0 a +48 | NOVA TENTATIVA |
| –1 a –39 | MESA |
| –100 a –40 | REJEITAR por fraude |
Nem todos os planos com a UNICO retornam o SCORE. Caso não utilize, não é necessário preencher esses valores.
Recursos adicionais
Prova de Vida
A UNICO retorna a prova de vida (liveness), indicando se a pessoa está viva. Caso o liveness venha FALSO, o processo é definido como fraude biométrica.
Reutilização de biometria — 1:1 UNICO
Quando o cliente (CPF) já realizou uma assinatura em nosso sistema, utilizamos o processo 1:1 da UNICO, comparando a biometria atual com a última realizada. Isso garante economia no processo de biometria.
SDK de Captura de Documentos by ScoreHub
SDK de captura automática para documentos de identificação: RG, CNH, CIN, RNE, Passaporte e CTPS.
- Tecnologia ML para captura e análise no momento da captura
- Processo de IA para validar qualidade, legibilidade e conformidade do documento
- Não realizamos OCR (extração dos dados)
FaceMatch
Em conjunto com a biometria UNICO e a captura de documento ScoreHub, realizamos o FaceMatch, confirmando que o rosto do CPF é o mesmo do documento de identificação.
Documento digital
Aceitamos documentos digitais oficiais extraídos pelo GOV ou CNH digital. Realizamos a validação do HASH da assinatura e, se solicitado, o FaceMatch.
Reaproveitamento de documentos by ScoreHub
Se o CPF do cliente já tiver documentos armazenados na ScoreHub (dentro do prazo legal da LGPD), reutilizamos o mesmo documento — sem custo de captura e análise documental para aquela assinatura.