์น ๋ ์ ์ ๊ฒ์ฆ
Verifik์ ์ ์ ํ์ธ API๋ ๊ณ ์ ๊ตญ๊ฐ ๋ฒํธ(RUN, Rol รnico Nacional)๋ฅผ ์ฌ์ฉํด ์น ๋ ๊ตญ๋ฏผ์ ์ ์์ ์ธ์ฆํ ์ ์๋๋ก ํฉ๋๋ค. KYC(Know Your Customer) ์ ์ฐจ๋ฅผ ์๋ํํ๊ณ , ์ฌ๊ธฐ๋ฅผ ์๋ฐฉํ๋ฉฐ, ๊ท์ ์๊ตฌ์ฌํญ์ ์์ฝ๊ฒ ์ถฉ์กฑํ ์ ์๋๋ก ์ค๊ณ๋์์ต๋๋ค.
์ฌ์ฉ์, ์ง์, ๊ณ ๊ฐ์ ์ง์ง ์ ์์ ๋น ๋ฅด๊ณ ์์ ํ๊ฒ ์๋์ผ๋ก ํ์ธํด์ผ ํ๋ ๋น์ฆ๋์ค๋ฅผ ์ํด ๋ง๋ค์ด์ก์ต๋๋ค.
์ด API๋ ๋ฌด์์ ๊ฒ์ฆํฉ๋๊น?โ
๋น์ฌ์ API๋ ๊ณต์ ๊ธฐ๋ก๊ณผ ์ง์ ์ฐ๊ฒฐ๋์ด ๋ค์์ ๊ฒ์ฆํฉ๋๋ค.
- ์ ์ฒด ์ฑ๋ช ๋ฐ RUN: Rol รnico Nacional(RUN)์ ์ง์ํฉ๋๋ค.
- ์ ์ ์ผ์น ์ฌ๋ถ: ์ ๊ณต๋ ์ด๋ฆ์ด RUN ๋ฒํธ์ ์ผ์นํ๋์ง ํ์ธํฉ๋๋ค.
์ด๋ฌํ ํญ๋ชฉ์ ๊ฒ์ฆํจ์ผ๋ก์จ ๊ฑฐ๋ ์๋๊ฐ ์ค์กดํ๋ฉฐ ์ ํจํ ๋ฌธ์๋ฅผ ๋ณด์ ํ๊ณ ์์์ ํ์ ํ ์ ์๊ณ , ์ ์ ๋์ฉ ๋ฐ ์ฌ๊ธฐ ์ํ์ ํฌ๊ฒ ๋ฎ์ถ ์ ์์ต๋๋ค.
API ๋ ํผ๋ฐ์คโ
์๋ํฌ์ธํธโ
https://api.verifik.co/v2/cl/cedula
์น ๋ ๊ตญ๋ฏผ ์ ๋ถ์ฆ(RUN/RUT)์ ๊ฒ์ฆํฉ๋๋ค. ๊ณต์ ๋ฏผ์ ๋ฑ๊ธฐ์๋ฅผ ๊ธฐ์ค์ผ๋ก ์ด๋ฆ๊ณผ ์ ์ ํ๋๋ฅผ ํ์ธํด KYC, ์จ๋ณด๋ฉ, ์ฌ๊ธฐ ๋ฐฉ์ง์ ํ์ฉํฉ๋๋ค.
ํค๋(Headers)โ
| ์ด๋ฆ | ๊ฐ |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
๋งค๊ฐ๋ณ์(Parameters)โ
| ์ด๋ฆ | ํ์ | ํ์ | ์ค๋ช |
|---|---|---|---|
documentType | string | ์ | ํ์ฉ ๊ฐ: RUN. |
documentNumber | string | ์ | ๊ณต๋ฐฑ์ด๋ ๊ตฌ๋ถ์ ์์ด ์ ๋ ฅํ RUN ๊ฐ. |
์์ฒญ(Request)โ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/cl/cedula", {
params: { documentType: "RUN", documentNumber: "212957739" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/cl/cedula"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "RUN", "documentNumber": "212957739"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
์๋ต(Response)โ
- 200
- 400
{
"data": {
"documentType": "RUN",
"documentNumber": "212957739",
"firstName": "Carlos",
"lastName": "Rodrรญguez",
"fullName": "Carlos Rodrรญguez",
"status": "valid"
},
"signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
"id": "CL001"
}
{
"message": "Invalid RUN number",
"code": "INVALID_RUN"
}
๋น๊ณ โ
- RUN์ ๊ณต๋ฐฑ์ด๋ ๊ตฌ๋ถ์ ์์ด ์ ๋ ฅํฉ๋๋ค.
์ผ๋ฐ์ ์ธ ํ์ฉ ์ฌ๋กโ
- ํํ ํฌ ๋ฐ ์ํ: ๊ณ์ข ๊ฐ์ค ๋๋ ๋์ถ ์ ์ฒญ ์ ์ฆ์ ์ ์์ ๊ฒ์ฆํฉ๋๋ค.
- ์ด์ปค๋จธ์ค ๋ฐ ๋ฐฐ๋ฌ: ์ฌ์ฉ์๋ ๋ฐฐ์ก์์ด ํ๋ซํผ์ ํ์ฑํ๋๊ธฐ ์ ์ ์ธ์ฆํฉ๋๋ค.
- ์ธ์ฌ ๋ฐ ์ฑ์ฉ: ์ฑ์ฉ ์ ์ฐจ์ ์ผํ์ผ๋ก ํ๋ณด์์ ๋ฌธ์๋ฅผ ๊ฒ์ฆํฉ๋๋ค.
- ๋ณดํ ๋ฐ ์๋ฃ: ๋ณดํ ๊ฐ์ ๋๋ ์๋ฃ ํํ ์ ๊ณต ์ ์ ์ ์์ ํ์ธํฉ๋๋ค.
๊ณต์ ์ถ์ฒ์ ์ ๋ขฐ์ฑโ
์น ๋ ์ ๋ถ์ ๊ณต์ ์ถ์ฒ(Registro Civil)์ ์ง์ ์ฐ๊ฒฐ๋์ด ๊ฒ์ฆ๋๊ณ ์ต์ ์ํ์ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค. ๋ชจ๋ ์กฐํ๋ ๋ณด์ ๋ฐ ๊ท์ ํ์ค์ ์๊ฒฉํ ์ค์ํ์ฌ ์ฒ๋ฆฌ๋ฉ๋๋ค.
์ฃผ์ ์ด์ โ
- ์๋ํ๋ ์ปดํ๋ผ์ด์ธ์ค: ์ฌ์ฉ์ ๊ฒฝํ์ ํด์น์ง ์์ผ๋ฉด์ KYC ์ ๊ฒ์ ์๋ํํ๊ณ ์ฌ๊ธฐ๋ฅผ ๋ฐฉ์งํฉ๋๋ค.
- ์ฆ๊ฐ์ ์ธ ๊ฒฐ๊ณผ: ์ ์ด ๋ด์ ๊ฒ์ฆ์ ์ฒ๋ฆฌํ๋ฏ๋ก ์ค์๊ฐ ๋์งํธ ์จ๋ณด๋ฉ์ ์ ํฉํฉ๋๋ค.
- ์ ๋ขฐํ ์ ์๋ ๋ฐ์ดํฐ: ๊ณต์ ๊ธฐ๋ก์ ์ง์ ์ฐธ์กฐํ ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
- ๊ฐํธํ ํตํฉ: REST API ๋๋ ํธํ SDK๋ฅผ ํตํด ์์ฝ๊ฒ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค.
์ปดํ๋ผ์ด์ธ์ค์ ๋ณด์โ
Verifik์ ๋ฐ์ดํฐ ์์ ์ ์ต์ฐ์ ์ผ๋ก ํฉ๋๋ค. ๊ณ ๊ธ ์ํธํ(HTTPS/TLS 1.3)์ ์๊ฒฉํ ๊ฐ์ธ์ ๋ณด ๊ด๋ฆฌ ํ์ค์ ์ฌ์ฉํด ๊ธฐ๋ฐ์ฑ์ ๋ณด์ฅํฉ๋๋ค. ์๋น์ค๋ 24/7 ๊ฐ์ฉ์ฑ ๋ชจ๋ํฐ๋ง์ ์ ์ฉํ๊ณ , ํ ์ ๊ทผ ์ ์ด๋ฅผ ์ํด ์ญํ ๊ธฐ๋ฐ ์ ๊ทผ ์ ์ด๋ฅผ ์ ๊ณตํฉ๋๋ค.
Verifik ์๊ฐโ
Verifik์ ๋ผํด์๋ฉ๋ฆฌ์นด ์ ์ญ์์ ์ ์ ํ์ธ, ์ปดํ๋ผ์ด์ธ์ค, ์ฌ๊ธฐ ์๋ฐฉ์ ์ ๊ณตํ๋ ์ ๋์ ์ธ ํ๋ซํผ์ ๋๋ค. ์ ํฌ API๋ KYC, KYB, AML, ์์ฒด ์ธ์ฆ ์ ์ฐจ๋ฅผ ์๋ํํ๋ฉฐ, ์ฝ๋กฌ๋น์, ๋ฉ์์ฝ, ํ๋ฃจ, ์น ๋ , ์ฐ๋ฃจ๊ณผ์ด, ์๋ฅดํจํฐ๋ ๋ฐ ๊ทธ ์ธ ์ง์ญ์ ๊ณต์ ๋ฐ์ดํฐ ์์ค์ ๋น์ฆ๋์ค๋ฅผ ์ฐ๊ฒฐํฉ๋๋ค.