๐ต๐ช ํ๋ฃจ โ DNI(ํ์ฅ ์ ๋ณด)
Verifik์ ์ ์ ํ์ธ API๋ ํ๋ฃจ ์๋ฏผ์ DNI(Documento Nacional de Identidad) ๋ฒํธ๋ก ํ์ฅ๋ ์ ์ ์ ๋ณด๋ฅผ ์กฐํํ ์ ์๊ฒ ํด ์ค๋๋ค. KYC(Know Your Customer) ์ ์ฐจ๋ฅผ ์๋ํํ๊ณ , ์ฌ๊ธฐ๋ฅผ ์๋ฐฉํ๋ฉฐ, ๊ท์ ์๊ตฌ์ฌํญ์ ์์ฝ๊ฒ ์ถฉ์กฑํ ์ ์๋๋ก ์ค๊ณ๋์์ต๋๋ค.
์ฑ๋ช , ์๋ฏผ ์ํ, ์ถ์์ผ, ๋ฌธ์ ์ ๋ณด, ์ฃผ์, ์ฌ์ง์ ํฌํจํ ์ข ํฉ ๊ฐ์ธ ์ ๋ณด๋ฅผ ๋น ๋ฅด๊ณ ์์ ํ๊ฒ ์๋์ผ๋ก ์กฐํํด์ผ ํ๋ ๋น์ฆ๋์ค๋ฅผ ์ํด ๋ง๋ค์ด์ก์ต๋๋ค.
์ด ์ ๋ณด์ ์์ ํ๊ฒ ์ ๊ทผํ๋ ค๋ฉด Authorization ํค๋๊ฐ ํ์ํฉ๋๋ค.
์ด API๋ ๋ฌด์์ ๊ฒ์ฆํฉ๋๊น?โ
๋น์ฌ์ API๋ ํ๋ฃจ์ ๊ณต์ ๊ธฐ๋ก๊ณผ ์ง์ ์ฐ๊ฒฐ๋์ด ๋ค์์ ๊ฒ์ฆํฉ๋๋ค.
- ์ฑ๋ช ๋ฐ DNI ๋ฒํธ: Documento Nacional de Identidad(DNI) ๋ฌธ์๋ฅผ ์ง์ํฉ๋๋ค.
- ์ ์ ์ผ์น ์ฌ๋ถ: ์ ๊ณต๋ ์ด๋ฆ์ด DNI ๋ฒํธ์ ์ผ์นํ๋์ง ํ์ธํฉ๋๋ค.
- ํ์ฅ ๊ฐ์ธ ์ ๋ณด: ์๋ฏผ ์ํ, ์ถ์์ผ, ์ฑ๋ณ, ์ฃผ์ ์ ๋ณด๋ฅผ ๋ฐํํฉ๋๋ค.
- ๋ฌธ์ ์ ๋ณด: ๋ฌธ์ ์ข ๋ฅ, ๋ฒํธ, ๋ฐ๊ธ์ผ, ๋ง๋ฃ์ผ, ๊ฒ์ฆ ์๋ฆฟ์๋ฅผ ๊ฒ์ฆํฉ๋๋ค.
- ์ง๋ฆฌ ์ ๋ณด: ์์น ์๋ณ์ ์ํ ubigeoReniec ์ฝ๋๋ฅผ ์ ๊ณตํฉ๋๋ค.
- ์ฌ์ง ๋ฐ์ดํฐ: ์๋ฏผ์ ์ฌ์ง์ base64 ํ์์ผ๋ก ์ ๊ณตํฉ๋๋ค.
์ด๋ฌํ ํญ๋ชฉ์ ๊ฒ์ฆํจ์ผ๋ก์จ ๊ฑฐ๋ ์๋๊ฐ ์ค์กดํ๋ฉฐ ์ ํจํ ๋ฌธ์๋ฅผ ๋ณด์ ํ๊ณ ์์์ ํ์ ํ ์ ์๊ณ , ์ ์ ๋์ฉ ๋ฐ ์ฌ๊ธฐ ์ํ์ ํฌ๊ฒ ๋ฎ์ถ ์ ์์ต๋๋ค.
์๋ํฌ์ธํธโ
GET https://api.verifik.co/v3/pe/cedula/extra
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช | ์์ |
|---|---|---|---|---|
documentType | string | ์ | ๋ฌธ์ ์ข ๋ฅ. ํ์ฉ ๊ฐ: DNI. | DNI |
documentNumber | string | ์ | ์กฐํ ๋์์์ ๋ฌธ์ ๋ฒํธ. | 123456789 |
์์ฒญ(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: '1234567'
},
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer <your_token>'
}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
import requests
url = "https://app.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=74687367&force=1"
payload = {}
headers = {
'Authorization': 'Bearer eyJhbGciOIJ9.eyJjbGllbnRJZCI6..06rwjGQ'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "net/http"
url = URI("https://app.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=74687367&force=1")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer eyJhbGciOkpXVCJ9.eyJjbGllbn...rwjGQ"
response = https.request(request)
puts response.read_body
curl --location --request GET 'https://app.verifik.co/v3/pe/cedula/extra?documentType=DNI&documentNumber=74687367&force=1' \
--header 'Authorization: Bearer eyJhbGciOiJXVCJ9.eyJjbGllbnR...QqLcIe4-706rwjGQ'
์๋ต(Response)โ
- 200
- 404
- 409 - ๋งค๊ฐ๋ณ์ ๋๋ฝ
- 409 - ์๋ชป๋ documentType
{
"data": {
"address": "CARACALLA",
"arrayName": [
"FELIPE",
"TRUJILLO",
"HERNANDEZ"
],
"civilStatus": "SOLTERO",
"dateOfBirth": "19-11-1997",
"documentNumber": "74687367",
"documentType": "DNI",
"expeditionDate": "03-03-2025",
"expirationDate": "03-03-2033",
"firstName": "FELIPE",
"fullName": "FELIPE TRUJILLO HERNANDEZ",
"lastName": "TRUJILLO HERNANDEZ",
"photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBD...v8ADSGiigD/2Q==",
"sex": "M",
"ubigeoReniec": "020208",
"verificationDigit": "2"
},
"signature": {
"dateTime": "April 16, 2025 2:44 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]"
}
์ผ๋ฐ์ ์ธ ํ์ฉ ์ฌ๋กโ
- ๊ณ ๊ธ KYC ์ ์ฐจ: ์ข ํฉ์ ์ธ ์ ์ ํ์ธ์ ํตํด ์ปดํ๋ผ์ด์ธ์ค์ ์ฌ๊ธฐ ํ์ง๋ฅผ ๊ฐํํฉ๋๋ค.
- ๊ธ์ต ์๋น์ค: ์ํ ๋ฐ ๊ธ์ต ์๋น์ค ์ ์ฒญ์ ์ํ ์์ธ ์ ์ ๋ฐ์ดํฐ๋ฅผ ๊ฒ์ฆํฉ๋๋ค.
- ๊ณ ์ฉ ๊ฒ์ฆ: ์ฑ์ฉ ์ ์ฐจ์์ ์ข ํฉ ๊ฐ์ธ ์ ๋ณด๋ฅผ ํ์ธํฉ๋๋ค.
- ์ปดํ๋ผ์ด์ธ์ค ๋ฐ ์ค์ฌ: ํ์ฅ ์ ์ ์ ๋ณด๊ฐ ์๊ตฌ๋๋ ํ๋ฃจ ๊ท์ ์ ์ค์ํฉ๋๋ค.
- ์ฌ๊ธฐ ํ์ง: ์ฌ์ง๊ณผ ์ธ๊ตฌ ํต๊ณ ์ ๋ณด๋ฅผ ํฌํจํ ํ์ฅ ๋ฐ์ดํฐ๋ฅผ ํ์ฉํด ๊ณ ๊ธ ์ฌ๊ธฐ ์๋ฐฉ์ ์ํํฉ๋๋ค.
๊ณต์ ์ถ์ฒ์ ์ ๋ขฐ์ฑโ
ํ๋ฃจ ์ ๋ถ์ ๊ณต์ ๊ธฐ๊ด(RENIEC)๊ณผ ์ง์ ์ฐ๊ฒฐ๋์ด ๊ฒ์ฆ๋๊ณ ์ต์ ์ํ์ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค. ๋ชจ๋ ์กฐํ๋ ๋ณด์ ๋ฐ ๊ท์ ํ์ค์ ์๊ฒฉํ ์ค์ํ์ฌ ์ฒ๋ฆฌ๋ฉ๋๋ค.
์ฃผ์ ์ด์ โ
- ์๋ํ๋ ์ปดํ๋ผ์ด์ธ์ค: ์ฌ์ฉ์ ๊ฒฝํ์ ํด์น์ง ์์ผ๋ฉด์ KYC ์ ๊ฒ์ ์๋ํํ๊ณ ์ฌ๊ธฐ๋ฅผ ๋ฐฉ์งํฉ๋๋ค.
- ํ์ฅ๋ ๋ฐ์ดํฐ ์ ๊ทผ: ์ฌ์ง, ์ฃผ์, ์๋ฏผ ์ํ, ์ธ๊ตฌ ํต๊ณ ์ ๋ณด๋ฅผ ํฌํจํ ์ข ํฉ ์ ์ ์ ๋ณด๋ฅผ ๋ฐ์ ์ ์์ต๋๋ค.
- ์ฆ๊ฐ์ ์ธ ๊ฒฐ๊ณผ: ์ ์ด ๋ด์ ๊ฒ์ฆ์ ์ฒ๋ฆฌํ๋ฏ๋ก ์ค์๊ฐ ์ ์ ํ์ธ์ ์ ํฉํฉ๋๋ค.
- ์ ๋ขฐํ ์ ์๋ ๋ฐ์ดํฐ: ๊ณต์ RENIEC ๊ธฐ๋ก์ ์ถ์ฒ๋ก ํ๋ ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
- ๊ฐํธํ ํตํฉ: REST API ๋๋ ํธํ SDK๋ฅผ ํตํด ์์ฝ๊ฒ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค.
์ปดํ๋ผ์ด์ธ์ค์ ๋ณด์โ
Verifik์ ๋ฐ์ดํฐ ์์ ์ ์ต์ฐ์ ์ผ๋ก ํฉ๋๋ค. ๊ณ ๊ธ ์ํธํ(HTTPS / TLS 1.3)์ ์๊ฒฉํ ๊ฐ์ธ์ ๋ณด ๊ด๋ฆฌ ํ์ค์ ์ฌ์ฉํด ๊ธฐ๋ฐ์ฑ์ ๋ณด์ฅํฉ๋๋ค. ์๋น์ค๋ 24/7 ๊ฐ์ฉ์ฑ ๋ชจ๋ํฐ๋ง์ ์ ์ฉํ๊ณ , ํ ์ ๊ทผ ์ ์ด๋ฅผ ์ํด ์ญํ ๊ธฐ๋ฐ ์ ๊ทผ ์ ์ด๋ฅผ ์ ๊ณตํฉ๋๋ค.
Verifik ์๊ฐโ
Verifik์ ๋ผํด์๋ฉ๋ฆฌ์นด ์ ์ญ์์ ์ ์ ํ์ธ, ์ปดํ๋ผ์ด์ธ์ค, ์ฌ๊ธฐ ์๋ฐฉ์ ์ ๊ณตํ๋ ์ ๋์ ์ธ ํ๋ซํผ์ ๋๋ค. ์ ํฌ API๋ KYC, KYB, AML, ์์ฒด ์ธ์ฆ ์ ์ฐจ๋ฅผ ์๋ํํ๋ฉฐ, ์ฝ๋กฌ๋น์, ๋ฉ์์ฝ, ํ๋ฃจ, ์น ๋ , ์ฐ๋ฃจ๊ณผ์ด, ์๋ฅดํจํฐ๋, ๋ธ๋ผ์ง ๋ฐ ๊ทธ ์ธ ์ง์ญ์ ๊ณต์ ๋ฐ์ดํฐ ์์ค์ ๋น์ฆ๋์ค๋ฅผ ์ฐ๊ฒฐํฉ๋๋ค.