Verificación de identidad en Guatemala

La API de Verificación de Identidad de Verifik te ayuda a autenticar ciudadanos guatemaltecos usando datos oficiales del gobierno. Está diseñada para agilizar tus procesos de KYC (Conozca a su Cliente), prevenir fraudes y asegurar el cumplimiento normativo sin complicaciones.

Creamos esta integración para empresas que necesitan una forma rápida, segura y automatizada de confirmar la verdadera identidad de usuarios, empleados o clientes.

¿Qué valida esta API?

Nuestra API se conecta directamente con registros oficiales para validar:

• Nombre Completo y Número CUI: Soporta Cédula de Vecindad o Documento Personal de Identificación (CUI).
• Coincidencia de Identidad: Verifica que el nombre proporcionado coincida con el número CUI.
• Verificación de Fecha de Nacimiento: Valida que la fecha de nacimiento coincida con los registros oficiales del SAT.

Al verificar estos detalles, puedes tener la certeza de que la persona con la que tratas es real y posee un documento válido, reduciendo significativamente el riesgo de suplantación y fraude.

Verifica un ciudadano guatemalteco usando documentType CUI, documentNumber y dateOfBirth (DD/MM/YYYY). Devuelve campos de identidad para apoyar KYC y cumplimiento.

Referencia de API

Endpoint

https://api.verifik.co/v2/gt/cedula

Encabezados

Nombre	Valor
Accept	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
documentType	string	Sí	Tipo de documento. Valor permitido: CUI.
documentNumber	string	Sí	Número de documento.
dateOfBirth	string	Sí	Fecha de nacimiento (DD/MM/YYYY).

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/gt/cedula", {
  params: { documentType: "CUI", documentNumber: "2222624190903", dateOfBirth: "12/03/1984" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

PHP

<?php
$ch = curl_init("https://api.verifik.co/v2/gt/cedula");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Accept: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$query = http_build_query([
    "documentType" => "CUI",
    "documentNumber" => "2222624190903",
    "dateOfBirth" => "12/03/1984"
]);
curl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/gt/cedula?".$query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import os, requests

url = "https://api.verifik.co/v2/gt/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CUI", "documentNumber": "2222624190903", "dateOfBirth": "12/03/1984"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Go

package main

import (
    "fmt"
    "net/http"
)

func main() {
    url := "https://api.verifik.co/v2/gt/cedula?documentType=CUI&documentNumber=2222624190903&dateOfBirth=12/03/1984"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Authorization", "Bearer "+getenv("VERIFIK_TOKEN"))
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    fmt.Println(resp.Status)
}

Respuesta

200

{
  "data": {
    "arrayName": [
      "ERICK",
      "ROBERTO",
      "RAMIREZ",
      "MORALES"
    ],
    "documentNumber": "2222624190903",
    "documentType": "CUI",
    "firstName": "ERICK ROBERTO",
    "fullName": "ERICK ROBERTO RAMIREZ MORALES",
    "lastName": "RAMIREZ MORALES"
  },
  "signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
  "id": "GT001"
}

409

{
  "code": "MissingParameter",
  "message": "missing documentType\n. missing documentNumber\n. missing dateOfBirth\n"
}

401

{
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

500

{
    "code": "InternalServerError",
    "message": "Server error."
}

Notas

• documentType debe ser CUI.
• dateOfBirth es obligatorio y debe usar el formato DD/MM/YYYY (por ejemplo, 12/03/1984).

---

Casos de Uso Comunes

• Fintech y Banca: Verifica identidades al instante durante la apertura de cuentas o solicitudes de crédito.
• E-commerce y Delivery: Autentica usuarios y repartidores antes de que se activen en tu plataforma.
• Recursos Humanos y Reclutamiento: Valida documentos de candidatos como parte de tu proceso de contratación.
• Seguros y Salud: Confirma identidades antes de emitir pólizas o proporcionar beneficios médicos.

Fuentes Oficiales y Confiabilidad

Nos conectamos directamente con fuentes oficiales del gobierno guatemalteco para asegurar que recibas información verificada y actualizada al minuto. Cada consulta se maneja con estricto cumplimiento de estándares de seguridad y regulatorios.

Beneficios Clave

• Cumplimiento Automatizado: Agiliza tus verificaciones KYC para prevenir fraudes sin agregar fricción a tus usuarios.
• Resultados Instantáneos: Procesa verificaciones en segundos, perfecto para onboarding digital en tiempo real.
• Datos Confiables: Confía en datos obtenidos directamente de registros oficiales.
• Integración Sencilla: Conéctate fácilmente vía nuestra API REST o usa nuestros SDKs compatibles.

Cumplimiento y Seguridad

Priorizamos la seguridad de tus datos. Verifik usa encriptación avanzada (HTTPS/TLS 1.3) y estándares estrictos de gestión de privacidad para garantizar la confidencialidad. Nuestro servicio está monitoreado 24/7 para disponibilidad y ofrece controles de acceso basados en roles para mantener seguro el acceso de tu equipo.

Sobre Verifik

Verifik es una plataforma líder en verificación de identidad, cumplimiento y prevención de fraude en América Latina. Nuestras APIs automatizan procesos de KYC, KYB, AML y validación biométrica, conectando empresas con fuentes oficiales de datos en Colombia, México, Perú, Chile, Uruguay, Argentina, Brasil, Guatemala y más allá.