API de verificació de Cédula a Veneçuela (CA)

Incorporar usuaris a Veneçuela implica confirmar que són qui diuen ser. Es verifica la Cédula veneçolana contra el registre civil del SAIME. Un document o una dada introduïda manualment només prova que la dada existeix, no que sigui genuïna o que pertanyi a la persona que tens al davant. La Verificació de Cédula de Veneçuela tanca aquesta bretxa comprovant les dades contra el registre oficial d'identitats del govern del país. Aquesta guia explica què fa la comprovació, els detalls tècnics exactes i com integrar-la en qüestió de minuts.

Punts clau:

• Què comprova — La Verificació de Cédula de Veneçuela valida el DNI nacional contra el registre oficial d'identitats del govern del país.
• Què obtens — Un match_type normalitzat més resultats a nivell de camp que pots encaminar directament a la lògica d'aprovació / revisió / rebuig.
• Per què és important — Un document es pot falsificar; un registre no. La validació de la identificació contra la font governamental autoritzada confirma que el titular és real i està correctament identificat.
• 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,20 $ per consulta concloent, resultats en segons.

Què valida la Verificació de Cédula de Veneçuela

Verifica la Cédula veneçolana contra el registre civil del SAIME. Didit ho exposa a través d'un únic endpoint perquè puguis verificar les dades enviades contra el registre oficial d'identitats del govern del país i rebre un resultat estructurat i normalitzat, no un bolcat de registre brut que hagis de processar tu mateix.

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

Per què és important

Un document es pot falsificar; un registre no. La validació de la identificació contra la font governamental autoritzada confirma que el titular és real i està correctament identificat.

Per a les empreses regulades a Veneçuela —fintechs, plataformes cripto, prestadors, mercats i operadors de jocs—, la comprovació contra 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 alfa-3. Utilitza VEN.
services	string	Sí	Identificador del servei. Utilitza ven_cedula.
document_number	string	Sí	Número de document.
first_name	string	No	Nom (comprovació creuada opcional).
last_name	string	No	Cognom (comprovació creuada opcional).

Exemple de sol·licitud

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=VEN" \
  -F "services=ven_cedula" \
  -F "document_number=1111111"

Exemple de resposta (coincidència concloent)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "VEN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "ven_cedula",
      "service_name": "Venezuela - Cédula verification",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "document_type": "sample_value",
        "first_name": "John",
        "full_name": "John Doe",
        "gender": "M",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Rendiment i facturació

• Latència: normalment un parell de segons.
• Cost: 0,20 $ per consulta concloent. Se't factura només pels resultats concloents — sense càrrec per temps d'inactivitat de la font, camps que falten o rebuigs previs a la font.
• Fiabilitat: funciona a la infraestructura de Didit amb un objectiu de temps d'activitat trimestral del 99,9%.

Casos d'ús

• Fintech i neobancs — confirma un titular de compte real i verificable abans d'obrir una cartera o concedir crèdit a Veneçuela.
• Crypto i Web3 — compleix els requisits d'incorporació de VASP amb proves d'identitat de font autoritzada.
• Préstecs — redueix el frau d'identitat sintètica i de primera part amb dades verificades per la font.
• Mercats i plataformes de serveis — verifica usuaris contra dades autoritzades, no només un formulari autodeclarat.
• iGaming — satisfà les comprovacions d'identitat i elegibilitat per als jugadors de Veneçuela amb un registre auditable.

Com integrar-se amb Didit

Pots executar la Verificació de Cédula de Veneçuela de dues maneres:

1. Flux de treball sense codi. A la Consola de Negoci de Didit, obre el Constructor de Fluxos de Treball, afegeix el mòdul Validació de Base de Dades, selecciona Veneçuela → Verificació de Cédula de Veneçuela i activa'l. Els usuaris que coincideixen s'encaminen automàticament, sense necessitat d'enginyeria.
2. API directa. Truca a l'endpoint /v3/database-validation/ mostrat anteriorment amb services=ven_cedula. Llegeix match_type i el bloc de validation per camp per impulsar la teva lògica d'aprovació / revisió / rebuig.

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

Preguntes freqüents

Què confirma la comprovació de Verificació de Cédula de Veneçuela?

Valida les dades enviades contra el registre oficial d'identitats del govern del país i retorna un resultat de coincidència normalitzat, de manera que saps si el DNI nacional existeix a la font autoritzada i quins camps van coincidir.

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

No se't cobra. La facturació només s'aplica a 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 en un parell de segons, així que encaixa dins d'un flux d'incorporació en temps real.

Necessito un SDK?

No. La comprovació és un únic POST HTTPS a un endpoint. També la pots connectar a un flux de treball sense codi a la Consola de Negoci.

Llest per començar?

Valida avui mateix la teva primera Cédula nacional de Veneçuela.

• Llegeix la referència de l'API: Verificació de Cédula de Veneçuela
• Consulta totes les validacions de bases de dades: Preus i cobertura de la validació de bases de dades
• Comença a construir: Crea un compte Didit gratuït — 500 verificacions al mes, gratis.