Skip to main content

์บ๋‚˜๋‹ค ์šด์ „๋ฉดํ—ˆ ๊ฒ€์ฆ

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

๋ธŒ๋ฆฌํ‹ฐ์‹œ์ปฌ๋Ÿผ๋น„์•„ ๋ฐ ์˜จํƒ€๋ฆฌ์˜ค์ฃผ(ๅทž)์—์„œ ๋ฐœ๊ธ‰๋œ ์šด์ „๋ฉดํ—ˆ์˜ ์œ ํšจ์„ฑ์„ ๋น ๋ฅด๊ณ  ์•ˆ์ „ํ•˜๊ฒŒ ์ž๋™์œผ๋กœ ํ™•์ธํ•ด์•ผ ํ•˜๋Š” ๋น„์ฆˆ๋‹ˆ์Šค๋ฅผ ์œ„ํ•ด ๋งŒ๋“ค์–ด์กŒ์Šต๋‹ˆ๋‹ค.

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

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

  • ์šด์ „๋ฉดํ—ˆ ๋ฒˆํ˜ธ: ์šด์ „๋ฉดํ—ˆ ๋ฒˆํ˜ธ์˜ ์ง„์œ„๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฉดํ—ˆ ์ƒํƒœ: ํ˜„์žฌ ๋ฉดํ—ˆ๊ฐ€ ์œ ํšจํ•œ์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  • ์‹ ์› ์ผ์น˜ ์—ฌ๋ถ€: ๋ธŒ๋ฆฌํ‹ฐ์‹œ์ปฌ๋Ÿผ๋น„์•„์˜ ๊ฒฝ์šฐ, ๋ฉดํ—ˆ ๊ธฐ๋ก๊ณผ ์ž…๋ ฅ๋œ ์„ฑ(ๅง“)์ด ์ผ์น˜ํ•˜๋Š”์ง€ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.

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

์บ๋‚˜๋‹ค ์‹ ์› ๊ฒ€์ฆ ์„œ๋น„์Šค๋Š” ๋ธŒ๋ฆฌํ‹ฐ์‹œ์ปฌ๋Ÿผ๋น„์•„ ๋ฐ ์˜จํƒ€๋ฆฌ์˜ค์ฃผ์˜ ์šด์ „๋ฉดํ—ˆ ๊ฒ€์ฆ์„ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค. ๋ณธ ์„œ๋น„์Šค๋ฅผ ํ†ตํ•ด ๋‘ ์ฃผ(ๅทž)์—์„œ ๋ฐœ๊ธ‰๋œ ์šด์ „๋ฉดํ—ˆ์˜ ์ง„์œ„์™€ ์œ ํšจ์„ฑ์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ง€์›๋˜๋Š” ์ฃผโ€‹

์ฃผ(ๅทž)์—”๋“œํฌ์ธํŠธ์„ค๋ช…
๋ธŒ๋ฆฌํ‹ฐ์‹œ์ปฌ๋Ÿผ๋น„์•„/v2/ca/british-columbia/driver-license๋ฌธ์„œ ๋ฒˆํ˜ธ์™€ ์„ฑ์œผ๋กœ BC ์šด์ „๋ฉดํ—ˆ๋ฅผ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.
์˜จํƒ€๋ฆฌ์˜ค/v2/ca/ontario/driver-license๋ฌธ์„œ ๋ฒˆํ˜ธ๋กœ ์˜จํƒ€๋ฆฌ์˜ค ์šด์ „๋ฉดํ—ˆ๋ฅผ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.

๋ธŒ๋ฆฌํ‹ฐ์‹œ์ปฌ๋Ÿผ๋น„์•„ ์šด์ „๋ฉดํ—ˆโ€‹

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

GET https://api.verifik.co/v2/ca/british-columbia/driver-license

๋ธŒ๋ฆฌํ‹ฐ์‹œ์ปฌ๋Ÿผ๋น„์•„ ์šด์ „๋ฉดํ—ˆ ๊ฒ€์ฆ ์„œ๋น„์Šค๋Š” ์บ๋‚˜๋‹ค ๋ธŒ๋ฆฌํ‹ฐ์‹œ์ปฌ๋Ÿผ๋น„์•„์ฃผ์—์„œ ๋ฐœ๊ธ‰๋œ ์šด์ „๋ฉดํ—ˆ์˜ ์ง„์œ„์™€ ์œ ํšจ์„ฑ์„ ์†์‰ฝ๊ฒŒ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋Š” ๋ฐฉ๋ฒ•์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋ณธ ์„œ๋น„์Šค๋ฅผ ํ™œ์šฉํ•˜๋ฉด ์ž…๋ ฅ๋œ ๋ฌธ์„œ ๋ฒˆํ˜ธ์™€ ์„ฑ์„ ๊ธฐ๋ฐ˜์œผ๋กœ ์šด์ „๋ฉดํ—ˆ๋ฅผ ์‹ ์†ํžˆ ๊ฒ€์ฆํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

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

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

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

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…์˜ˆ์‹œ
documentNumberstring์˜ˆ์กฐํšŒํ•  ์šด์ „๋ฉดํ—ˆ ๋ฒˆํ˜ธ. ๋ชจ๋“  ๋ฐ์ดํ„ฐ๋Š” ๋ฉดํ—ˆ์— ํ‘œ๊ธฐ๋œ ๊ทธ๋Œ€๋กœ ์ž…๋ ฅํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.1123456
lastNamestring์˜ˆ์šด์ „๋ฉดํ—ˆ์— ํ‘œ๊ธฐ๋œ ์„ฑ(ๅง“).HELLO

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

import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.verifik.co/v2/ca/british-columbia/driver-license',
params: {
documentNumber: '7793458',
lastName: 'JIWA'
},
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer <tu_token>'
}
};

try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}

์˜จํƒ€๋ฆฌ์˜ค ์šด์ „๋ฉดํ—ˆโ€‹

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

GET https://api.verifik.co/v2/ca/ontario/driver-license

์˜จํƒ€๋ฆฌ์˜ค ์šด์ „๋ฉดํ—ˆ ์„œ๋น„์Šค๋Š” ์บ๋‚˜๋‹ค ์˜จํƒ€๋ฆฌ์˜ค์ฃผ์—์„œ ๋ฐœ๊ธ‰๋œ ์šด์ „๋ฉดํ—ˆ์— ๋Œ€ํ•œ ํ•ต์‹ฌ ์ •๋ณด๋ฅผ ์‹ ์†ํ•˜๊ฒŒ ์กฐํšŒํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•ฉ๋‹ˆ๋‹ค. ๋ฌธ์„œ ๋ฒˆํ˜ธ๋ฅผ ์ œ๊ณตํ•˜๋ฉด ๋ฉดํ—ˆ ์ƒํƒœ์™€ ๊ด€๋ จ ๊ฒ€์ฆ ๋ฒˆํ˜ธ ๋“ฑ ์ƒ์„ธ ์ •๋ณด๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋ณธ ์„œ๋น„์Šค๋ฅผ ํ™œ์šฉํ•ด ์˜จํƒ€๋ฆฌ์˜ค ์šด์ „๋ฉดํ—ˆ์˜ ์ง„์œ„์™€ ์œ ํšจ์„ฑ์„ ํšจ์œจ์ ์œผ๋กœ ๊ฒ€์ฆํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์‹ ์› ํ™•์ธ์ด๋‚˜ ๊ทœ์ œ ๋ชฉ์ ์˜ ๋ฉดํ—ˆ ์œ ํšจ์„ฑ ํ™•์ธ์— ์ ํ•ฉํ•œ ์ •ํ™•ํ•˜๊ณ  ์ตœ์‹ ์˜ ๋ฉดํ—ˆ ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

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

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

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

์ด๋ฆ„ํ˜•์‹ํ•„์ˆ˜์„ค๋ช…์˜ˆ์‹œ
documentNumberstring์˜ˆ์กฐํšŒํ•  ์šด์ „๋ฉดํ—ˆ ๋ฒˆํ˜ธ. ๋ชจ๋“  ๋ฐ์ดํ„ฐ๋Š” ๋ฉดํ—ˆ์— ํ‘œ๊ธฐ๋œ ๊ทธ๋Œ€๋กœ ์ž…๋ ฅํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.S123456789123456

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

import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.verifik.co/v2/ca/ontario/driver-license',
params: {
documentNumber: 'S123456789123456'
},
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer <tu_token>'
}
};

try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}

์‘๋‹ต ์˜ˆ์‹œโ€‹

{
"data": {
"documentNumber": "1123456",
"lastName": "HELLO",
"valid": true
},
"signature": {
"dateTime": "August 8, 2023 10:56 PM",
"message": "Certified by Verifik.co"
},
"id": "1234567"
}

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

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

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

์บ๋‚˜๋‹ค ์ฃผ(ๅทž) ๊ณต์‹ ๋ฉดํ—ˆ ๋ฐœ๊ธ‰ ์‹œ์Šคํ…œ(๋ธŒ๋ฆฌํ‹ฐ์‹œ์ปฌ๋Ÿผ๋น„์•„ ๋ฐ ์˜จํƒ€๋ฆฌ์˜ค)๊ณผ ์ง์ ‘ ์—ฐ๊ฒฐ๋˜์–ด ๊ฒ€์ฆ๋˜๊ณ  ์ตœ์‹  ์ƒํƒœ์˜ ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋ชจ๋“  ์กฐํšŒ๋Š” ๋ณด์•ˆ ๋ฐ ๊ทœ์ œ ํ‘œ์ค€์„ ์—„๊ฒฉํžˆ ์ค€์ˆ˜ํ•˜์—ฌ ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค.

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

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

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

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

Verifik ์†Œ๊ฐœโ€‹

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