Skip to main content

์—์ฝฐ๋„๋ฅด ๊ธฐ์—… ๊ฒ€์ฆ

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

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

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

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

  • ์ƒํ˜ธ ๋ฐ RUCEC: Registro รšnico de Contribuyentes del Ecuador(RUCEC)๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
  • ๊ธฐ์—… ์ •๋ณด: ์ƒํ˜ธ, ์ƒํƒœ, ๋‚ฉ์„ธ์ž ์œ ํ˜•, ์ฒด์ œ, ์ฃผ์š” ๊ฒฝ์ œ ํ™œ๋™, ํšŒ๊ณ„ยท์›์ฒœ์ง•์ˆ˜ ์—ฌ๋ถ€, ๋‚ฉ์„ธ์ž ์ผ์ž, ๋ฒ•์ • ๋Œ€๋ฆฌ์ธ์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.
  • ํšŒ์‚ฌ ์ผ์น˜ ์—ฌ๋ถ€: ์ž…๋ ฅ๋œ ๊ธฐ์—… ์ •๋ณด๊ฐ€ RUCEC ๋ฒˆํ˜ธ์™€ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

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

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

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

GET https://api.verifik.co/v3/ec/company

documentType RUCEC์™€ documentNumber(13์ž๋ฆฌ, ๊ตฌ๋ถ„์ž ์—†์Œ)๋กœ ์—์ฝฐ๋„๋ฅด ๋ฒ•์ธ์„ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค. ๊ฒฝ์ œ ํ™œ๋™, ์ฒด์ œ, ๋ฒ•์ • ๋Œ€๋ฆฌ์ธ ๋“ฑ ๋“ฑ๊ธฐ ์ค‘์‹ฌ ํ•„๋“œ๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋ฉฐ KYB, ๊ณต๊ธ‰์—…์ฒด ์‹ฌ์‚ฌ, ์ปดํ”Œ๋ผ์ด์–ธ์Šค์— ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

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

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

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

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…์˜ˆ์‹œ
documentTypestring์˜ˆ๋ฌธ์„œ ์ข…๋ฅ˜. ํ—ˆ์šฉ ๊ฐ’: RUCEC.RUCEC
documentNumberstring์˜ˆ๊ณต๋ฐฑยท๋งˆ์นจํ‘œ ์—†๋Š” 13์ž๋ฆฌ RUCEC.1793197955001

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

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v3/ec/company", {
params: { documentType: "RUCEC", documentNumber: "1793197955001" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

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

{
"data": {
"accountingRequired": "SI",
"businessName": "PANADERรA Y PASTELERIA 227 S.A.S.",
"cancellationSuspensionReason": null,
"category": null,
"contributorDates": {
"startOfActivities": "2022-07-19 00:00:00.0",
"cessation": "",
"restartOfActivities": "",
"lastUpdate": "2023-08-09 08:34:14.0"
},
"documentNumber": "1793197955001",
"documentType": "RUCEC",
"ghostTaxpayer": "NO",
"legalRepresentatives": [
{
"identification": "1708262132",
"name": "LIZARZABURU CASTILLO PABLO ANDRES"
}
],
"mainEconomicActivity": "ACTIVIDADES DE PREPARACIร“N Y SERVICIO DE BEBIDAS PARA SU CONSUMO INMEDIATO EN: CAFร‰S, TIENDAS DE JUGOS DE FRUTA, VENDEDORES AMBULANTES DE BEBIDAS, ETCร‰TERA.",
"nonexistentTransactions": "NO",
"regime": "GENERAL",
"ruc": "1793197955001",
"specialTaxpayer": "NO",
"status": "ACTIVO",
"taxpayerType": "SOCIEDAD",
"withholdingAgent": "SI"
},
"signature": {
"dateTime": "July 17, 2026 6:15 PM",
"message": "Certified by Verifik.co"
},
"id": "CMPY1"
}

Notesโ€‹

  • documentNumber๋Š” ๊ตฌ๋ถ„์ž ์—†์ด ์ •ํ™•ํžˆ 13์ž๋ฆฌ์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.
  • ์ƒŒ๋“œ๋ฐ•์Šค ๋ฐ๋ชจ RUC: 1790008959001 (ACERO COMERCIAL ECUATORIANO S.A.).
  • ๋ผ์ด๋ธŒ ์˜ˆ์‹œ: 1793197955001, 1191795453001.
  • ๋ ˆ๊ฑฐ์‹œ GET /v2/ec/company๋Š” ๋” ๊ฐ„์†Œํ•œ ์‘๋‹ต ํ˜•ํƒœ๋กœ ๊ณ„์† ์ œ๊ณต๋ฉ๋‹ˆ๋‹ค.

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

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

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

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

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

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

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

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

Verifik ์†Œ๊ฐœโ€‹

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