Documentação

Português

English
Español

Português

English
Español

Appearance

Detalhe e decisão ​

Pré-requisitos de acesso

  • Permissão (módulo): viewKycQueue (ver detalhe) e reviewKyc (decidir)
  • Rota: /kyc-queue/:userId

O que é / quando usar ​

O detalhe reúne, em uma única tela, tudo que o Compliance Officer precisa para decidir o KYC do investidor: identidade, evidência de Investidor Qualificado, documentos enviados, background-check do BaaS, quadro societário e dados de acesso — mais o card de revisão com as ações.

Painéis do detalhe ​

Identidade ​

Resultado do provedor de KYC: documento, imagens, liveness e AML.

  • Dados do documento — tipo, número, número pessoal, nome completo, nascimento, país emissor, nacionalidade, gênero, validade, emissão, endereço.
  • Verificações — liveness (status e score), face match (status e score), confiança.
  • Imagens — documento (frente/verso) e selfie/retrato.
  • AML — checagem AML e checagem multi-bureau.
  • Payload completo do provedor — payload bruto para auditoria.

Identidade por selfie Axia

Quando a identidade é verificada por selfie/documentoscopia Axia (AXIA_KYC) em vez do provedor, o painel exibe uma nota: identidade verificada por selfie (Axia), com revisão manual pelo Compliance. A selfie fica na seção Documentos do usuário; documentoscopia/AML por provedor não se aplica.

Investidor Qualificado ​

Evidência de patrimônio/accreditation enviada pelo investidor (opcional — libera limites maiores). Mostra data e IP/dispositivo do envio, preview/download da evidência (arquivo SECURED). A decisão do IQ é tratada em Investidor Qualificado.

Pré-análise facial ​

Quando habilitada para o tenant, compara automaticamente o rosto do documento de identidade com o da selfie e exibe um veredito — Confere, Revisar, Divergente, Inconclusivo ou Falha técnica — junto com a distância medida, os limiares, o documento usado e quantos rostos foram detectados em cada imagem.

O card fica logo acima de Documentos do usuário, de propósito: você lê o veredito e, na sequência, tem as imagens para conferir. Detalhes de leitura, limitações e aprovação automática em Pré-análise facial.

A pré-análise nunca reprova sozinha

"Divergente" sinaliza o caso para revisão — não rejeita. Se a aprovação automática estiver ligada, apenas o veredito "Confere" promove a conta, e o card informa isso explicitamente.

Documentos do usuário ​

Todos os artefatos de KYC enviados — documentos pessoais e a selfie do AXIA_KYC em destaque (selo "Selfie") para comparação facial com o documento. Cada item tem preview e download.

Background-check (BaaS) ​

Resultado do background-check do provedor bancário, quando habilitado: ID da checagem, status, e o bloco de documentoscopia — status (Pendente / Aprovada / Reprovada), face match, OCR e link para abrir a documentoscopia.

Quadro Societário (QSA) ​

Sócios declarados do investidor pessoa jurídica: tipo (sócio-administrador / sócio), nome, CPF mascarado, nascimento, nome da mãe e participação.

Dados de acesso ​

Último acesso, logins recentes geolocalizados em mapa (OpenStreetMap) e dispositivos registrados. Útil para checar coerência geográfica e detectar acesso suspeito.

Revisão ​

Card com a decisão registrada pelo Compliance Officer: revisado por, revisado em, motivo e notas.

Decisões da conta ​

As ações da conta ficam em Decisão da conta. Ambas exigem step-up (senha + MFA).

Aprovar conta ​

  • Pré-condição: identidade verificada — provedor PASSED ou selfie/documentoscopia Axia. Enquanto a identidade não estiver aprovada, o botão fica desabilitado com o aviso "Identidade ainda não aprovada pelo provedor".
  • Efeito: seta overall_status = APPROVED e promove user.status = 'APPROVED' — pré-condição já consumida pela provisão de identidade on-chain (ERC-3643). A evidência de Investidor Qualificado é opcional e pode ser decidida separadamente.

Rejeitar conta ​

  • Pré-condição: selecionar um motivo (obrigatório) — INSUFFICIENT_PC_EVIDENCE, AML_FAIL ou DOCUMENT_UNCLEAR (ver reason codes). Nota opcional para o registro.
  • Efeito: seta overall_status = REJECTED, grava o motivo e notifica o investidor, que pode corrigir e reenviar a parte reprovada. Para clientes legados, também seta users.status = 'REJECTED'.

Estados de UI e erros ​

  • Carregando/erro — skeleton no carregamento; mensagens de falha ao carregar a evidência.
  • Decisão falhou — "Não foi possível registrar a decisão. Tente novamente."
  • Estado mudou (409) — "A decisão não pôde ser aplicada: o estado do KYC mudou. Recarregue a página e tente novamente." Acontece quando o estado do KYC muda entre a leitura e a decisão (proteção de concorrência).

Regras de negócio / cuidados ​

Atenção

  • Toda decisão exige step-up. O reviewed_by vem do administrador autenticado, nunca do corpo da requisição.
  • Aprovar conta ≠ aprovar IQ. Aprovar a conta não marca o investidor como qualificado; o IQ é uma decisão separada, em escopo próprio.
  • Rejeição sempre com motivo — é auditável e é o que o investidor vê para corrigir.
  • Legado rejeitado é notificado e volta para o fluxo de verificação (ver clientes legados).

Telas relacionadas ​