Skip to main content

๋ณผ๋ฆฌ๋น„์•„ ์‹ ์› ๊ฒ€์ฆ

Verifik์˜ ์‹ ์› ํ™•์ธ API๋Š” ๊ณต์‹ ์ •๋ถ€ ๋ฐ์ดํ„ฐ๋ฅผ ์ด์šฉํ•ด ๋ณผ๋ฆฌ๋น„์•„ ์‹œ๋ฏผ์„ ์ธ์ฆํ•ฉ๋‹ˆ๋‹ค. KYC(Know Your Customer) ์ ˆ์ฐจ๋ฅผ ์ž๋™ํ™”ํ•˜๊ณ , ์‚ฌ๊ธฐ๋ฅผ ์˜ˆ๋ฐฉํ•˜๋ฉฐ, ๊ทœ์ œ ์š”๊ตฌ์‚ฌํ•ญ์„ ์†์‰ฝ๊ฒŒ ์ถฉ์กฑํ•  ์ˆ˜ ์žˆ๋„๋ก ์„ค๊ณ„๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

์‚ฌ์šฉ์ž, ์ง์›, ๊ณ ๊ฐ์˜ ์ง„์งœ ์‹ ์›์„ ๋น ๋ฅด๊ณ  ์•ˆ์ „ํ•˜๊ฒŒ ์ž๋™์œผ๋กœ ํ™•์ธํ•ด์•ผ ํ•˜๋Š” ๋น„์ฆˆ๋‹ˆ์Šค๋ฅผ ์œ„ํ•ด ๋งŒ๋“ค์–ด์กŒ์Šต๋‹ˆ๋‹ค.

์ด API๋Š” ๋ฌด์—‡์„ ๊ฒ€์ฆํ•ฉ๋‹ˆ๊นŒ?โ€‹

๋‹น์‚ฌ์˜ API๋Š” ๊ณต์‹ ๊ธฐ๋ก๊ณผ ์ง์ ‘ ์—ฐ๊ฒฐ๋˜์–ด ๋‹ค์Œ์„ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.

  • ์ „์ฒด ์„ฑ๋ช… ๋ฐ CI ๋ฒˆํ˜ธ: Cรฉdula de Identidad(CI)๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
  • ์‹ ์› ์ผ์น˜ ์—ฌ๋ถ€: ์ œ๊ณต๋œ ์ด๋ฆ„์ด CI ๋ฒˆํ˜ธ์™€ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  • ์ƒ๋…„์›”์ผ ๊ฒ€์ฆ: ์ƒ๋…„์›”์ผ์ด ๊ณต์‹ ๊ธฐ๋ก๊ณผ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

์ด๋Ÿฌํ•œ ํ•ญ๋ชฉ์„ ๊ฒ€์ฆํ•จ์œผ๋กœ์จ ๊ฑฐ๋ž˜ ์ƒ๋Œ€๊ฐ€ ์‹ค์กดํ•˜๋ฉฐ ์œ ํšจํ•œ ๋ฌธ์„œ๋ฅผ ๋ณด์œ ํ•˜๊ณ  ์žˆ์Œ์„ ํ™•์‹ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

API ๋ ˆํผ๋Ÿฐ์Šคโ€‹

์—”๋“œํฌ์ธํŠธโ€‹

GET https://api.verifik.co/v2/bo/cedula

documentType CI, documentNumber, dateOfBirth(DD/MM/YYYY)๋กœ ๋ณผ๋ฆฌ๋น„์•„ ์‹œ๋ฏผ์˜ ์‹ ์›์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. KYC ๋ฐ ์ปดํ”Œ๋ผ์ด์–ธ์Šค์— ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ์‹ ์› ํ•„๋“œ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

ํ—ค๋”โ€‹

์ด๋ฆ„๊ฐ’
Content-Typeapplication/json
AuthorizationBearer <token>

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

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…
documentTypestring์˜ˆ๋ฌธ์„œ ์ข…๋ฅ˜. ํ—ˆ์šฉ ๊ฐ’: CI.
documentNumberstring์˜ˆCI ๋ฌธ์„œ ๋ฒˆํ˜ธ.
dateOfBirthstring์˜ˆDD/MM/YYYY ํ˜•์‹์˜ ์ƒ๋…„์›”์ผ.

์š”์ฒญโ€‹

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/bo/cedula", {
params: { documentType: "CI", documentNumber: "123456789", dateOfBirth: "15/03/1990" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

์‘๋‹ตโ€‹

{
"data": {
"documentType": "CI",
"documentNumber": "123456789",
"firstName": "Marรญa",
"lastName": "Gonzรกlez",
"fullName": "Marรญa Gonzรกlez",
"dateOfBirth": "1990-03-15",
"status": "valid"
},
"signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
"id": "BO001"
}

์ฐธ๊ณ โ€‹

  • ์ƒ๋…„์›”์ผ์€ ํ•„์ˆ˜์ด๋ฉฐ CI ๊ธฐ๋ก๊ณผ ์ผ์น˜ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

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

  • ํ•€ํ…Œํฌยท์€ํ–‰: ๊ณ„์ขŒ ๊ฐœ์„ค์ด๋‚˜ ๋Œ€์ถœ ์‹ ์ฒญ ์‹œ ์ฆ‰์‹œ ์‹ ์› ํ™•์ธ
  • ์ด์ปค๋จธ์Šคยท๋ฐฐ์†ก: ์‚ฌ์šฉ์žยท๋ฐฐ์†ก์› ์ธ์ฆ
  • HRยท์ฑ„์šฉ: ํ›„๋ณด์ž ๋ฌธ์„œ ๊ฒ€์ฆ
  • ๋ณดํ—˜ยทํ—ฌ์Šค์ผ€์–ด: ๋ณดํ—˜ ๋ฐœํ–‰ ์ „ ์‹ ์› ํ™•์ธ

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

๋ณผ๋ฆฌ๋น„์•„ ๊ณต์‹ ์ •๋ถ€ ์ถœ์ฒ˜์™€ ์ง์ ‘ ์—ฐ๊ฒฐํ•˜์—ฌ ๊ฒ€์ฆ๋œ ์ตœ์‹  ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

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

  • ์ž๋™ ์ปดํ”Œ๋ผ์ด์–ธ์Šค: KYC๋ฅผ ํšจ์œจํ™”ํ•˜์—ฌ ์‚ฌ๊ธฐ๋ฅผ ๋ฐฉ์ง€
  • ์ฆ‰์‹œ ๊ฒฐ๊ณผ: ์ˆ˜ ์ดˆ ๋‚ด ์กฐํšŒ
  • ์‹ ๋ขฐํ•  ์ˆ˜ ์žˆ๋Š” ๋ฐ์ดํ„ฐ: ๊ณต์‹ ๊ธฐ๋ก ๊ธฐ๋ฐ˜

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

HTTPS/TLS๋ฅผ ํ†ตํ•œ ํ†ต์‹  ๋ณดํ˜ธ์™€ ์—„๊ฒฉํ•œ ๊ฐœ์ธ์ •๋ณด ๊ด€๋ฆฌ๋ฅผ ์ค‘์‹œํ•ฉ๋‹ˆ๋‹ค.

Verifik ์†Œ๊ฐœโ€‹

Verifik๋Š” ๋ผํ‹ด์•„๋ฉ”๋ฆฌ์นด ์ „์—ญ์—์„œ ์‹ ์› ํ™•์ธ, ์ปดํ”Œ๋ผ์ด์–ธ์Šค, ์‚ฌ๊ธฐ ๋ฐฉ์ง€๋ฅผ ์œ„ํ•œ ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค.