API de Verificação de Passaporte Chinês (PT-PT)

Integrar utilizadores na China significa confirmar que são quem afirmam ser. Verifica os dados de entrada em relação ao serviço de dados oficial na China. Um documento ou um detalhe digitado apenas prova que os dados existem — não que são genuínos ou pertencem à pessoa à sua frente. A Verificação de Passaporte Chinês preenche essa lacuna, verificando os dados junto à autoridade nacional de passaportes. 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 de Passaporte Chinês valida o passaporte junto à autoridade nacional de passaportes.
• O que obtém — um match_type normalizado, mais resultados ao nível do campo que pode encaminhar diretamente para a lógica de aprovação / revisão / rejeição.
• Por que é importante — A validação do número do passaporte junto à autoridade emissora deteta documentos de viagem forjados ou roubados que passam numa verificação visual.
• Como usar — um POST para o endpoint de validação de base de dados da Didit, ou um módulo de fluxo de trabalho sem código. $1.00 por consulta conclusiva, resultados em segundos.

O que a Verificação de Passaporte Chinês valida

Verifica os dados de entrada em relação ao serviço de dados oficial na China. A Didit expõe-o através de um único endpoint para que possa verificar os dados submetidos junto à autoridade nacional de passaportes e receber um resultado estruturado e normalizado — não um despejo de registo bruto que tenha de analisar por si mesmo.

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

Por que é importante

A validação do número do passaporte junto à autoridade emissora deteta documentos de viagem forjados ou roubados que passam numa verificação visual.

Para empresas reguladas na China — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — a verificação contra uma fonte autoritária produz um registo defensável e auditável de que a identidade foi confirmada na origem, e não apenas capturada de um formulário ou de uma foto.

Detalhes técnicos

A Didit expõe este serviço através do endpoint unificado de validação de base de dados. É um único POST — não é necessário SDK.

Endpoint

POST /v3/database-validation/

Parâmetros do pedido

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código do país ISO 3166-1 alfa-3. Use CHN.
services	string	Sim	Identificador de serviço. Use chn_passport_verification.
full_name	string	Sim	Nome completo.
date_of_birth	string	Sim	Data de nascimento.
national_id	string	Sim	Número de identificação nacional.
passport_number	string	Sim	Número do passaporte.

Exemplo de pedido

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=CHN" \
  -F "services=chn_passport_verification" \
  -F "full_name=John Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111" \
  -F "passport_number=A1234567"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "CHN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "chn_passport_verification",
      "service_name": "China Passport Verification",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "identification_number": "11010519900101003X",
        "verifications": {
          "date_of_birth": true,
          "identification_number": true
        }
      },
      "validation": {
        "date_of_birth": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: $1.00 por consulta conclusiva. A faturação aplica-se apenas a resultados conclusivos — sem custo para tempo de inatividade da fonte, campos em falta ou rejeições pré-fonte.
• Fiabilidade: funciona na infraestrutura da Didit com um objetivo de 99.9% de tempo de atividade trimestral.
• Consentimento: este serviço requer consentimento documentado do utilizador final. Capture e armazene-o antes de chamar o endpoint.

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 China.
• Cripto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autoritária.
• Empréstimos — reduza a fraude de identidade sintética e de primeira parte com dados verificados na origem.
• Mercados e plataformas de gig — verifique utilizadores contra dados autoritários, não apenas um formulário auto-reportado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores na China com um registo auditável.

Como integrar com a Didit

Pode executar a Verificação de Passaporte Chinês de duas maneiras:

1. Fluxo de trabalho sem código. Na Consola de Negócios da Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Validação de Base de Dados, selecione China → China Passport Verification e ative-o. Os utilizadores correspondentes são encaminhados automaticamente — sem necessidade de engenharia.
2. API Direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=chn_passport_verification. Leia o match_type e o bloco de validation por campo para impulsionar a sua lógica de aprovação / revisão / rejeição.

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

Perguntas frequentes

O que a verificação de passaporte chinês confirma?

Valida os dados submetidos junto à autoridade nacional de passaportes e retorna um resultado de correspondência normalizado, para que saiba se o passaporte existe na fonte autoritária e quais os campos que corresponderam.

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

Não é cobrado. A faturação aplica-se apenas a resultados conclusivos — tempo de inatividade da fonte, campos em falta e rejeições pré-fonte são gratuitos.

Quão rápida é a verificação?

A validação da base de dados retorna tipicamente em alguns segundos, por isso encaixa num fluxo de integração em tempo real.

Preciso de um SDK?

Não. A verificação é um único POST HTTPS para um endpoint. Também pode integrá-la num fluxo de trabalho sem código na Consola de Negócios.

Pronto para começar?

Valide o seu primeiro passaporte chinês hoje mesmo.

• Leia a referência da API: Verificação de Passaporte Chinês
• Veja todas as validações da base de dados: Preços e cobertura da Validação da Base de Dados
• Comece a desenvolver: Crie uma conta Didit gratuita — 500 verificações por mês, grátis.