Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alteraçõesA importação e a exportação em massa descritas aqui apenas criam ou atualizam perfis de User. Elas não recriam sessões de KYC históricas, avisos de documentos, evidências de prova de vida nem decisões de provedores. Para uma migração completa a partir de Sumsub, MetaMap, Veriff, Onfido, Persona ou outro provedor, consulte Importar dados de outro provedor.
Importar usuários de um CSV
Quando usar
- Migração inicial a partir de outro fornecedor de KYC: traga sua base de usuários existente.
- Migração de faces do provedor: anexe imagens faciais confiáveis aos perfis de User importados depois que os registros forem criados.
- Onboarding em massa da lista de clientes de um parceiro.
- Preenchimento retroativo de metadados: atualize tags, nível ou identificadores internos de muitos usuários de uma só vez.
Colunas do modelo
Baixe o modelo em Users → Import → Download template. Colunas:Executar a importação
1
Envie o CSV
Acesse Users → Import → Upload CSV e selecione seu arquivo.
2
Revise a pré-visualização
O console valida cada linha. As linhas inválidas são destacadas com o motivo do erro (por exemplo,
vendor_data duplicado ou código de país inválido).3
Inicie a importação
A Didit processa as linhas de forma assíncrona. Você pode fechar a aba: o progresso é acompanhado em Users → Import history.
4
Revise os resultados
Quando a importação termina, a visualização do histórico mostra a contagem de linhas criadas, atualizadas e ignoradas, além de um relatório de erros para download.
Atualizar ou criar
- Se um
vendor_datanão existir, um novo User é criado. - Se um
vendor_datajá existir, a linha atualiza o User existente (campos do perfil e metadados). - Contadores agregados e campos verificados (
full_name,date_of_birthde sessões aprovadas) nunca são sobrescritos por importações.
Importar faces depois da criação do usuário
A importação de CSV cria ou atualiza o registro do User. Ela não inclui imagens faciais no CSV. Para trazer biometria facial de outro provedor, envie cada face depois que o User de destino existir:1
Crie ou importe o User
Use a importação de CSV do console ou chame
POST /v3/users/create/ em um loop.2
Leia o didit_internal_id
Obtenha o User com
GET /v3/users/{vendor_data}/. A resposta inclui didit_internal_id.3
Envie a face
Chame
POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/ com uma imagem facial em base64 puro.Exportar usuários para CSV
Quando usar
- Auditorias de conformidade: entregue a tabela completa de usuários aos auditores.
- Sincronização com data warehouse: extração periódica para suas ferramentas de BI.
- Solicitações de SAR ou de reguladores: extraia subconjuntos filtrados de usuários.
Executar uma exportação
- Acesse Users → Export.
- Aplique filtros (status, país, intervalo de datas, busca).
- Escolha as colunas (o padrão é todos os campos; você pode remover as colunas de que não precisa).
- Envie. A Didit gera a exportação de forma assíncrona e envia por e-mail um link de download assinado ao operador que fez a solicitação.
As exportações incluem apenas os dados que sua função tem permissão para ler. COMPLIANCE_OFFICER e funções superiores podem exportar a tabela completa; as funções DEVELOPER e READER têm exportações restritas.
Características de desempenho
Trilha de auditoria
Cada importação e exportação é registrada no registro de auditoria:- O operador que a iniciou.
- Contagem de linhas (importações) / snapshot dos filtros (exportações).
- Datas e horas e o status de sucesso ou falha.
Próximos passos
API de criação de usuários
Criação programática para importações por script.
Enviar face do usuário
Anexe imagens faciais importadas aos perfis de usuário.
Retenção de dados
Por quanto tempo os dados importados são mantidos.
Registros de auditoria
Revise o histórico de importações e exportações.