Vérification d'identité au Panama

L'API de vérification d'identité de Verifik vous permet d'authentifier les citoyens panaméens. 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 valide :

• 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.

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. Transmettez documentType (CCPA) et un documentNumber normalisé ; 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).

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. Série AV pré-2006 — 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 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 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" },
  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"
]);
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"}
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"
    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"
  },
  "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 documentNumber"
}

401

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

500

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

Notes

• 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.

Fiabilité

Nous fournissons des informations d’identité vérifiées et à jour pour les contrôles CCPA au Panama. 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 dossiers d’identité vérifiés.
• 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 à une couverture de vérification d’identité en Colombie, au Mexique, au Pérou, au Chili, en Uruguay, en Argentine, au Brésil, au Panama et au-delà.