API de Verificação de Páginas Amarelas da Nova Zelândia (PT-PT)

Integrar utilizadores na Nova Zelândia significa confirmar que são quem dizem ser. Verifica os dados de entrada em relação aos registos telefónicos eletrónicos. 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 Páginas Amarelas da Nova Zelândia preenche essa lacuna, verificando os dados contra fontes de dados de endereços autorizadas. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais conclusões:

• O que verifica — A Verificação de Páginas Amarelas da Nova Zelândia valida dados de endereços contra fontes de dados de endereços autorizadas.
• O que recebe — um match_type normalizado, mais resultados ao nível do campo que pode direcionar diretamente para a lógica de aprovação / revisão / rejeição.
• Por que é importante — A verificação de endereço confirma que um candidato vive onde afirma — um sinal central antifraude e de conformidade.
• 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. 0,25$ por consulta conclusiva, resultados em segundos.

O que a Verificação de Páginas Amarelas da Nova Zelândia valida

Verifica os dados de entrada em relação aos registos telefónicos eletrónicos. A Didit expõe este serviço através de um único endpoint para que possa verificar os dados submetidos contra fontes de dados de endereços autorizadas e receber um resultado estruturado e normalizado — não um despejo de registo bruto que terá 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 verificação de endereço confirma que um candidato vive onde afirma — um sinal central antifraude e de conformidade.

Para empresas regulamentadas na Nova Zelândia — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — a verificação contra uma fonte autorizada produz um registo defensável e auditável de que a identidade foi confirmada na origem, 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 de país ISO 3166-1 alpha-3. Use NZL.
services	string	Sim	Identificador de serviço. Use nzl_zealand_yellow_pages.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Último nome.
address	string	Sim	Endereço.

Exemplo de pedido

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=NZL" \
  -F "services=nzl_zealand_yellow_pages" \
  -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": "NZL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "nzl_zealand_yellow_pages",
      "service_name": "New Zealand Yellow Pages",
      "source_data": {
        "address": "123 Sample Street",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: 0,25$ por consulta conclusiva. É faturado apenas por resultados conclusivos — sem cobrança por inatividade da fonte, campos em falta ou rejeições pré-fonte.
• Fiabilidade: executa na infraestrutura da Didit com um objetivo 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 Nova Zelândia.
• Criptomoedas e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autorizada.
• Empréstimos — reduza a fraude de identidade sintética e de primeira parte com dados verificados na origem.
• Mercados e plataformas de gig economy — verifique utilizadores contra dados autorizados, não apenas um formulário auto-reportado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores da Nova Zelândia com um registo auditável.

Como integrar com a Didit

Pode executar a Verificação de Páginas Amarelas da Nova Zelândia de duas formas:

1. Fluxo de trabalho sem código. Na Consola de Negócios Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Validação de Base de Dados, selecione Nova Zelândia → Verificação de Páginas Amarelas da Nova Zelândia 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=nzl_zealand_yellow_pages. Leia 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 todo o fluxo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação de Páginas Amarelas da Nova Zelândia confirma?

Valida os dados submetidos contra fontes de dados de endereços autorizadas e retorna um resultado de correspondência normalizado, para que saiba se os dados de endereço existem na fonte autorizada 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 — 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 geralmente retorna em alguns segundos, por isso, encaixa-se 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 ligá-la a um fluxo de trabalho sem código na Consola de Negócios.

Pronto para começar?

Valide os seus primeiros dados de endereço da Nova Zelândia hoje.

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