Skip to main content

パナマの本人確認

Verifik の本人確認 API は、公的な政府データを利用してパナマ市民を認証します。KYC（Know Your Customer）プロセスの効率化、不正防止、各種規制要件への対応を簡単に実現できるよう設計されています。

ユーザー、従業員、顧客の真の本人性を、迅速・安全・自動的に確認したいビジネス向けに構築しました。

この API は何を検証しますか？​

本 API は公式記録と直接接続し、以下を検証します。

  • 氏名と CCPA 番号: 市民・居住者向けの Cédula de Identidad Personal（CCPA）に対応します。
  • 本人一致: 入力された氏名が CCPA 番号と一致するかを確認します。
  • 生年月日の検証: 生年月日が公式記録と一致するかを検証します。

これらを検証することで、相手が実在し有効な文書を保有していることを確認でき、なりすましや不正のリスクを大幅に低減できます。

API リファレンス​

エンドポイント​

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

パナマの CCPA（Cédula de Identidad Personal）データを公式戸籍ソースに対して検証します。documentType（CCPA）、正規化済みの documentNumber、DD/MM/YYYY 形式の dateOfBirth を送信すると、レスポンスは本人確認レコードの整合性を確認し、KYC、顧客オンボーディング、不正防止管理に活用できます。

ヘッダー​

名前値
Acceptapplication/json
AuthorizationBearer <token>

パラメーター​

名前型必須説明
documentTypestringはい文書タイプ。許可される値: CCPA。
documentNumberstringはい正規化後のパナマ cédula 全体（下記の documentNumber の許容フォーマット を参照）。
dateOfBirthstringはい生年月日（DD/MM/YYYY 形式）。

documentNumber の許容フォーマット​

本 API は 完全な cédula 文字列を受け付けます。値はサーバー側で 正規化 されます（前後の空白除去、大文字化、連続する区切り文字を単一のハイフンに圧縮）。スペース、/、_、.、Unicode のダッシュ類似文字は区切り文字として扱われます。州コードと接尾辞 AV または PI の間にハイフンが余分に入っている場合（例: 10-AV-1234-12345）、検証前に 10AV-1234-12345 に統合されます。

構造: firstSegment-libro-tomo

  • Libro（中央セグメント）: 1〜4 桁
  • Tomo（末尾セグメント）: 1〜6 桁

先頭セグメント（いずれか）:

  1. パナマ生まれ — 州コード 1、2〜9、または 10〜13、その後 libro、tomo。例: 8-1234-12345、4-56-789、12-12-12345
  2. 海外生まれのパナマ人 — 接頭辞 PE。例: PE-1234-12345
  3. cédula を持つ外国人 — 接頭辞 E。例: E-1234-12345、E-8-102017
  4. 帰化 — 接頭辞 N。例: N-1234-12345
  5. 2006 年以前の戸籍登録（AV） — 州コードの直後に AV。例: 10AV-1234-12345
  6. 先住民（PI） — 州コードの直後に PI。例: 1PI-1234-12345

公式の州コードは 1〜13 です。無効なコード（例: 14）は拒否されます。

クエリ文字列: documentNumber を送信し、ハイフンが保持される ようにしてください。一部のクライアントやパーサーは E-8-197698 のような値を誤って解釈する場合があります（例: 指数表記）。生のクエリ文字列、適切なエンコーディング、または値を文字列のまま保持するライブラリを使用してください。

バリデーションエラー: 正規化後に documentNumber が完全に有効な cédula でない場合、API は 409 とフォーマットの誤りを示すメッセージ（例: Format incorrect: documentNumber）を返します。

フォーマット規則は、オープンソースの cedula-panama バリデーター（MIT ライセンス）に整合しています。

リクエスト​

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

レスポンス​

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

注意事項​

  • 生年月日は必須であり、ID 所持者と一致する必要があります。
  • サポートされる cédula のパターンと正規化の挙動については documentNumber の許容フォーマット を参照してください。

一般的なユースケース​

  • フィンテックと銀行: 口座開設や融資申請の際に本人確認を即時実施します。
  • EC と配送: プラットフォーム稼働前にユーザーや配達員を認証します。
  • HR と採用: 採用ワークフローの一部として候補者の文書を検証します。
  • 保険と医療: 保険契約や医療給付の前に本人を確認します。

公式ソースと信頼性​

パナマの公的な政府ソースと直接接続し、検証済みかつ最新の情報を提供します。 すべての照会は厳格なセキュリティおよび規制基準に基づいて処理されます。

主な利点​

  • 自動化されたコンプライアンス: ユーザー体験を損なうことなく KYC チェックを効率化し、不正を防止します。
  • 即時の結果: 数秒で照会を処理できるため、リアルタイムでのデジタルオンボーディングに最適です。
  • 信頼できるデータ: 公式記録から直接取得したデータを利用できます。
  • 容易な統合: REST API または互換 SDK を通じて簡単に接続できます。

コンプライアンスとセキュリティ​

データの安全性を最優先します。Verifik は高度な暗号化（HTTPS / TLS 1.3）と厳格なプライバシー管理基準を採用し、機密性を確保します。 当サービスは可用性を 24 時間 365 日監視しており、チームのアクセスを安全に保つロールベースのアクセス制御を提供します。

Verifik について​

Verifik は、ラテンアメリカ全域における本人確認、コンプライアンス、不正防止のためのリーディングプラットフォームです。 当社の API は KYC、KYB、AML、生体検証プロセスを自動化し、コロンビア、メキシコ、ペルー、チリ、ウルグアイ、アルゼンチン、ブラジル、パナマなどの公式データソースとビジネスを接続します。