Skip to main content

์•„๋ฅดํ—จํ‹ฐ๋‚˜ ์‹ ์› ๊ฒ€์ฆ

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

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

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

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

  • ์„ฑ๋ช… ๋ฐ DNI ๋ฒˆํ˜ธ: Documento Nacional de Identidad(DNI)๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
  • ์‹ ์› ์ผ์น˜: ์ œ๊ณต๋œ ์ด๋ฆ„์ด DNI ๋ฒˆํ˜ธ์™€ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

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

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

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

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

documentType DNIAR์™€ **documentNumber**๋กœ ์•„๋ฅดํ—จํ‹ฐ๋‚˜ ์‹ ์›์„ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค. KYC ๋ฐ ์ปดํ”Œ๋ผ์ด์–ธ์Šค๋ฅผ ์ง€์›ํ•˜๋Š” ์‹ ์› ํ•„๋“œ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

ํ—ค๋”โ€‹

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

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

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…
documentTypestring์˜ˆ๋ฌธ์„œ ์œ ํ˜•. ํ—ˆ์šฉ ๊ฐ’: DNIAR.
documentNumberstring์˜ˆ์กฐํšŒํ•  ์‚ฌ๋žŒ์˜ ๋ฌธ์„œ ๋ฒˆํ˜ธ(๊ณต๋ฐฑ ์—†์Œ).

์š”์ฒญโ€‹

import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.verifik.co/v2/ar/cedula',
params: {documentType: 'DNIAR', documentNumber: '123456789'},
headers: {
Accept: 'application/json',
Authorization: 'jwt <tu_token>'
}
};

try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}

์‘๋‹ตโ€‹

{
"data": {
"documentType": "CCAR",
"documentNumber": "123456789",
"fullName": "MATEO VERIFIK",
"firstName": "MATEO",
"lastName": "VERIFIK",
"arrayName": [
"MATEO",
"VERIFIK"
]
},
"signature": {
"dateTime": "April 11, 2023 12:25 PM",
"message": "Certified by Verifik.co"
}
}

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

  • ํ•€ํ…Œํฌ ๋ฐ ์€ํ–‰: ๊ณ„์ขŒ ๊ฐœ์„ค ๋˜๋Š” ๋Œ€์ถœ ์‹ ์ฒญ ์‹œ ์ฆ‰์‹œ ์‹ ์›์„ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.
  • ์ „์ž์ƒ๊ฑฐ๋ž˜ ๋ฐ ๋ฐฐ์†ก: ์‚ฌ์šฉ์ž์™€ ๋ฐฐ์†ก ๊ธฐ์‚ฌ๋ฅผ ํ™œ์„ฑํ™”ํ•˜๊ธฐ ์ „์— ์ธ์ฆํ•ฉ๋‹ˆ๋‹ค.
  • HR ๋ฐ ์ฑ„์šฉ: ์ฑ„์šฉ ์›Œํฌํ”Œ๋กœ์˜ ์ผ๋ถ€๋กœ ํ›„๋ณด์ž ๋ฌธ์„œ๋ฅผ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.
  • ๋ณดํ—˜ ๋ฐ ํ—ฌ์Šค์ผ€์–ด: ๋ณดํ—˜ ๋ฐœ๊ธ‰ ๋˜๋Š” ํ˜œํƒ ์ œ๊ณต ์ „์— ์‹ ์›์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

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

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

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

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

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

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

Verifik ์†Œ๊ฐœโ€‹

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