Skip to main content

작동 방식

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 시스템에 절대 저장되지 않습니다.
Whop은 제재 대상 국가 또는 지역의 사용자를 지원할 수 없습니다. 요청은 400과 오류 코드 address_country_sanctioned로 실패합니다.

이미 보유한 인증 재사용하기

이미 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 레퍼런스

인증 객체의 전체 필드 레퍼런스.