API de Verificació de Pàgines Grogues de Nova Zelanda (CA)

Incorporar usuaris a Nova Zelanda significa confirmar que són qui diuen ser. Es verifiquen les dades d'entrada amb registres telefònics electrònics. Un document o una dada introduïda només prova que la dada existeix, no que sigui genuïna o que pertanyi a la persona que teniu davant. La Verificació de Pàgines Grogues de Nova Zelanda tanca aquesta bretxa comprovant les dades amb fonts d'adreces autoritzades. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en minuts.

Punts clau:

• Què comprova — La Verificació de Pàgines Grogues de Nova Zelanda valida les dades d'adreces amb fonts de dades d'adreces autoritzades.
• Què s'obté — un match_type normalitzat més resultats a nivell de camp que es poden encaminar directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — La verificació d'adreces confirma que un sol·licitant viu on diu viure, un senyal fonamental contra el frau i de compliment.
• Com utilitzar-lo — un POST a l'endpoint de validació de bases de dades de Didit, o un mòdul de flux de treball sense codi. 0,25 $ per consulta concloent, resultats en segons.

Què valida la Verificació de Pàgines Grogues de Nova Zelanda

Verifica les dades d'entrada amb registres telefònics electrònics. Didit l'exposa a través d'un únic endpoint perquè pugueu verificar les dades enviades amb fonts de dades d'adreces autoritzades i rebre un resultat estructurat i normalitzat, no un bolcat de registre en brut que hàgiu d'analitzar vosaltres mateixos.

Una resposta concloent retorna les source_data coincidents i un bloc de validation per camp, de manera que el vostre motor de risc obté un veredicte clar i llegible per màquina.

Per què és important

La verificació d'adreces confirma que un sol·licitant viu on diu viure, un senyal fonamental contra el frau i de compliment.

Per a les empreses regulades a Nova Zelanda —fintechs, plataformes de criptomonedes, prestadors, mercats i operadors de jocs—, la comprovació amb una font autoritzada produeix un registre defensable i auditable que la identitat es va confirmar a la font, no només es va capturar d'un formulari o una foto.

Detalls tècnics

Didit exposa aquest servei a través de l'endpoint unificat de validació de bases de dades. És un únic POST, no es requereix SDK.

Endpoint

POST /v3/database-validation/

Paràmetres de la sol·licitud

Paràmetre	Tipus	Requerit	Descripció
issuing_state	string	Sí	Codi de país ISO 3166-1 alpha-3. Utilitzeu NZL.
services	string	Sí	Identificador del servei. Utilitzeu nzl_zealand_yellow_pages.
first_name	string	Sí	Nom.
last_name	string	Sí	Cognom.
address	string	Sí	Adreça.

Exemple de sol·licitud

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"

Exemple de resposta (coincidència concloent)

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

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 0,25 $ per consulta concloent. Només se us factura pels resultats concloents — no hi ha càrrec per temps d'inactivitat de la font, camps que falten o rebuigs previs a la font.
• Fiabilitat: s'executa a la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintechs i neobancs — confirmeu un titular de compte real i verificable abans d'obrir una cartera o concedir crèdits a Nova Zelanda.
• Cripto i Web3 — compliu els requisits d'incorporació de VASP amb una prova d'identitat de font autoritzada.
• Préstecs — reduïu el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes de serveis — verifiqueu els usuaris amb dades autoritzades, no només un formulari auto-informat.
• iGaming — compliu les comprovacions d'identitat i elegibilitat per als jugadors de Nova Zelanda amb un registre auditable.

Com integrar-se amb Didit

Podeu executar la Verificació de Pàgines Grogues de Nova Zelanda de dues maneres:

1. Flux de treball sense codi. A la Consola de Negocis de Didit, obriu el Creador de Fluxos de Treball, afegiu el mòdul Validació de Bases de Dades, seleccioneu Nova Zelanda → Verificació de Pàgines Grogues de Nova Zelanda i activeu-lo. Els usuaris que coincideixen s'encaminen automàticament — no es requereix enginyeria.
2. API directa. Truqueu a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=nzl_zealand_yellow_pages. Llegiu match_type i el bloc de validation per camp per impulsar la vostra lògica d'aprovació / revisió / rebuig.

Cada compte de Didit inclou 500 verificacions gratuïtes al mes, de manera que podeu provar el flux complet de principi a fi abans de pagar per una sola consulta.

Preguntes freqüents

Què confirma la comprovació de la Verificació de Pàgines Grogues de Nova Zelanda?

Valida les dades enviades amb fonts de dades d'adreces autoritzades i retorna un resultat de coincidència normalitzat, de manera que sàpigues si les dades d'adreces existeixen a la font autoritzada i quins camps han coincidit.

Què passa si la font no està disponible temporalment?

No se us cobrarà. La facturació només s'aplica als resultats concloents — el temps d'inactivitat de la font, els camps que falten i els rebuigs previs a la font són gratuïts.

Quina rapidesa té la comprovació?

La validació de la base de dades sol retornar-se en un parell de segons, de manera que s'adapta a un flux d'incorporació en temps real.

Necessito un SDK?

No. La comprovació és un únic POST HTTPS a un endpoint. També podeu connectar-lo a un flux de treball sense codi a la Consola de Negocis.

Llest per començar?

Valideu avui mateix les vostres primeres dades d'adreces de Nova Zelanda.

• Llegiu la referència de l'API: Verificació de Pàgines Grogues de Nova Zelanda
• Vegeu totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comenceu a construir: Creeu un compte Didit gratuït — 500 verificacions al mes, gratuïtes.