API de Verificación de Páginas Amarillas de Nueva Zelanda (ES)

Incorporar usuarios en Nueva Zelanda implica confirmar su identidad. Esto verifica los datos de entrada contra los registros telefónicos electrónicos. Un documento o un detalle escrito solo prueba que los datos existen, no que sean genuinos o que pertenezcan a la persona en cuestión. La Verificación de Páginas Amarillas de Nueva Zelanda cierra esa brecha al cotejar los datos con fuentes autorizadas de direcciones. Esta guía explica qué hace la verificación, los detalles técnicos exactos y cómo integrarla en minutos.

Puntos clave:

• Qué verifica — La Verificación de Páginas Amarillas de Nueva Zelanda valida datos de direcciones contra fuentes autorizadas de datos de direcciones.
• Qué se obtiene — un match_type normalizado más resultados a nivel de campo que se pueden dirigir directamente a la lógica de aprobación/revisión/rechazo.
• Por qué es importante — La verificación de direcciones confirma que un solicitante vive donde dice, una señal fundamental contra el fraude y para el cumplimiento normativo.
• Cómo usarlo — un POST al endpoint de validación de base de datos de Didit, o un módulo de flujo de trabajo sin código. $0.25 por consulta concluyente, resultados en segundos.

Qué valida la Verificación de Páginas Amarillas de Nueva Zelanda

Verifica los datos de entrada contra los registros telefónicos electrónicos. Didit lo expone a través de un único endpoint para que pueda verificar los datos enviados contra fuentes autorizadas de datos de direcciones y recibir un resultado estructurado y normalizado, no un volcado de registro en bruto que tenga que analizar usted mismo.

Una respuesta concluyente devuelve los source_data coincidentes y un bloque validation por campo, para que su motor de riesgo obtenga un veredicto claro y legible por máquina.

Por qué es importante

La verificación de direcciones confirma que un solicitante vive donde dice, una señal fundamental contra el fraude y para el cumplimiento normativo.

Para las empresas reguladas en Nueva Zelanda — fintechs, plataformas de criptomonedas, prestamistas, mercados y operadores de juegos de azar — la verificación contra una fuente autorizada produce un registro defendible y auditable de que la identidad fue confirmada en la fuente, no simplemente capturada de un formulario o una foto.

Detalles técnicos

Didit expone este servicio a través del endpoint unificado de validación de bases de datos. Es un único POST, no se requiere SDK.

Endpoint

POST /v3/database-validation/

Parámetros de solicitud

Parámetro	Tipo	Requerido	Descripción
issuing_state	string	Sí	Código de país ISO 3166-1 alfa-3. Usar NZL.
services	string	Sí	Identificador de servicio. Usar nzl_zealand_yellow_pages.
first_name	string	Sí	Primer nombre.
last_name	string	Sí	Apellido.
address	string	Sí	Dirección.

Ejemplo de solicitud

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"

Ejemplo de respuesta (coincidencia concluyente)

{
  "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"
      }
    }
  ]
}

Rendimiento y facturación

• Latencia: típicamente un par de segundos.
• Costo: $0.25 por consulta concluyente. Solo se le factura por resultados concluyentes; no hay cargo por inactividad de la fuente, campos faltantes o rechazos previos a la fuente.
• Fiabilidad: funciona en la infraestructura de Didit con un objetivo de tiempo de actividad trimestral del 99.9%.

Casos de uso

• Fintech y neobancos — confirmar un titular de cuenta real y verificable antes de abrir una billetera o extender crédito en Nueva Zelanda.
• Cripto y Web3 — cumplir con los requisitos de incorporación de VASP con pruebas de identidad de fuente autorizada.
• Préstamos — reducir el fraude de identidad sintética y de primera parte con datos verificados en la fuente.
• Mercados y plataformas de trabajo temporal — verificar usuarios contra datos autorizados, no solo un formulario auto-reportado.
• iGaming — satisfacer las verificaciones de identidad y elegibilidad para jugadores de Nueva Zelanda con un registro auditable.

Cómo integrarse con Didit

Puede ejecutar la Verificación de Páginas Amarillas de Nueva Zelanda de dos maneras:

1. Flujo de trabajo sin código. En la Consola de Negocios de Didit, abra el Creador de Flujos de Trabajo, añada el módulo Validación de Base de Datos, seleccione Nueva Zelanda → Verificación de Páginas Amarillas de Nueva Zelanda y actívelo. Los usuarios coincidentes se enrutan automáticamente, sin necesidad de ingeniería.
2. API directa. Llame al endpoint /v3/database-validation/ mostrado arriba con services=nzl_zealand_yellow_pages. Lea match_type y el bloque validation por campo para impulsar su lógica de aprobación/revisión/rechazo.

Cada cuenta de Didit incluye 500 verificaciones gratuitas al mes, para que pueda probar el flujo completo de principio a fin antes de pagar por una sola consulta.

Preguntas frecuentes

¿Qué confirma la Verificación de Páginas Amarillas de Nueva Zelanda?

Valida los datos enviados contra fuentes autorizadas de datos de direcciones y devuelve un resultado de coincidencia normalizado, para que sepa si los datos de la dirección existen en la fuente autorizada y qué campos coincidieron.

¿Qué sucede si la fuente no está disponible temporalmente?

No se le cobra. La facturación solo se aplica a resultados concluyentes; la inactividad de la fuente, los campos faltantes y los rechazos previos a la fuente son gratuitos.

¿Qué tan rápida es la verificación?

La validación de la base de datos generalmente se devuelve en un par de segundos, por lo que encaja en un flujo de incorporación en tiempo real.

¿Necesito un SDK?

No. La verificación es un único POST HTTPS a un endpoint. También puede conectarlo a un flujo de trabajo sin código en la Consola de Negocios.

¿Listo para empezar?

Valide sus primeros datos de dirección de Nueva Zelanda hoy mismo.

• Lea la referencia de la API: Verificación de Páginas Amarillas de Nueva Zelanda
• Vea todas las validaciones de bases de datos: Precios y cobertura de la validación de bases de datos
• Empiece a construir: Cree una cuenta gratuita de Didit — 500 verificaciones al mes, gratis.