ํ๋ฃจ ๊ธฐ์ ๊ฒ์ฆ
Verifik์ ๊ธฐ์ ๊ฒ์ฆ API๋ ์ ๋ถ ๊ณต์ ๋ฐ์ดํฐ๋ฅผ ํ์ฉํด ํ๋ฃจ ๊ธฐ์ ์ ์ง์๋ฅผ ํ์ธํ ์ ์๋๋ก ํฉ๋๋ค. KYB(Know Your Business) ์ ์ฐจ๋ฅผ ์๋ํํ๊ณ ์ฌ๊ธฐ๋ฅผ ๋ฐฉ์งํ๋ฉฐ ๊ท์ ์๊ตฌ์ฌํญ์ ์์ฝ๊ฒ ์ถฉ์กฑํ ์ ์๋๋ก ์ค๊ณ๋์์ต๋๋ค.
๊ธฐ์ , ํํธ๋, ๊ณต๊ธ์ ์ฒด์ ์ ๋ฒ์ฑ์ ๋น ๋ฅด๊ณ ์์ ํ๊ฒ ์๋์ผ๋ก ํ์ธํด์ผ ํ๋ ๋น์ฆ๋์ค๋ฅผ ์ํด ๋ง๋ค์ด์ก์ต๋๋ค.
์ด API๋ ๋ฌด์์ ๊ฒ์ฆํฉ๋๊น?โ
๋น์ฌ์ API๋ ๊ณต์ ๊ธฐ๋ก๊ณผ ์ง์ ์ฐ๊ฒฐ๋์ด ๋ค์์ ๊ฒ์ฆํฉ๋๋ค.
- ํ์ฌ๋ช ๋ฐ RUC ๋ฒํธ: Registro รnico de Contribuyente(RUC)๋ฅผ ์ง์ํฉ๋๋ค.
- ๊ธฐ์ ์ ๋ณด: ํ์ฌ๋ช , ์ฃผ์, ๋ฉ์ธ์ ์กฐ๊ฑด, ์ํ๋ฅผ ๋ฐํํฉ๋๋ค.
- ํ์ฌ ์ผ์น ์ฌ๋ถ: ์ ๋ ฅ๋ ๊ธฐ์ ์ ๋ณด๊ฐ RUC ๋ฒํธ์ ์ผ์นํ๋์ง ํ์ธํฉ๋๋ค.
์ด๋ฌํ ํญ๋ชฉ์ ๊ฒ์ฆํจ์ผ๋ก์จ ๊ฑฐ๋ ์๋ ๊ธฐ์ ์ด ์ค์ฌํ๋ฉฐ ์ ์ ๋ฑ๋ก๋ ๊ธฐ์ ์์ ํ์ ํ ์ ์๊ณ , ์ฌ๊ธฐ ์ํ์ ํฌ๊ฒ ๋ฎ์ถ๋ ๋์์ ์ปดํ๋ผ์ด์ธ์ค๋ฅผ ํ๋ณดํ ์ ์์ต๋๋ค.
API ๋ ํผ๋ฐ์คโ
์๋ํฌ์ธํธโ
https://api.verifik.co/v2/pe/company
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช |
|---|---|---|---|
documentType | string | ์ | ๋ฌธ์ ์ข
๋ฅ. ํ์ฉ ๊ฐ: RUC. |
documentNumber | string | ์ | ํ์ฌ ์๋ณ ๋ฒํธ. |
์์ฒญ(Request)โ
- Node.js
- PHP
- Python
- Go
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/pe/company", {
params: { documentType: "RUC", documentNumber: "20605980008" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);
<?php
$ch = curl_init("https://api.verifik.co/v2/pe/company");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Accept: application/json",
"Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$query = http_build_query([
"documentType" => "RUC",
"documentNumber" => "20605980008"
]);
curl_setopt($ch, CURLOPT_URL, "https://api.verifik.co/v2/pe/company?".$query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import os, requests
url = "https://api.verifik.co/v2/pe/company"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "RUC", "documentNumber": "20605980008"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
package main
import (
"fmt"
"net/http"
)
func main() {
url := "https://api.verifik.co/v2/pe/company?documentType=RUC&documentNumber=20605980008"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("Accept", "application/json")
req.Header.Set("Authorization", "Bearer "+getenv("VERIFIK_TOKEN"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
fmt.Println(resp.Status)
}
์๋ต(Response)โ
- 200
- 404
- 409
- 401
- 500
{
"data": {
"address": "AV. VICTOR ANDRES BELAUNDE NRO. 332 INT. 702 URB. EL ROSARIO - LIMA LIMA SAN ISIDRO",
"businessName": "MERCADOLIBRE PERU S.R.L.",
"conditionTaxpayer": "HABIDO",
"district": "SAN ISIDRO",
"documentNumber": "20605980008",
"documentType": "RUC",
"nameVia": "VICTOR ANDRES BELAUNDE",
"province": "LIMA",
"simpleaddress": "AV. VICTOR ANDRES BELAUNDE NRO. 332 INT. 702 URB. EL ROSARIO",
"state": "LIMA",
"stateTaxpayer": "ACTIVO",
"zoneCode": "URB.",
"zoneType": "EL ROSARIO"
},
"signature": {
"dateTime": "October 10, 2025 5:35 PM",
"message": "Certified by Verifik.co"
},
"id": "RLS8G"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [RUC]"
}
{
"code": "MissingParameter",
"message": "missing documentNumber\n"
}
{
"code": "MissingParameter",
"message": "missing documentType\n"
}
{
"message": "Authentication required",
"code": "UNAUTHORIZED"
}
{
"code": "InternalServerError",
"message": "Server error."
}
๋น๊ณ โ
- ์ ์ฒด ๋ฐ์ดํฐ์ ํ๋๋ ์ง์ํ์ ๋ฌธ์ํด ์ฃผ์ญ์์ค.
์ผ๋ฐ์ ์ธ ํ์ฉ ์ฌ๋กโ
- B2B ์จ๋ณด๋ฉ: ํํธ๋ ๋๋ ๊ณต๊ธ์ ์ฒด ๋ฑ๋ก ์ ์ฆ์ ๊ธฐ์ ์ ๊ฒ์ฆํฉ๋๋ค.
- ๊ธ์ต ์๋น์ค: ๊ณ์ข ๊ฐ์ค ๋๋ ๊ฑฐ๋ ์ฒ๋ฆฌ ์ ์ ๊ธฐ์ ์ ์ง์๋ฅผ ํ์ธํฉ๋๋ค.
- ์ปดํ๋ผ์ด์ธ์ค ๋ฐ ์ค์ฌ: KYC/KYB ์ํฌํ๋ก์ฐ์ ์ผํ์ผ๋ก ๊ธฐ์ ์ ๋ณด๋ฅผ ๊ฒ์ฆํฉ๋๋ค.
- ์ด์ปค๋จธ์ค ๋ฐ ๋ง์ผํ๋ ์ด์ค: ์ ์ ์ ํ์ฉํ๊ธฐ ์ ์ ๊ธฐ์ ์ ์ ๋ฒ์ฑ์ ํ์ธํฉ๋๋ค.
๊ณต์ ์ถ์ฒ์ ์ ๋ขฐ์ฑโ
ํ๋ฃจ ์ ๋ถ ๊ณต์ ๋ฐ์ดํฐ ์์ค(SUNAT)์ ์ง์ ์ฐ๊ฒฐ๋์ด ๊ฒ์ฆ๋๊ณ ์ต์ ์ํ์ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค. ๋ชจ๋ ์กฐํ๋ ๋ณด์ ๋ฐ ๊ท์ ํ์ค์ ์๊ฒฉํ ์ค์ํ์ฌ ์ฒ๋ฆฌ๋ฉ๋๋ค.
์ฃผ์ ์ด์ โ
- ์๋ํ๋ ์ปดํ๋ผ์ด์ธ์ค: ๊ฑฐ๋ ํํธ๋์๊ฒ ๋ง์ฐฐ์ ๋ํ์ง ์์ผ๋ฉด์ KYB ์ ๊ฒ์ ์๋ํํ๊ณ ์ฌ๊ธฐ๋ฅผ ๋ฐฉ์งํฉ๋๋ค.
- ์ฆ๊ฐ์ ์ธ ๊ฒฐ๊ณผ: ์ ์ด ๋ด์ ๊ฒ์ฆ์ ์ฒ๋ฆฌํ๋ฏ๋ก ์ค์๊ฐ ๋น์ฆ๋์ค ์จ๋ณด๋ฉ์ ์ ํฉํฉ๋๋ค.
- ์ ๋ขฐํ ์ ์๋ ๋ฐ์ดํฐ: ๊ณต์ ๊ธฐ๋ก์ ์ง์ ์ฐธ์กฐํ ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
- ๊ฐํธํ ํตํฉ: REST API ๋๋ ํธํ SDK๋ฅผ ํตํด ์์ฝ๊ฒ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค.
์ปดํ๋ผ์ด์ธ์ค์ ๋ณด์โ
Verifik์ ๋ฐ์ดํฐ ์์ ์ ์ต์ฐ์ ์ผ๋ก ํฉ๋๋ค. ๊ณ ๊ธ ์ํธํ(HTTPS/TLS 1.3)์ ์๊ฒฉํ ๊ฐ์ธ์ ๋ณด ๊ด๋ฆฌ ํ์ค์ ์ฌ์ฉํด ๊ธฐ๋ฐ์ฑ์ ๋ณด์ฅํฉ๋๋ค. ์๋น์ค๋ 24/7 ๊ฐ์ฉ์ฑ ๋ชจ๋ํฐ๋ง์ ์ ์ฉํ๊ณ , ํ ์ ๊ทผ ์ ์ด๋ฅผ ์ํด ์ญํ ๊ธฐ๋ฐ ์ ๊ทผ ์ ์ด๋ฅผ ์ ๊ณตํฉ๋๋ค.
Verifik ์๊ฐโ
Verifik์ ๋ผํด์๋ฉ๋ฆฌ์นด ์ ์ญ์์ ์ ์ ํ์ธ, ์ปดํ๋ผ์ด์ธ์ค, ์ฌ๊ธฐ ์๋ฐฉ์ ์ ๊ณตํ๋ ์ ๋์ ์ธ ํ๋ซํผ์ ๋๋ค. ์ ํฌ API๋ KYC, KYB, AML, ์์ฒด ์ธ์ฆ ์ ์ฐจ๋ฅผ ์๋ํํ๋ฉฐ, ์ฝ๋กฌ๋น์, ๋ฉ์์ฝ, ํ๋ฃจ, ์น ๋ , ์ฐ๋ฃจ๊ณผ์ด, ์๋ฅดํจํฐ๋, ๋ธ๋ผ์ง ๋ฐ ๊ทธ ์ธ ์ง์ญ์ ๊ณต์ ๋ฐ์ดํฐ ์์ค์ ๋น์ฆ๋์ค๋ฅผ ์ฐ๊ฒฐํฉ๋๋ค.