Verificación de identidad en Panamá

La API de Verificación de Identidad de Verifik te ayuda a autenticar ciudadanos panameños 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 CCPA: Soporta Cédula de Identidad Personal (CCPA) para ciudadanos y residentes.
• Coincidencia de Identidad: Verifica que el nombre proporcionado coincida con el número CCPA.
• Verificación de Fecha de Nacimiento: Valida que la fecha de nacimiento coincida con los registros oficiales.

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.

Referencia de API

Endpoint

https://api.verifik.co/v2/pa/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: CCPA.
documentNumber	string	Sí	Cédula panameña completa tras la normalización (ver Formatos aceptados para documentNumber abajo).
dateOfBirth	string	Sí	Fecha de nacimiento en formato DD/MM/YYYY.

Formatos aceptados para documentNumber

La API acepta una cédula completa. Los valores se normalizan en el servidor: se recortan, pasan a mayúsculas y los separadores repetidos se colapsan a un solo guión. Espacios, /, _, . y caracteres tipo guión Unicode se tratan como separadores. Si el código de provincia y el sufijo AV o PI se ingresaron con un guión extra entre ellos (p. ej. 10-AV-1234-12345), se fusionan a 10AV-1234-12345 antes de validar.

Estructura: primerSegmento-libro-tomo

• Libro (segmento central): 1–4 dígitos
• Tomo (último segmento): 1–6 dígitos

Primer segmento (una de estas opciones):

1. Nacido en Panamá — Código de provincia 1, 2–9 o 10–13, luego libro y tomo. Ejemplos: 8-1234-12345, 4-56-789, 12-12-12345
2. Panameño nacido en el extranjero — Prefijo PE. Ejemplo: PE-1234-12345
3. Extranjero con cédula — Prefijo E. Ejemplos: E-1234-12345, E-8-102017
4. Naturalizado — Prefijo N. Ejemplo: N-1234-12345
5. Pre vigencia ley 2006 (AV) — Provincia seguida inmediatamente de AV. Ejemplo: 10AV-1234-12345
6. Población indígena (PI) — Provincia seguida inmediatamente de PI. Ejemplo: 1PI-1234-12345

Los códigos de provincia oficiales van del 1 al 13. Códigos inválidos (p. ej. 14) se rechazan.

Query strings: Envíe documentNumber de forma que se conserven los guiones. Algunos clientes o analizadores alteran valores como E-8-197698 (p. ej. notación científica); use query string cruda, codificación adecuada o una librería que mantenga el valor como cadena.

Error de validación: Si documentNumber no es una cédula completa válida tras la normalización, la API responde 409 con un mensaje de formato incorrecto (p. ej. Format incorrect: documentNumber).

Las reglas siguen el validador abierto cedula-panama (MIT).

Solicitud

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/pa/cedula", {
  params: { documentType: "CCPA", documentNumber: "8-1251-1829", dateOfBirth: "02/03/1992" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

PHP

<?php
$ch = curl_init("https://api.verifik.co/v2/pa/cedula");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Accept: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$query = http_build_query([
    "documentType" => "CCPA",
    "documentNumber" => "8-1251-1829",
    "dateOfBirth" => "02/03/1992"
]);
curl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/pa/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/pa/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CCPA", "documentNumber": "8-1251-1829", "dateOfBirth": "02/03/1992"}
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/pa/cedula?documentType=CCPA&documentNumber=8-1251-1829&dateOfBirth=02/03/1992"
    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": {
    "documentType": "CCPA",
    "documentNumber": "8-1251-1829",
    "firstName": "Roberto",
    "lastName": "Martínez",
    "fullName": "Roberto Martínez",
    "dateOfBirth": "1992-03-02",
    "status": "valid"
  },
  "signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
  "id": "PA001"
}

400

{
  "message": "Invalid document number",
  "code": "INVALID_DOCUMENT"
}

409

{
  "code": "MissingParameter",
  "message": "missing dateOfBirth"
}

401

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

500

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

Notas

• La fecha de nacimiento es requerida y debe coincidir con el titular de la identificación.
• Consulte Formatos aceptados para documentNumber para todos los patrones de cédula admitidos y el comportamiento de normalización.

---

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 panameño 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, Panamá y más allá.