Vérification d'identité au Panama

L'API de vérification d'identité de Verifik vous permet d'authentifier les citoyens panaméens à partir des données officielles du gouvernement. Elle est conçue pour fluidifier vos processus KYC (Know Your Customer), prévenir la fraude et vous assurer de respecter sans effort toutes les exigences réglementaires.

Nous avons construit cette intégration pour les entreprises qui ont besoin d'un moyen rapide, sécurisé et automatisé de confirmer la véritable identité de leurs utilisateurs, employés ou clients.

Que valide cette API ?

Notre API se connecte directement aux registres officiels pour valider :

• Nom complet et numéro CCPA : prend en charge la Cédula de Identidad Personal (CCPA) pour les citoyens et résidents.
• Correspondance d'identité : confirme que le nom fourni correspond au numéro CCPA.
• Vérification de la date de naissance : valide que la date de naissance correspond aux registres officiels.

En vérifiant ces éléments, vous pouvez avoir la certitude que la personne avec qui vous traitez existe et possède un document valide, ce qui réduit considérablement les risques d'usurpation d'identité et de fraude.

Référence de l'API

Endpoint

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

Vérifiez les données CCPA (Cédula de Identidad Personal) panaméennes auprès des sources officielles du registre civil. Transmettez documentType (CCPA), un documentNumber normalisé et dateOfBirth au format JJ/MM/AAAA ; la réponse confirme que l'enregistrement d'identité est cohérent pour le KYC, l'onboarding clients et les contrôles de fraude.

En-têtes (Headers)

Nom	Valeur
Accept	application/json
Authorization	Bearer <token>

Paramètres

Nom	Type	Requis	Description
documentType	string	Oui	Type de document. Valeur autorisée : CCPA.
documentNumber	string	Oui	Cédula panaméenne complète après normalisation (voir Formats acceptés pour documentNumber ci-dessous).
dateOfBirth	string	Oui	Date de naissance au format JJ/MM/AAAA.

Formats acceptés pour documentNumber

L'API accepte une chaîne complète de cédula. Les valeurs sont normalisées côté serveur : espaces supprimés, mises en majuscules, séparateurs répétés réduits à un unique tiret. Les espaces, /, _, . et les caractères Unicode similaires à un tiret sont traités comme des séparateurs. Si un code de province et le suffixe AV ou PI ont été saisis avec un tiret supplémentaire entre eux (par ex. 10-AV-1234-12345), ils sont fusionnés en 10AV-1234-12345 avant validation.

Structure : firstSegment-libro-tomo

• Libro (segment du milieu) : 1 à 4 chiffres.
• Tomo (dernier segment) : 1 à 6 chiffres.

Premier segment (au choix) :

1. Né au Panama — code de province 1, 2–9 ou 10–13, suivi de libro puis tomo. Exemples : 8-1234-12345, 4-56-789, 12-12-12345.
2. Panaméen né à l'étranger — préfixe PE. Exemple : PE-1234-12345.
3. Étranger avec cédula — préfixe E. Exemples : E-1234-12345, E-8-102017.
4. Naturalisé — préfixe N. Exemple : N-1234-12345.
5. Registre civil pré-2006 (AV) — province immédiatement suivie de AV. Exemple : 10AV-1234-12345.
6. Indigène (PI) — province immédiatement suivie de PI. Exemple : 1PI-1234-12345.

Les codes de province officiels sont 1 à 13. Les codes invalides (par ex. 14) sont rejetés.

Chaînes de requête : transmettez documentNumber de sorte que les tirets soient préservés. Certains clients ou parseurs gèrent mal les valeurs comme E-8-197698 (par ex. notation scientifique) ; utilisez une chaîne brute, un encodage approprié ou une bibliothèque qui conserve la valeur sous forme de chaîne.

Erreur de validation : si documentNumber n'est pas une cédula complète et valide après normalisation, l'API répond par un 409 avec un message indiquant un format incorrect (par ex. Format incorrect: documentNumber).

Les règles de format s'alignent sur le validateur open source cedula-panama (MIT).

Requête (Request)

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

Réponse (Response)

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

Notes

• La date de naissance est requise et doit correspondre au titulaire de la pièce d'identité.
• Voir Formats acceptés pour documentNumber pour tous les motifs de cédula pris en charge et le comportement de normalisation.

---

Cas d'usage courants

• Fintech et banque : vérifiez les identités instantanément lors d'une ouverture de compte ou d'une demande de prêt.
• E-commerce et livraison : authentifiez les utilisateurs et coursiers avant qu'ils n'opèrent sur votre plateforme.
• RH et recrutement : validez les documents des candidats dans le cadre de votre processus d'embauche.
• Assurance et santé : confirmez les identités avant d'émettre des polices ou d'accorder des prestations médicales.

Sources officielles et fiabilité

Nous nous connectons directement aux sources officielles du gouvernement panaméen afin de vous garantir des informations vérifiées et à jour. Chaque requête est traitée dans le strict respect des normes de sécurité et de réglementation.

Avantages clés

• Conformité automatisée : simplifiez vos contrôles KYC pour prévenir la fraude sans ajouter de friction pour vos utilisateurs.
• Résultats instantanés : traitez les vérifications en quelques secondes, idéal pour l'onboarding numérique en temps réel.
• Données fiables : appuyez-vous sur des données issues directement des registres officiels.
• Intégration facile : connectez-vous aisément via notre API REST ou utilisez nos SDK compatibles.

Conformité et sécurité

Nous accordons la priorité à la sécurité de vos données. Verifik utilise un chiffrement avancé (HTTPS / TLS 1.3) et des normes strictes de gestion de la confidentialité pour garantir la confidentialité. Notre service est surveillé 24h/24 et 7j/7 et offre des contrôles d'accès basés sur les rôles pour sécuriser l'accès de votre équipe.

À propos de Verifik

Verifik est une plateforme leader pour la vérification d'identité, la conformité et la prévention de la fraude en Amérique latine. Nos API automatisent les processus KYC, KYB, AML et de validation biométrique, en connectant les entreprises à des sources de données officielles en Colombie, au Mexique, au Pérou, au Chili, en Uruguay, en Argentine, au Brésil, au Panama et au-delà.