Skip to main content
이 리소스에는 새 통합의 기반이 되어야 하는 버전 관리형 API인 Whop API의 후속 리소스가 있습니다. 이 페이지는 계속 완전히 지원됩니다.
Verification은 계정이 지급을 받는 데 필요한 신원 확인 절차를 개인 또는 비즈니스가 진행하도록 안내합니다. 개인은 고객 확인(KYC) 절차를 완료하고, 비즈니스는 기업 확인(KYB) 절차를 완료합니다. 예를 들어 사용자의 첫 지급 전에 Verification을 생성합니다. 이름과 주소를 미리 채워 두면 사용자 지정 인증 UI 없이도 호스팅된 양식을 완료할 수 있습니다. 이후 동일한 Verification을 사용하여 인증된 신원 데이터를 조회하고 다운스트림 지급 제공업체의 RFI에 응답할 수 있습니다. 계정이 거래 전에 인증을 받아야 할 때, 일반적으로 첫 지급 전에 Verification을 생성합니다. 생성하기 전에 원장 계정이 있는 계정이 있는지 확인하세요(원장 계정은 계정을 생성할 때 자동으로 생성됩니다). 같은 계정에 동일한 kind의 Verification을 여러 개 생성하지 마세요. 각 계정은 최대 하나의 활성 개인(KYC) 프로필과 하나의 비즈니스(KYB) 프로필을 지원합니다. Verification은 사용자가 절차를 완료하는 동안 여러 상태를 거칩니다: KYC를 진행하는 동안 pending, 신원이 확인되면 approved, 제공업체가 거절하면 rejected, 지급 제공업체가 은행 명세서나 납세자 번호 같은 추가 정보를 요구하면 action_required입니다. Verification이 성공하면 이름, 생년월일, 국가, 주소가 확인된 완전히 인증된 신원이 생성되어 계정의 지급이 활성화됩니다. 미리 채우기 필드(first_name, address 등)와 함께 Verification을 생성하면 인증과 호스팅된 KYC 양식 모두에 자동으로 값이 채워지므로, 사용자가 이미 가지고 있는 정보를 다시 입력할 필요가 없습니다. 상태 변경에 실시간으로 대응하려면 폴링 대신 identity_profile.approved 및 identity_profile.rejected 웹훅을 수신하는 것을 권장합니다. Verification을 사용하면 기본 KYC 제공업체와 규정 준수 요구 사항이 시간이 지나며 변경되더라도 단일 API 통합으로 사용자를 지급에 온보딩할 수 있습니다.

엔드포인트

상태

string
필수
인증 기록의 숫자 ID입니다.예시: verf_xxxxxxxxxxxxx
VerificationErrorCodes | null
필수
인증 중 반환된 가장 최근 오류 코드입니다. 오류가 발생하지 않은 경우 Null입니다.사용 가능한 옵션: abandoned, consent_declined, country_not_supported, device_not_supported, document_expired, document_type_not_supported, document_unverified_other, email_unverified_other, email_verification_declined, id_number_insufficient_document_data, id_number_mismatch, id_number_unverified_other, phone_unverified_other, phone_verification_declined, selfie_document_missing_photo, selfie_face_mismatch, selfie_manipulated, selfie_unverified_other, under_supported_age
string | null
필수
가장 최근 인증 오류에 대한 사람이 읽을 수 있는 설명입니다. 오류가 발생하지 않은 경우 Null입니다.예시: Document image was too blurry to read.
VerificationStatuses
필수
이 인증 세션의 현재 상태입니다.사용 가능한 옵션: requires_input, processing, verified, canceled, created, started, submitted, approved, declined, resubmission_requested, expired, abandoned, review, action_required, manual_review