UN(ONU) 제재 명단 조회

API 레퍼런스

엔드포인트

https://api.verifik.co/v2/onu

documentType과 documentNumber, 또는 fullName을 사용해 개인 또는 법인이 유엔 제재 명단에 포함되는지 조회합니다. 결과는 거래 상대 검증 시 글로벌 컴플라이언스, KYC, AML 워크플로우에 활용할 수 있습니다.

참고: 날짜(출생일 또는 발급일)는 dd/mm/yyyy 형식이어야 합니다.

헤더(Headers)

이름	값
Content-Type	application/json
Authorization	Bearer <token>

매개변수(Parameters)

info

지원되는 문서 종류의 전체 목록과 각 종류별 필수 매개변수는 Document Types 가이드를 참고해 주세요.

이름	형식	필수	설명
documentType	string	아니오	조회할 문서 종류
documentNumber	string	아니오	조회할 문서 번호. 공백이나 점 없이 입력합니다.
fullName	string	아니오	documentType과 documentNumber 대신 개인 또는 법인의 이름을 직접 전달할 수 있습니다.

활용 사례

• 국제 컴플라이언스: 온보딩 또는 거래 전에 개인 및 법인을 UN 제재 명단과 대조해 검증합니다.
• 위험 평가: 제재 대상자와의 거래로 인한 재무 및 평판 리스크를 줄입니다.
• 규제 프로그램: 은행, 금융, 보험 분야의 KYC/AML 요구사항을 지원합니다.

요청(Request)

JavaScript

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/onu",
  params: { documentType: "CC", documentNumber: "80251972" },
  headers: {
    Accept: "application/json",
    Authorization: "jwt <tu_token>",
  },
};

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

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")

headers = {
    'Accept': "application/json",
    'Authorization': "JWT token"
}

conn.request("GET", "/v2/onu?fullName=", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "JWT token"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/onu?fullName=")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/onu?fullName=', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'JWT token',
  ],
]);

echo $response->getBody();

응답(Response)

200

{
  "data": {
    "documentType": "CC",
    "documentNumber": "1234567894",
    "fullName": "MATEO VERIFIK",
    "firstName": "MATEO",
    "lastName": "VERIFIK",
    "arrayName": ["MATEO", "VERIFIK"],
    "foundInONU": true
  },
  "signature": {
    "dateTime": "August 4, 2022 3:57 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
  "code": "NotFound",
  "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "missing documentType\n. missing documentNumber\n"
}

비고

• UN 제재 검증: 개인 및 법인을 대상으로 합니다.
• 구조화된 응답: 통합에 적합한 형식으로 데이터를 반환하며, 위에서 JavaScript, Python, PHP, Swift 예제를 제공합니다.