# Validação em bases de dados: ativar serviços e cobranças

Source: https://help.didit.me/pt-PT/documents-coverage/database-validation
Updated: 2026-09-15

A validação confronta os dados extraídos com um registo oficial. Vê porque um serviço diz Requer integração, devolve 403 ou nada, e que consultas são cobradas.

A validação em bases de dados corre **em segundo plano** contra um registo oficial: a pessoa
nunca a vê. Só é ativada após o **primeiro carregamento** da sua organização, alguns serviços
mostram ainda **"Requer integração"** até a Didit os ativar para si, e toda a consulta a que o
registo responde é cobrada, **incluindo uma sem correspondência**.

[Video: Verificações em bases de dados governamentais - Didit Academy](https://www.youtube.com/watch?v=OksmtyKHe48&t=18)

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](https://docs.didit.me/core-technology/database-validation/database-validation-supported-countries) e [preços por serviço](https://docs.didit.me/getting-started/database-validation-pricing).

## 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](https://help.didit.me/pt-PT/verification-sessions/correct-extracted-data).
- **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](https://docs.didit.me/standalone-apis/database-validation) 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](https://help.didit.me/pt-PT/billing-credits/top-ups-invoices-and-payments).

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 é paga com o crédito do plano Gratuito. Um saldo zero ou negativo devolve `insufficient_credits`, tal como qualquer funcionalidade paga. Veja [corrigir um erro de "créditos insuficientes"](https://help.didit.me/pt-PT/billing-credits/not-enough-credits).

## 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.

> **Note:** Alguns serviços exigem ainda o **consentimento explícito do utilizador final** antes de a consulta
> ser enviada (por exemplo a verificação de passaporte DIA da Nova Zelândia). O passo do fluxo
> marca esses serviços, e o consentimento tem de ser recolhido no seu fluxo antes de a verificação
> poder correr.

## 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":

| Resultado | Cobrado? |
|---|---|
| Correspondência, correspondência parcial, sem correspondência | Sim |
| Inconclusivo, imagem biométrica inutilizável | Sim |
| Formato de documento inválido, entrada inválida (rejeitada pelo registo) | Sim |
| `REGISTRY_UNAVAILABLE`, `REGISTRY_ERROR` (o registo nunca respondeu) | Não |
| Pedido rejeitado antes de chegar ao registo (400 na API autónoma, ou passo do fluxo ignorado por campos em falta ou malformados) | Não |

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](https://docs.didit.me/getting-started/database-validation-pricing) e [códigos de resultado](https://docs.didit.me/core-technology/database-validation/database-validation-outcome-codes).

> **Warning:** Um resultado **vazio** não é uma não correspondência. Se um serviço não devolve nada em vez de um
> resultado `NO_MATCH`, as causas habituais são a regra do primeiro carregamento, um serviço ainda
> à espera de integração ou uma falha do registo; vale a pena excluí-las antes de depurar a sua
> integração. Veja [erros da API e o que significam](https://help.didit.me/pt-PT/integration/api-errors).

## 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](https://help.didit.me/pt-PT/workflows/returned-data) e o [relatório de validação em bases de dados](https://docs.didit.me/core-technology/database-validation/database-validation-report).

## 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](https://help.didit.me/pt-PT/getting-started/sandbox-and-testing).