Skip to main content

๐Ÿ‡ต๐Ÿ‡ช ํŽ˜๋ฃจ โ€” 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-Typeapplication/json
AuthorizationBearer <token>

๋งค๊ฐœ๋ณ€์ˆ˜(Parameters)โ€‹

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…์˜ˆ์‹œ
documentTypestring์˜ˆ๋ฌธ์„œ ์ข…๋ฅ˜. ํ—ˆ์šฉ ๊ฐ’: DNI.DNI
documentNumberstring์˜ˆ์กฐํšŒ ๋Œ€์ƒ์ž์˜ ๋ฌธ์„œ ๋ฒˆํ˜ธ.123456789

์š”์ฒญ(Request)โ€‹

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

์‘๋‹ต(Response)โ€‹

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

์ผ๋ฐ˜์ ์ธ ํ™œ์šฉ ์‚ฌ๋ก€โ€‹

  • ๊ณ ๊ธ‰ KYC ์ ˆ์ฐจ: ์ข…ํ•ฉ์ ์ธ ์‹ ์› ํ™•์ธ์„ ํ†ตํ•ด ์ปดํ”Œ๋ผ์ด์–ธ์Šค์™€ ์‚ฌ๊ธฐ ํƒ์ง€๋ฅผ ๊ฐ•ํ™”ํ•ฉ๋‹ˆ๋‹ค.
  • ๊ธˆ์œต ์„œ๋น„์Šค: ์€ํ–‰ ๋ฐ ๊ธˆ์œต ์„œ๋น„์Šค ์‹ ์ฒญ์„ ์œ„ํ•œ ์ƒ์„ธ ์‹ ์› ๋ฐ์ดํ„ฐ๋ฅผ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.
  • ๊ณ ์šฉ ๊ฒ€์ฆ: ์ฑ„์šฉ ์ ˆ์ฐจ์—์„œ ์ข…ํ•ฉ ๊ฐœ์ธ ์ •๋ณด๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  • ์ปดํ”Œ๋ผ์ด์–ธ์Šค ๋ฐ ์‹ค์‚ฌ: ํ™•์žฅ ์‹ ์› ์ •๋ณด๊ฐ€ ์š”๊ตฌ๋˜๋Š” ํŽ˜๋ฃจ ๊ทœ์ •์„ ์ค€์ˆ˜ํ•ฉ๋‹ˆ๋‹ค.
  • ์‚ฌ๊ธฐ ํƒ์ง€: ์‚ฌ์ง„๊ณผ ์ธ๊ตฌ ํ†ต๊ณ„ ์ •๋ณด๋ฅผ ํฌํ•จํ•œ ํ™•์žฅ ๋ฐ์ดํ„ฐ๋ฅผ ํ™œ์šฉํ•ด ๊ณ ๊ธ‰ ์‚ฌ๊ธฐ ์˜ˆ๋ฐฉ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

๊ณต์‹ ์ถœ์ฒ˜์™€ ์‹ ๋ขฐ์„ฑโ€‹

ํŽ˜๋ฃจ ์ •๋ถ€์˜ ๊ณต์‹ ๊ธฐ๊ด€(RENIEC)๊ณผ ์ง์ ‘ ์—ฐ๊ฒฐ๋˜์–ด ๊ฒ€์ฆ๋˜๊ณ  ์ตœ์‹  ์ƒํƒœ์˜ ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ์กฐํšŒ๋Š” ๋ณด์•ˆ ๋ฐ ๊ทœ์ œ ํ‘œ์ค€์„ ์—„๊ฒฉํžˆ ์ค€์ˆ˜ํ•˜์—ฌ ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค.

์ฃผ์š” ์ด์ โ€‹

  • ์ž๋™ํ™”๋œ ์ปดํ”Œ๋ผ์ด์–ธ์Šค: ์‚ฌ์šฉ์ž ๊ฒฝํ—˜์„ ํ•ด์น˜์ง€ ์•Š์œผ๋ฉด์„œ KYC ์ ๊ฒ€์„ ์ž๋™ํ™”ํ•˜๊ณ  ์‚ฌ๊ธฐ๋ฅผ ๋ฐฉ์ง€ํ•ฉ๋‹ˆ๋‹ค.
  • ํ™•์žฅ๋œ ๋ฐ์ดํ„ฐ ์ ‘๊ทผ: ์‚ฌ์ง„, ์ฃผ์†Œ, ์‹œ๋ฏผ ์ƒํƒœ, ์ธ๊ตฌ ํ†ต๊ณ„ ์ •๋ณด๋ฅผ ํฌํ•จํ•œ ์ข…ํ•ฉ ์‹ ์› ์ •๋ณด๋ฅผ ๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์ฆ‰๊ฐ์ ์ธ ๊ฒฐ๊ณผ: ์ˆ˜ ์ดˆ ๋‚ด์— ๊ฒ€์ฆ์„ ์ฒ˜๋ฆฌํ•˜๋ฏ€๋กœ ์‹ค์‹œ๊ฐ„ ์‹ ์› ํ™•์ธ์— ์ ํ•ฉํ•ฉ๋‹ˆ๋‹ค.
  • ์‹ ๋ขฐํ•  ์ˆ˜ ์žˆ๋Š” ๋ฐ์ดํ„ฐ: ๊ณต์‹ RENIEC ๊ธฐ๋ก์„ ์ถœ์ฒ˜๋กœ ํ•˜๋Š” ๋ฐ์ดํ„ฐ๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ๊ฐ„ํŽธํ•œ ํ†ตํ•ฉ: REST API ๋˜๋Š” ํ˜ธํ™˜ SDK๋ฅผ ํ†ตํ•ด ์†์‰ฝ๊ฒŒ ์—ฐ๊ฒฐํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ปดํ”Œ๋ผ์ด์–ธ์Šค์™€ ๋ณด์•ˆโ€‹

Verifik์€ ๋ฐ์ดํ„ฐ ์•ˆ์ „์„ ์ตœ์šฐ์„ ์œผ๋กœ ํ•ฉ๋‹ˆ๋‹ค. ๊ณ ๊ธ‰ ์•”ํ˜ธํ™”(HTTPS / TLS 1.3)์™€ ์—„๊ฒฉํ•œ ๊ฐœ์ธ์ •๋ณด ๊ด€๋ฆฌ ํ‘œ์ค€์„ ์‚ฌ์šฉํ•ด ๊ธฐ๋ฐ€์„ฑ์„ ๋ณด์žฅํ•ฉ๋‹ˆ๋‹ค. ์„œ๋น„์Šค๋Š” 24/7 ๊ฐ€์šฉ์„ฑ ๋ชจ๋‹ˆํ„ฐ๋ง์„ ์ ์šฉํ•˜๊ณ , ํŒ€ ์ ‘๊ทผ ์ œ์–ด๋ฅผ ์œ„ํ•ด ์—ญํ•  ๊ธฐ๋ฐ˜ ์ ‘๊ทผ ์ œ์–ด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

Verifik ์†Œ๊ฐœโ€‹

Verifik์€ ๋ผํ‹ด์•„๋ฉ”๋ฆฌ์นด ์ „์—ญ์—์„œ ์‹ ์› ํ™•์ธ, ์ปดํ”Œ๋ผ์ด์–ธ์Šค, ์‚ฌ๊ธฐ ์˜ˆ๋ฐฉ์„ ์ œ๊ณตํ•˜๋Š” ์„ ๋„์ ์ธ ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค. ์ €ํฌ API๋Š” KYC, KYB, AML, ์ƒ์ฒด ์ธ์ฆ ์ ˆ์ฐจ๋ฅผ ์ž๋™ํ™”ํ•˜๋ฉฐ, ์ฝœ๋กฌ๋น„์•„, ๋ฉ•์‹œ์ฝ”, ํŽ˜๋ฃจ, ์น ๋ ˆ, ์šฐ๋ฃจ๊ณผ์ด, ์•„๋ฅดํ—จํ‹ฐ๋‚˜, ๋ธŒ๋ผ์งˆ ๋ฐ ๊ทธ ์™ธ ์ง€์—ญ์˜ ๊ณต์‹ ๋ฐ์ดํ„ฐ ์†Œ์Šค์™€ ๋น„์ฆˆ๋‹ˆ์Šค๋ฅผ ์—ฐ๊ฒฐํ•ฉ๋‹ˆ๋‹ค.