CLOVA eKYC 개요

CLOVA eKYC는 금융 기관에서 고객의 신원을 식별하고 확인하는 행위인 고객 확인 절차(KYC: Know Your Customer)를 전자적으로 처리할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. CLOVA eKYC에서는 웹이나 모바일로 제출된 신분증의 진위 여부를 검증하는 기능에 대한 API를 RESTful 형태로 제공하며, 사용자 확인이 필요한 민감한 서비스에 적용하여 효율적인 서비스 플로우 설계를 지원합니다.

CLOVA eKYC 공통 설정

CLOVA eKYC API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

도메인 유형별 요청 API URL은 다음과 같습니다.

신분증, 사업자등록증: https://{apigwId}.apigw-pub.fin-ntruss.com/ekyc/v1/{domainId}/{signature}/{inferType}
1원 인증: https://{apigwId}.apigw-pub.fin-ntruss.com/ekyc/v1/{domainId}/{signature}/account
ARS 인증: https://{apigwId}.apigw-pub.fin-ntruss.com/ekyc/v1/{domainId}/{signature}/ars
얼굴 인증: https://{apigwId}.apigw-pub.fin-ntruss.com/ekyc/v1/{domainId}/{signature}/face

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

응답

공통 응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

error
error는 API 호출 실패 정보를 정의합니다. error에 대한 설명은 다음과 같습니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

진위 검증 기관 에러 메시지

진위 검증 기관 에러 메시지에 대한 설명은 다음과 같습니다.

응답 예시

호출이 성공한 경우의 응답 예시는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 예시는 다음과 같습니다.

{
    "code": "0002",
    "message": "Secret validate failed.",
    "path": "/external/v1/{domainId}/{signature}/id-card/document",
    "timestamp": 1700000000000,
    "uid": "a1b2c3d4e5f6g7h8i9j0k1l2m3"
}

CLOVA eKYC API

CLOVA eKYC 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

CLOVA eKYC 연관 리소스

CLOVA eKYC API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

• CLOVA eKYC 서비스 사용 방법
  • CLOVA eKYC 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 CLOVA eKYC 서비스를 사용하는 방법
  • 요금 소개, 특징, 상세 기능: CLOVA eKYC 서비스의 요금 체계, 특징, 상세 기능 요약
  • 서비스 최신 소식: CLOVA eKYC 서비스 관련 최신 소식
  • 자주 하는 질문: CLOVA eKYC 서비스 사용자들이 자주 하는 질문
  • 문의하기: API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의