작동 방식
1
인증 시작하기
인증하려는 계정으로
POST /api/v1/verifications를 호출하세요. session_url을 돌려받습니다.2
사용자를 보내 KYC 완료하기
사용자를
session_url로 리디렉션하세요. 사용자는 호스팅 페이지에서 신분증을 업로드하고, 셀피를 찍고, 신원을 인증합니다. 이를 위해 UI를 만들 필요가 없습니다.3
결과 수신하기
identity_profile.updated 웹훅을 구독하세요. 이 웹훅은 프로필이 변경될 때마다(승인, 거부, 조치 필요, 검토 시작 또는 해제) 발생합니다. 웹훅은 새 상태가 아니라 어떤 프로필이 변경되었는지 알려 주므로, GET /api/v1/verifications?account_id={biz_ tag}를 호출해 현재 상태와 인증된 신원 데이터를 읽으세요.빠른 예시
cURL
Response
identity:write 스코프가 있는 계정 API 키가 필요합니다. 자격 증명 유형과 스코프 지정 방법은 인증 및 API 키를 참고하세요. 키를 만들려면 대시보드 → Settings → API Keys로 이동하세요.신원 인증 양식 미리 채우기
신원 필드를 전달하면 사용자가 일부 단계를 건너뛸 수 있습니다. 이 값들이 인증 양식에 미리 입력되므로 사용자가 이름과 주소를 다시 입력할 필요가 없습니다.cURL
tax_identification_number는 해당 사람의 납세자 식별 번호(미국 개인의 경우 SSN)이며,
country가 US인 경우 필수입니다. 이 값이 없으면 지급 계정을 만들 수 없습니다.
있는 그대로 보내세요. 전송 중에 토큰화되며, 원래 값은 Whop 시스템에 절대 저장되지 않습니다.이미 보유한 인증 재사용하기
이미 Sumsub으로 이 사람을 인증했다면, KYC를 다시 거치게 하는 대신 공유 토큰을 보내세요. Whop은 Sumsub 계정이 증명한 신원을 가져와 Whop 자체 요구 사항에 맞는지 확인합니다.cURL
Response
1
Whop과 재사용 가능한 KYC 합의하기
Sumsub은 재사용 가능한 KYC(Reusable KYC) 계약을 맺은 클라이언트 간에만 신청자 데이터를 공개합니다.
계약이 체결되면 Whop이 공유 대상 클라이언트 ID를 제공합니다.
2
신청자의 공유 토큰 생성하기
자체 Sumsub 계정에서 신청자의 ID와 Whop의 클라이언트 ID를
forClientId로 지정해
POST https://api.sumsub.com/resources/accessTokens/shareToken을 호출하세요.3
Whop에 보내기
토큰을
share_token으로 전달하세요. 각 토큰은 한 번만 사용할 수 있습니다.approved는 기존 인증이 Whop에 필요한 모든 것을 충족했으며
더 할 일이 없다는 뜻입니다. session_url과 함께 pending이 반환되면 일부만 충족되었다는 뜻이므로,
사용자를 해당 URL로 보내 아직 누락된 부분만 완료하게 하세요. 데이터가 요구 사항을 전혀 충족하지
못하는 토큰은 Whop이 400으로 거부합니다.
share_token은 documents 또는 document_type과 함께 사용할 수 없습니다. 각각이
호스팅 흐름을 완전히 대체하는 방법입니다.두 가지 인증 유형
계정은 각 유형을 하나씩, 즉 개인 KYC 하나와 사업체 KYB 하나를 가질 수 있습니다.
다음 단계
상태 확인
인증 상태를 확인하고 인증된 신원 데이터를 읽으세요.
RFI 처리
Whop이 은행 거래 내역서 같은 추가 정보를 요청할 때 응답하세요.
업데이트 및 삭제
신원 필드를 업데이트하거나 인증을 제거하세요.
API 레퍼런스
인증 객체의 전체 필드 레퍼런스.

