FaceAuth 결과 웹훅

AddOn faceAuth가 제출되고 최종 결과(auth_status)가 도출되었을 때 Webhook이 발송됩니다.
Webhook은 기존 ID check 프로젝트에 등록된 Webhook URL로 전송됩니다. 웹훅 등록 방법은 여기서 확인해주세요.
Webhook의 트리거는 “faceAuth” 입니다.

faceauth-webhook-sample.json

{
  "webhook_trigger": "faceAuth", 
  "data": {
    "Submission_id": "{String}",
    "Auth_Status": "{String}",
    "Create_Time": "{String}",
    "Auth_User_id": "{String}",
    "Auth_cf1": "{String}",
    "Auth_cf2": "{String}",
    "Auth_cf3": "{String}",
    "Token_id" : "{String}",
    "reference": {
      "userid": "{String}",
      "email": "{String}",
      "cf": {
        "cf1": "{String}",
        "cf2": "{String}",
        "cf3": "{String}"
      }
    },
    "Authentication_id": "{String}"
  }
}

faceAuth는 이전에 제출된 ID check의 승인된 제출건과 비교됩니다

target : FaceAuth 요청시 QueryStirng에 사용된 파라미터
reference : faceAuth 비교의 대상이 되는 이전에 제출된 ID check의 submission

string

Webhook trigger type - faceAuth faceAuth webhook임을 알림

string

각 faceAuth 제출 건에 대한 고유 ID [authId]

object

Webhook 본문 데이터

표시 properties

string

faceAuth 비교의 대상이 되는 특정 제출 건의 고유 ID

string

faceAuth 최종 결과를 나타냅니다. approved(성공) 또는 rejected(실패)를 반환합니다

string

faceAuth에 제출된 날짜와 시간 (UTC+0)

string

target Submission_id의 제출 생성 시 선택적으로 추가된 user_id 파라미터

FaceAuth URL 파라미터에선 authUserId로 사용

string

target의 사용자 정의 필드 #1

FaceAuth URL 파라미터에선 authCf1로 사용

string

target의 사용자 정의 필드 #2

FaceAuth URL 파라미터에선 authCf2로 사용

string

target의 사용자 정의 필드 #3

FaceAuth URL 파라미터에선 authCf3로 사용

string

target에서 사용한 Token Id

FaceAuth URL 파라미터에선 token으로 사용

object

faceAuth 비교의 대상이 되는 reference submission

표시 properties

string

faceAuth 비교의 대상이 되는 reference Submission_id의 userid

string

faceAuth 비교의 대상이 되는 reference Submission_id의 email

object

faceAuth 비교의 대상이 되는 reference Submission_id의 사용자 정의 필드들

표시 properties

string

reference의 cf1

string

reference의 cf2

object

reference의 cf3

시작하기

FaceAuth 시작하기

FaceAuth는 ID check 인증 과정에서 승인된 유저의 셀피 사진과 FaceAuth 과정에서 획득한 셀피 사진을 비교하여 본인 여부를 한 단계 더 검증하는 절차입니다. 제공 방식(URL / API), FaceAuth URL의 쿼리 스트링 구조, 요청 파라미터 정의를 다룹니다.

POST/Face-auth

승인된 KYC submission의 reference image와 전달한 얼굴 이미지를 비교해 FaceAuth submission을 생성하는 API입니다.

GET/Face-auth (목록)

FaceAuth 제출 목록을 최신 생성 시각 순으로 조회하는 API입니다. cursor 기반 페이지네이션과 기간 필터를 제공합니다.

애드온

FaceAuth

관련 문서

시작하기

FaceAuth 시작하기

POST/Face-auth

GET/Face-auth (목록)

​관련 문서

시작하기

FaceAuth 시작하기

POST/Face-auth

GET/Face-auth (목록)

관련 문서