API de Verificação Residencial na República Tcheca (PT-BR)

Integrar usuários na República Tcheca significa confirmar que eles são quem afirmam ser. Verifica os dados de entrada em uma fonte combinada de registros de autoridades públicas. Um documento ou um detalhe digitado apenas prova que os dados existem — não que sejam genuínos ou pertençam à pessoa à sua frente. A Verificação Residencial da República Tcheca preenche essa lacuna verificando os dados em relação a fontes de dados residenciais e de consumo autorizadas. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais pontos:

• O que verifica — A Verificação Residencial da República Tcheca valida dados de endereço e residenciais em relação a fontes de dados residenciais e de consumo autorizadas.
• O que você recebe — um match_type normalizado mais resultados em nível de campo que você pode direcionar diretamente para a lógica de aprovação / revisão / rejeição.
• Por que é importante — A verificação de endereço em relação a dados autorizados confirma que um solicitante realmente mora onde afirma — um sinal fundamental antifraude e de conformidade.
• Como usar — um POST para o endpoint de validação de banco de dados da Didit, ou um módulo de fluxo de trabalho sem código. US$ 0,95 por consulta conclusiva, resultados em segundos.

O que a Verificação Residencial da República Tcheca valida

Verifica os dados de entrada em relação a uma fonte combinada de registros de autoridades públicas. A Didit a expõe por meio de um único endpoint para que você possa verificar os dados enviados em relação a fontes de dados residenciais e de consumo autorizadas e receber um resultado estruturado e normalizado — não um despejo de registro bruto que você precisa analisar por conta própria.

Uma resposta conclusiva retorna os source_data correspondentes e um bloco de validation por campo, para que seu motor de risco obtenha um veredito claro e legível por máquina.

Por que é importante

A verificação de endereço em relação a dados autorizados confirma que um solicitante realmente mora onde afirma — um sinal fundamental antifraude e de conformidade.

Para empresas regulamentadas na República Tcheca — fintechs, plataformas de cripto, credores, mercados e operadores de jogos — a verificação em relação a uma fonte autorizada produz um registro defensável e auditável de que a identidade foi confirmada na fonte, não meramente capturada de um formulário ou foto.

Detalhes técnicos

A Didit expõe este serviço por meio do endpoint unificado de validação de banco de dados. É um único POST — nenhum SDK é necessário.

Endpoint

POST /v3/database-validation/

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código do país ISO 3166-1 alfa-3. Use CZE.
services	string	Sim	Identificador de serviço. Use cze_republic_residential.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Sobrenome.
address	string	Sim	Endereço.
date_of_birth	string	Não	Data de nascimento (verificação cruzada opcional).
postal_code	string	Não	Código postal (verificação cruzada opcional).

Exemplo de requisição

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=CZE" \
  -F "services=cze_republic_residential" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "address=123 Sample Street, Sample City, 10001"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "CZE",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "cze_republic_residential",
      "service_name": "Czech Republic Residential",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe",
        "postal_code": "10001"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturamento

• Latência: tipicamente alguns segundos.
• Custo: US$ 0,95 por consulta conclusiva. Você é cobrado apenas por resultados conclusivos — sem cobrança por tempo de inatividade da fonte, campos ausentes ou rejeições pré-fonte.
• Confiabilidade: funciona na infraestrutura da Didit com uma meta de tempo de atividade trimestral de 99,9%.

Casos de uso

• Fintech e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito na República Tcheca.
• Cripto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autorizada.
• Empréstimos — reduza fraudes de identidade sintética e de primeira parte com dados verificados na fonte.
• Mercados e plataformas gig — verifique usuários em relação a dados autorizados, não apenas um formulário autorrelatado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores da República Tcheca com um rastro auditável.

Como integrar com a Didit

Você pode executar a Verificação Residencial da República Tcheca de duas maneiras:

1. Fluxo de trabalho sem código. No Didit Business Console, abra o Workflow Builder, adicione o módulo Database Validation, selecione Czech Republic → Czech Republic Residential Verification e ative-o. Os usuários correspondentes são roteados automaticamente — sem necessidade de engenharia.
2. API Direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=cze_republic_residential. Leia match_type e o bloco de validation por campo para impulsionar sua lógica de aprovação / revisão / rejeição.

Toda conta Didit inclui 500 verificações gratuitas por mês, para que você possa testar o fluxo completo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação Residencial da República Tcheca confirma?

Ela valida os dados enviados em relação a fontes de dados residenciais e de consumo autorizadas e retorna um resultado de correspondência normalizado, para que você saiba se o endereço e os dados residenciais existem na fonte autorizada e quais campos corresponderam.

O que acontece se a fonte estiver temporariamente indisponível?

Você não é cobrado. A cobrança se aplica apenas a resultados conclusivos — tempo de inatividade da fonte, campos ausentes e rejeições pré-fonte são gratuitos.

Qual a velocidade da verificação?

A validação do banco de dados geralmente retorna em alguns segundos, então ela se encaixa em um fluxo de integração em tempo real.

Preciso de um SDK?

Não. A verificação é um único POST HTTPS para um endpoint. Você também pode conectá-la a um fluxo de trabalho sem código no Business Console.

Pronto para começar?

Valide seu primeiro endereço e dados residenciais da República Tcheca hoje.

• Leia a referência da API: Verificação Residencial da República Tcheca
• Veja todas as validações de banco de dados: Preços e cobertura de validação de banco de dados
• Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, gratuitas.