🇵🇪 ペルー — DNI(拡張データ)
Verifik の本人確認 API を使用すると、ペルー市民の DNI(Documento Nacional de Identidad)番号で拡張本人確認を実行できます。KYC(Know Your Customer)プロセスの効率化、不正防止、各種規制要件への対応を簡単に実現できるよう設計されています。
氏名、配偶者の有無、生年月日、住所の詳細(省、地域、居住地区)および関連する本人情報フィールドに、迅速・安全・自動的にアクセスする必要があるビジネス向けに構築しました。
この情報に安全にアクセスするには Authorization ヘッダーが必要です。
この API は何を検証しますか?
本 API はペルーの公式記録と直接接続し、以下を検証します。
- 氏名と DNI 番号: Documento Nacional de Identidad(DNI)文書をサポートします。
- 本人一致: 入力された氏名が DNI 番号と一致するかを確認します。
- 拡張個人情報: 配偶者の有無、生年月日、性別、住所、省、地域、居住地区を返します。
- 氏名の構成要素:
firstName、lastName、paternalLastName、maternalLastName、arrayNameを返します。 - 文書情報: 文書種別と番号を返します。
一部のフィールドはレスポンスに常に含まれますが、現在は文字列 not_available を返します(省略されません): photo、expeditionDate、expirationDate、ubigeoReniec、verificationDigit。このエンドポイントでは現在、写真は提供されていません。
これらを検証することで、相手が実在し有効な文書を保有していることを確認でき、なりすましや不正のリスクを大幅に低減できます。
エンドポイント
GET https://api.verifik.co/v3/pe/cedula/extra
ペルー国民の DNI 拡張照会です。氏名、配偶者の有無、生年月日、住所(省、地域、居住地区)および関連する本人情報フィールドを返します。documentType=DNI と 8 桁の documentNumber を指定します。
photo、expeditionDate、expirationDate、ubigeoReniec、verificationDigit はレスポンスの構造に含まれますが、現在は not_available を返します。
ヘッダー(Headers)
| 名前 | 値 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
パラメーター(Parameters)
| 名前 | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
documentType | string | はい | 文書種別。許可値は DNI のみ。 | DNI |
documentNumber | string | はい | 8 桁の DNI 番号(スペースなし)。 | 44868598 |
リクエスト(Request)
- JavaScript
- Python
- Ruby
- cURL
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.verifik.co/v3/pe/cedula/extra',
params: {
documentType: 'DNI',
documentNumber: '44868598'
},
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer <あなたのトークン>'
}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
import requests
url = "https://api.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=44868598"
payload = {}
headers = {
'Authorization': 'Bearer <token>'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "net/http"
url = URI("https://api.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=44868598")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer <token>"
response = https.request(request)
puts response.read_body
curl --location --request GET 'https://api.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=44868598' \
--header 'Authorization: Bearer <token>'
レスポンス(Response)
- 200
- 404
- 409 - パラメーター不足
- 409 - 不正な documentType
{
"data": {
"address": "SAN MARTIN-SAN MARTIN-SHAPAJA",
"arrayName": [
"JORGE",
"EDUARDO",
"VARGAS",
"RAMIREZ"
],
"civilStatus": "SOLTERO",
"dateOfBirth": "03-04-1986",
"documentNumber": "44868598",
"documentType": "DNI",
"expeditionDate": "not_available",
"expirationDate": "not_available",
"firstName": "JORGE EDUARDO",
"fullName": "JORGE EDUARDO VARGAS RAMIREZ",
"lastName": "VARGAS RAMIREZ",
"maternalLastName": "RAMIREZ",
"paternalLastName": "VARGAS",
"photo": "not_available",
"sex": "M",
"ubigeoReniec": "not_available",
"verificationDigit": "not_available",
"province": "SAN MARTIN",
"area": "SAN MARTIN",
"homeDistrict": "SHAPAJA"
},
"signature": {
"dateTime": "October 5, 2026 7:00 PM",
"message": "Certified by Verifik.co"
},
"id": "G2ZOZ"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [DNI]"
}
レスポンスフィールド
| フィールド | 典型的な値 | 備考 |
|---|---|---|
address、province、area、homeDistrict | 値が入った文字列 | RENIEC 記録からの住所の詳細。 |
arrayName、firstName、lastName、paternalLastName、maternalLastName、fullName | 値が入った文字列 | 氏名の構成要素。 |
civilStatus、dateOfBirth、sex | 値が入った文字列 | 人口統計データ。 |
documentType、documentNumber | 値が入った文字列 | DNI 識別子。 |
photo、expeditionDate、expirationDate、ubigeoReniec、verificationDigit | not_available | レスポンスに含まれますが、現在のプロダクトティアでは値が入りません。 |
一般的なユースケース
- 高度な KYC プロセス: 包括的な本人確認によりコンプライアンスと不正検知を強化します。
- 金融サービス: 銀行・金融サービスの申請における詳細な本人情報を検証します。
- 雇用確認: 採用プロセスにおける包括的な個人情報を確認します。
- コンプライアンスとデューデリジェンス: 拡張本人情報を要求するペルーの規制に準拠します。
- 不正検知: 拡張された人口統計情報と住所データを活用し、高度な不正防止を行います。
公式ソースと信頼性
ペルー政府の公式ソース(RENIEC)と直接接続し、検証済みかつ最新の情報を提供します。 すべての照会は厳格なセキュリティおよび規制基準に基づいて処理されます。
主な利点
- 自動化されたコンプライアンス: ユーザー体験を損なうことなく KYC チェックを自動化し、不正を防止します。
- 拡張データへのアクセス: 住所、配偶者の有無、人口統計情報を含む包括的な本人情報を取得できます。
- 即時の結果: 数秒で照会を処理できるため、リアルタイム本人確認に最適です。
- 信頼できるデータ: 公式 RENIEC 記録から直接取得したデータを利用できます。
- 容易な統合: REST API または互換 SDK を通じて簡単に接続できます。
コンプライアンスとセキュリティ
データの安全性を最優先します。Verifik は高度な暗号化(HTTPS / TLS 1.3)と厳格なプライバシー管理基準を採用し、機密性を確保します。 当サービスは可用性を 24 時間 365 日監視しており、チームのアクセスを安全に保つロールベースのアクセス制御を提供します。
Verifik について
Verifik は、ラテンアメリカ全域における本人確認、コンプライアンス、不正防止のためのリーディングプラットフォームです。 当社の API は KYC、KYB、AML、生体検証プロセスを自動化し、コロンビア、メキシコ、ペルー、チリ、ウルグアイ、アルゼンチン、ブラジルなどの公式データソースとビジネスを接続します。