Verificação de identidade no Panamá

A API de verificação de identidade da Verifik permite autenticar cidadãos panamenhos usando dados oficiais do governo. Foi projetada para automatizar seus processos de KYC (Know Your Customer), prevenir fraudes e garantir o cumprimento de todos os requisitos regulatórios sem esforço.

Construímos esta integração para empresas que precisam de uma forma rápida, segura e automatizada de confirmar a verdadeira identidade de usuários, funcionários ou clientes.

O que esta API valida?

Nossa API conecta-se diretamente aos registros oficiais para validar:

• Nome completo e número da CCPA: suporta a Cédula de Identidad Personal (CCPA) para cidadãos e residentes.
• Correspondência de identidade: confirma que o nome informado corresponde ao número da CCPA.
• Verificação de data de nascimento: valida se a data de nascimento corresponde aos registros oficiais.

Ao validar esses elementos, você pode confiar que a pessoa com quem está negociando é real e possui um documento válido, reduzindo significativamente os riscos de personificação e fraude.

Referência da API

Endpoint

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

Verifique dados da CCPA (Cédula de Identidad Personal) panamenha contra fontes oficiais do registro civil. Envie documentType (CCPA), um documentNumber normalizado e dateOfBirth em DD/MM/AAAA; a resposta confirma que o registro de identidade está consistente para KYC, onboarding de clientes e controles de fraude.

Cabeçalhos

Nome	Valor
Accept	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição
documentType	string	Sim	Tipo de documento. Valor permitido: CCPA.
documentNumber	string	Sim	Cédula panamenha completa após normalização (consulte Formatos aceitos de documentNumber abaixo).
dateOfBirth	string	Sim	Data de nascimento no formato DD/MM/AAAA.

Formatos aceitos de documentNumber

A API aceita uma string completa de cédula. Os valores são normalizados no servidor: trimados, em maiúsculas, separadores repetidos colapsados em um único hífen. Espaços, /, _, . e caracteres tipo traço Unicode são tratados como separadores. Se um código de província e o sufixo AV ou PI forem inseridos com um hífen extra entre eles (ex.: 10-AV-1234-12345), são mesclados para 10AV-1234-12345 antes da validação.

Estrutura: primeiroSegmento-libro-tomo

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

Primeiro segmento (um dos):

1. Nascido no Panamá — Código de província 1, 2–9 ou 10–13, seguido por libro e tomo. Exemplos: 8-1234-12345, 4-56-789, 12-12-12345
2. Panamenho nascido no exterior — Prefixo PE. Exemplo: PE-1234-12345
3. Estrangeiro com cédula — Prefixo E. Exemplos: E-1234-12345, E-8-102017
4. Naturalizado — Prefixo N. Exemplo: N-1234-12345
5. Registro civil pré-2006 (AV) — Província imediatamente seguida por AV. Exemplo: 10AV-1234-12345
6. Indígena (PI) — Província imediatamente seguida por PI. Exemplo: 1PI-1234-12345

Os códigos oficiais de província são 1–13. Códigos inválidos (ex.: 14) são rejeitados.

Query strings: envie documentNumber de forma que os hífens sejam preservados. Alguns clientes ou parsers manipulam mal valores como E-8-197698 (ex.: notação científica); use uma query string bruta, codificação adequada ou uma biblioteca que mantenha o valor como string.

Erro de validação: se documentNumber não for uma cédula válida e completa após a normalização, a API responde com 409 e uma mensagem indicando formato incorreto (ex.: Format incorrect: documentNumber).

As regras de formato seguem o validador open source cedula-panama (MIT).

Requisição

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)
}

Resposta

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."
}

Observações

• A data de nascimento é obrigatória e deve corresponder ao titular do documento.
• Consulte Formatos aceitos de documentNumber para todos os padrões de cédula suportados e o comportamento de normalização.

---

Casos de uso comuns

• Fintech e bancos: verifique identidades instantaneamente durante a abertura de contas ou solicitações de empréstimo.
• E-commerce e entregas: autentique usuários e entregadores antes que se tornem ativos em sua plataforma.
• RH e recrutamento: valide documentos de candidatos como parte do seu fluxo de contratação.
• Seguros e saúde: confirme identidades antes de emitir apólices ou conceder benefícios médicos.

Fontes oficiais e confiabilidade

Conectamo-nos diretamente às fontes oficiais do governo panamenho para garantir que você receba informações verificadas e atualizadas. Cada consulta é tratada com estrita aderência a padrões de segurança e regulação.

Principais benefícios

• Conformidade automatizada: simplifique seus controles de KYC para prevenir fraudes sem adicionar atrito para seus usuários.
• Resultados instantâneos: processe verificações em segundos, ideal para onboarding digital em tempo real.
• Dados confiáveis: apoie-se em dados obtidos diretamente dos registros oficiais.
• Integração simples: conecte-se facilmente via nossa API REST ou utilize nossos SDKs compatíveis.

Conformidade e segurança

Priorizamos a segurança dos seus dados. A Verifik utiliza criptografia avançada (HTTPS / TLS 1.3) e padrões rigorosos de gerenciamento de privacidade para garantir a confidencialidade. Nosso serviço é monitorado 24/7 quanto à disponibilidade e oferece controles de acesso baseados em funções para manter o acesso da sua equipe seguro.

Sobre a Verifik

A Verifik é uma plataforma líder em verificação de identidade, conformidade e prevenção a fraudes em toda a América Latina. Nossas APIs automatizam processos de KYC, KYB, AML e validação biométrica, conectando empresas a fontes de dados oficiais na Colômbia, México, Peru, Chile, Uruguai, Argentina, Brasil, Panamá e além.