Validação em bases de dados - ativar serviços e o que é cobrado

A validação em bases de dados confronta os dados de identidade extraídos com um registo oficial ou autorizado. Porque é que um serviço mostra "Requer integração", porque devolve 403 ou nada, e que consultas são cobradas.

Escrito pelo suporte da Didit · Atualizado a 15 de setembro de 2026

Ler o documento diz-lhe o que está impresso. A validação em bases de dados diz-lhe se uma fonte autorizada concorda: um registo civil, uma autoridade fiscal, um bureau de crédito, uma base de cartas de condução. Cada país expõe um ou mais serviços, cada um com o seu preço, os seus dados de entrada e as suas regras de consentimento. Veja países e serviços suportados e preços por serviço.

#Corre em silêncio, depois do passo do documento

Não existe um ecrã de validação em bases de dados. O passo pega nos dados extraídos do documento (ou nos que passou ao criar a sessão), envia-os ao registo e guarda a resposta no relatório da sessão. Daí decorrem duas consequências:

• Se o passo de ID extraiu o número ou o nome errado, o registo é consultado com o valor errado e a verificação falha ou volta inconclusiva. Corrija primeiro a extração. Veja corrigir um nome ou campo mal lido.
• Não pode "reenviar" uma validação em bases de dados ao utilizador como reenvia um documento ou uma selfie, porque não há nada que ele possa repetir. Pedir um reenvio de DATABASE_VALIDATION devolve um erro a indicar que a funcionalidade não faz parte dos passos reenviáveis da sessão. Para a correr de novo, chame a API autónoma de validação em bases de dados com os dados corrigidos. Essa chamada é cobrada por consulta como qualquer outra.

#Porque não está a correr

Verifique por esta ordem. Explica quase todos os relatos de "a validação em bases de dados não fez nada".

1. A sua organização já fez algum carregamento?

   A validação em bases de dados (e a verificação de telefone) só é ativada após um primeiro carregamento. Os créditos de boas-vindas, incluindo os 10 $ de conta nova, não contam. Até lá o passo é ignorado, uma sessão pode voltar aprovada com a verificação silenciosamente não realizada, e uma chamada direta a POST /v3/database-validation/ responde 403. Veja carregamentos, faturas e métodos de pagamento.

2. O serviço está marcado como Requer integração?

   No passo de validação em bases de dados do fluxo, alguns serviços mostram "Requer integração. Contacte o suporte da Didit para ativar." O serviço está visível mas desativado para a sua organização até a Didit o ativar. Não é um erro e não há interruptor de self-service: abra um pedido de suporte com o serviço e o país, e a equipa inicia a integração.

3. O país está sequer configurado?

   Uma chamada de API para um país que nunca selecionou no fluxo, ou uma chamada autónoma para um serviço que não ativou, responde "No database validation services configured" para esse país. Adicione o serviço ao passo, ou passe o service_id exato da página do país.

4. O saldo é positivo?

   A validação em bases de dados nunca está no plano gratuito. Um saldo zero ou negativo devolve insufficient_credits, tal como qualquer funcionalidade paga. Veja corrigir um erro de "créditos insuficientes".

#Serviços que precisam de integração com o fornecedor

Um punhado de fontes governamentais exige que a Didit inscreva a sua organização junto do fornecedor, e não apenas que ligue um interruptor. Hoje isso aplica-se a:

• Austrália (DVS: carta de condução, passaporte, visto, Medicare e os restantes serviços DVS)
• Nova Zelândia (DIA: passaporte, cidadania, registos de nascimento e óbito, carta de condução)
• Canadá (serviços de bureau de crédito e de cruzamento tipo FINTRAC)

Para estes, o suporte envia-lhe os formulários do fornecedor, o fornecedor emite credenciais para a sua conta e a ativação demora normalmente até duas semanas. A Austrália e a Nova Zelândia exigiram historicamente ainda um acordo de serviço mínimo (um valor pré-pago único, atualmente 5.000 USD, que entra no seu saldo como créditos que nunca expiram). Esse requisito aplica-se só ao acesso aos registos desses dois países, a nenhuma outra funcionalidade da Didit, e está a ser revisto à medida que a Didit conclui a sua própria acreditação no esquema australiano; pergunte ao suporte as condições em vigor antes de planear com base nele.

#O que é cobrado

Paga por serviço, por cada consulta a que o registo responde, ao preço da página desse serviço. Leia como "o registo foi consultado e respondeu", não como "a resposta foi a que queria":

Uma sessão pode gerar várias consultas cobradas se correr vários serviços, e cada consulta é cobrada uma vez por serviço, não por país. Detalhe completo: preços de validação em bases de dados e códigos de resultado.

#O que é devolvido

Cada serviço devolve um código de resultado padrão mais os dados do próprio registo quando a fonte o permite: que campos coincidiram, uma pontuação de correspondência quando o registo pontua em vez de responder sim ou não, e nos serviços biométricos (RENAPER da Argentina, BVN da Nigéria, Panamá) uma comparação facial com o retrato do registo. O que a Didit guarda dessa resposta é governado pelas definições de Dados devolvidos do passo. Veja escolher que dados uma verificação devolve e o relatório de validação em bases de dados.

#Testar antes de ir para produção

As aplicações sandbox nunca chegam a um registo real nem gastam créditos: um cenário de sandbox como decline_database_no_match força o resultado que quer ensaiar. O que o sandbox não lhe pode dizer é se um serviço específico está provisionado para a sua organização em produção; para isso é preciso o primeiro carregamento e uma chamada real. Veja testar em sandbox.