๐จ๐ฑ ์น ๋ โ ๊ธฐ์ ๊ฒ์ฆ
Verifik์ ๊ธฐ์ ๊ฒ์ฆ API๋ ์ ๋ถ ๊ณต์ ๋ฐ์ดํฐ๋ฅผ ํ์ฉํด ์น ๋ ๊ธฐ์ ์ ์ง์๋ฅผ ํ์ธํ ์ ์๋๋ก ํฉ๋๋ค. KYB(Know Your Business) ์ ์ฐจ๋ฅผ ์๋ํํ๊ณ ์ฌ๊ธฐ๋ฅผ ๋ฐฉ์งํ๋ฉฐ ๊ท์ ์๊ตฌ์ฌํญ์ ์์ฝ๊ฒ ์ถฉ์กฑํ ์ ์๋๋ก ์ค๊ณ๋์์ต๋๋ค.
๊ธฐ์ , ํํธ๋, ๊ณต๊ธ์ ์ฒด์ ์ ๋ฒ์ฑ์ ๋น ๋ฅด๊ณ ์์ ํ๊ฒ ์๋์ผ๋ก ํ์ธํด์ผ ํ๋ ๋น์ฆ๋์ค๋ฅผ ์ํด ๋ง๋ค์ด์ก์ต๋๋ค.
๋ณธ ์๋น์ค๋ ๋ฌธ์ ์ข ๋ฅ์ ๋ฒํธ๋ฅผ ์ ๋ ฅํด ์น ๋ ๊ธฐ์ ์ ๋ณด๋ฅผ ์กฐํํ ์ ์๊ฒ ํฉ๋๋ค. ์๋ต์๋ ํ์ฌ๋ช , ์ฌ์ ๋ถ๋ฅ, ํ์ ๋ถ๋ฅ, ๊ฒฝ์ ํ๋์ด ํฌํจ๋๋ฉฐ, ํด๋น ๊ธฐ์ ์ด ํ๋์ ์น์ธ๋ฐ์ ์๋น์ค ๋ชฉ๋ก๋ ํจ๊ป ์ ๊ณต๋ฉ๋๋ค.
์๋ํฌ์ธํธโ
https://api.verifik.co/v2/cl/company
RUT๋ก ์น ๋ ๊ธฐ์ ์ ์กฐํํฉ๋๋ค. ๊ณต์ ๋ฑ๊ธฐ์ ๋ฐ์ดํฐ ๊ธฐ๋ฐ์ ๋ฒ์ธ๋ช , ์ฌ์ ๋ถ๋ฅ, ํ๋, ์น์ธ๋ ์๋น์ค ๋ผ์ธ์ ์ ๊ณตํด KYB ๋ฐ ๊ณต๊ธ์ ์ฒด ์ค์ฌ์ ํ์ฉํ ์ ์์ต๋๋ค.
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช | ์์ |
|---|---|---|---|---|
documentType | string | ์ | ๋ฌธ์ ์ข ๋ฅ. ํ์ฉ ๊ฐ: RUT. | RUT |
documentNumber | string | ์ | ์กฐํํ ๊ธฐ์ ์ RUT. ์๋ฌธ ๋ฌธ์ ๊ท์ ์ ๋ฐ๋ผ ์ ๊ณผ ํ์ดํ์ ํฌํจํด ์ ๋ ฅํฉ๋๋ค. | 33516727409 |
์์ฒญ(Request)โ
- JavaScript
- Python
- PHP
- Swift
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);
}
import http.client
conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer <your_token>'
}
conn.request("GET", "/v2/cl/company?documentType=RUT&documentNumber=212957739", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/cl/company?documentType=RUT&documentNumber=212957739');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setHeader('Accept', 'application/json');
$request->setHeader('Authorization', 'Bearer <your_token>');
$request->setConfig(array(
'follow_redirects' => TRUE
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
?>
var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/cl/company?documentType=RUT&documentNumber=212957739")!,
timeoutInterval: Double.infinity)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
request.setValue("Bearer <your_token>", forHTTPHeaderField: "Authorization")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
guard let data = data else {
print(String(describing: error))
return
}
print(String(data: data, encoding: .utf8)!)
}
task.resume()
์๋ต(Response)โ
- 200
- 404
- 409
- 409 โ ๊ฒ์ฆ ์ค๋ฅ
{
"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"
}
{
"code": "NotFound",
"message": "No existe contribuyente asociado a la CUIT ingresada"
}
{
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [RUT]"
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [RUT]"
}
์ด 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, ์์ฒด ์ธ์ฆ ์ ์ฐจ๋ฅผ ์๋ํํ๋ฉฐ, ์ฝ๋กฌ๋น์, ๋ฉ์์ฝ, ํ๋ฃจ, ์น ๋ , ์ฐ๋ฃจ๊ณผ์ด, ์๋ฅดํจํฐ๋, ๋ธ๋ผ์ง ๋ฐ ๊ทธ ์ธ ์ง์ญ์ ๊ณต์ ๋ฐ์ดํฐ ์์ค์ ๋น์ฆ๋์ค๋ฅผ ์ฐ๊ฒฐํฉ๋๋ค.