Skip to main content

๐Ÿ‡จ๐Ÿ‡ฑ ์น ๋ ˆ โ€” ๊ธฐ์—… ๊ฒ€์ฆ

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

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

๋ณธ ์„œ๋น„์Šค๋Š” ๋ฌธ์„œ ์ข…๋ฅ˜์™€ ๋ฒˆํ˜ธ๋ฅผ ์ž…๋ ฅํ•ด ์น ๋ ˆ ๊ธฐ์—… ์ •๋ณด๋ฅผ ์กฐํšŒํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค. ์‘๋‹ต์—๋Š” ํšŒ์‚ฌ๋ช…, ์‚ฌ์—… ๋ถ„๋ฅ˜, ํ•˜์œ„ ๋ถ„๋ฅ˜, ๊ฒฝ์ œ ํ™œ๋™์ด ํฌํ•จ๋˜๋ฉฐ, ํ•ด๋‹น ๊ธฐ์—…์ด ํ™œ๋™์„ ์Šน์ธ๋ฐ›์€ ์„œ๋น„์Šค ๋ชฉ๋ก๋„ ํ•จ๊ป˜ ์ œ๊ณต๋ฉ๋‹ˆ๋‹ค.

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

https://api.verifik.co/v2/cl/company

RUT๋กœ ์น ๋ ˆ ๊ธฐ์—…์„ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค. ๊ณต์‹ ๋“ฑ๊ธฐ์†Œ ๋ฐ์ดํ„ฐ ๊ธฐ๋ฐ˜์˜ ๋ฒ•์ธ๋ช…, ์‚ฌ์—… ๋ถ„๋ฅ˜, ํ™œ๋™, ์Šน์ธ๋œ ์„œ๋น„์Šค ๋ผ์ธ์„ ์ œ๊ณตํ•ด KYB ๋ฐ ๊ณต๊ธ‰์—…์ฒด ์‹ค์‚ฌ์— ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

ํ—ค๋”(Headers)โ€‹

์ด๋ฆ„๊ฐ’
Acceptapplication/json
AuthorizationBearer <token>

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

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…์˜ˆ์‹œ
documentTypestring์˜ˆ๋ฌธ์„œ ์ข…๋ฅ˜. ํ—ˆ์šฉ ๊ฐ’: RUT.RUT
documentNumberstring์˜ˆ์กฐํšŒํ•  ๊ธฐ์—…์˜ RUT. ์›๋ฌธ ๋ฌธ์„œ ๊ทœ์ •์— ๋”ฐ๋ผ ์ ๊ณผ ํ•˜์ดํ”ˆ์„ ํฌํ•จํ•ด ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.33516727409

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

import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.verifik.co/v2/cl/company',
params: {
documentType: 'RUT',
documentNumber: '212957739'
},
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer <tu_token>'
}
};

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

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

{
"data": {
"activities": "Contribuyente presenta Inicio de Actividades: SI",
"currentEconomicActivities": [
{
"activity": "ELABORACION DE PRODUCTOS DE PANADERIA Y PASTELERIA",
"code": "107100",
"category": "Primera",
"affectIVA": "Si",
"date": "05-09-2014"
},
{
"activity": "VENTA AL POR MENOR DE ALIMENTOS EN COMERCIOS ESPECIALIZADOS (ALMACENES",
"code": "472101",
"category": "Primera",
"affectIVA": "Si",
"date": "05-09-2014"
}
],
"documentNumber": "76409396",
"documentType": "RUT",
"fullRUT": "76409396-8",
"name": "PANADERIA R&M SPA",
"stampedDocuments": [],
"startDate": "05-09-2014"
},
"signature": {
"dateTime": "September 4, 2023 3:07 PM",
"message": "Certified by Verifik.co"
},
"id": "azbnj"
}

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

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

  • ํšŒ์‚ฌ๋ช… ๋ฐ RUT ๋ฒˆํ˜ธ: Rol รšnico Tributario(RUT)๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
  • ๊ธฐ์—… ์ •๋ณด: ํšŒ์‚ฌ๋ช…, ๊ฒฝ์ œ ํ™œ๋™, ์‚ฌ์—… ๋ถ„๋ฅ˜, ์Šน์ธ ์ •๋ณด๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.
  • ๊ฒฝ์ œ ํ™œ๋™: ์ฝ”๋“œ, ๋ถ„๋ฅ˜, IVA(๋ถ€๊ฐ€์„ธ) ์ ์šฉ ์—ฌ๋ถ€, ์ผ์ž๊ฐ€ ํฌํ•จ๋œ ์ƒ์„ธ ๊ฒฝ์ œ ํ™œ๋™ ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  • ํšŒ์‚ฌ ์ผ์น˜ ์—ฌ๋ถ€: ์ž…๋ ฅ๋œ ๊ธฐ์—… ์ •๋ณด๊ฐ€ RUT ๋ฒˆํ˜ธ์™€ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

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

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

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

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

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

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

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

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

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

Verifik ์†Œ๊ฐœโ€‹

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