Skip to main content

๋ฉ•์‹œ์ฝ” ์‹ ์› ๊ฒ€์ฆ

Verifik์˜ ์‹ ์› ํ™•์ธ API๋Š” ์ธ๊ตฌ ๋“ฑ๋ก ๊ณ ์œ  ๋ฒˆํ˜ธ(CURP, Clave รšnica de Registro de Poblaciรณn)๋ฅผ ์‚ฌ์šฉํ•ด ๋ฉ•์‹œ์ฝ” ๊ตญ๋ฏผ์˜ ์‹ ์›์„ ์ธ์ฆํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•ฉ๋‹ˆ๋‹ค. KYC(Know Your Customer) ์ ˆ์ฐจ๋ฅผ ์ž๋™ํ™”ํ•˜๊ณ , ์‚ฌ๊ธฐ๋ฅผ ์˜ˆ๋ฐฉํ•˜๋ฉฐ, ๊ทœ์ œ ์š”๊ตฌ์‚ฌํ•ญ์„ ์†์‰ฝ๊ฒŒ ์ถฉ์กฑํ•  ์ˆ˜ ์žˆ๋„๋ก ์„ค๊ณ„๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

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

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

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

  • ์ „์ฒด ์„ฑ๋ช… ๋ฐ CURP: Clave รšnica de Registro de Poblaciรณn(CURP)์„ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค.
  • ๊ฐœ์ธ ์ƒ์„ธ ์ •๋ณด: ์ถœ์ƒ์ผ, ์„ฑ๋ณ„, ๊ตญ์ ์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.
  • ์‹ ์› ์ผ์น˜ ์—ฌ๋ถ€: ์ œ๊ณต๋œ ์ด๋ฆ„์ด CURP ๋ฒˆํ˜ธ์™€ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

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

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

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

https://api.verifik.co/v2/mx/curp

๋ณธ ์—”๋“œํฌ์ธํŠธ๋Š” ๋ฉ•์‹œ์ฝ” ๊ตญ๋ฏผ์˜ CURP(Clave รšnica de Registro de Poblaciรณn)๋ฅผ ๊ณต์‹ ๊ธฐ๋ก๊ณผ ๋Œ€์กฐํ•ด ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค. documentType๊ณผ documentNumber๋ฅผ GET ์š”์ฒญ์œผ๋กœ ์ „๋‹ฌํ•˜๋ฉด, CURP๊ฐ€ ์ธ์‹๋  ๊ฒฝ์šฐ ์‹ ์› ๊ธฐ๋ก์„ ํ™•์ธํ•˜๊ณ  ๊ฒ€์ฆ๋œ ์ด๋ฆ„ ๋ฐ ์ธ์  ์ •๋ณด ํ•„๋“œ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

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

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

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

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…
documentTypestring์˜ˆํ—ˆ์šฉ ๊ฐ’: CURP.
documentNumberstring์˜ˆ๊ฒ€์ฆํ•  CURP ๊ฐ’.

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

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/mx/curp", {
params: { documentNumber: "ABCD890513ABCDEF09", documentType: "CURP" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

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

{
"data": {
"documentType": "CURP",
"documentNumber": "ABCD890513ABCDEF09",
"firstName": "Juan",
"lastName": "Pรฉrez",
"fullName": "Juan Pรฉrez",
"dateOfBirth": "1989-05-13",
"nationality": "Mexican",
"status": "valid"
},
"signature": {"message": "Certified by Verifik.co", "dateTime": "January 16, 2024 3:44 PM"},
"id": "MX001"
}

๋น„๊ณ โ€‹

  • documentNumber๋Š” CURP ํ˜•์‹๊ณผ ์ •ํ™•ํžˆ ์ผ์น˜ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

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

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

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

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

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

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

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

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

Verifik ์†Œ๊ฐœโ€‹

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