Skip to main content
계정과 사용자는 Whop이 지급이나 규정 준수에 민감한 워크플로를 활성화하기 전에 신원을 확인해야 할 때 인증을 완료합니다. Verifications API를 사용하여 호스팅된 인증 세션을 시작하거나 재개하고, 검토 상태를 확인하고, 요청된 정보나 문서를 제출하세요. requested_information에 항목이 있으면 Update Verification으로 답변을 제출하세요.
레거시 Verifications 리소스를 대체합니다. 기존 레거시 통합은 계속 작동합니다. 안정성 약속은 API 버전을 참조하세요.

엔드포인트

속성

string
인증 프로필 ID이며, 접두사는 idpf_입니다.
string[]
필수
이 인증이 조회된 대상 계정으로, 각각 biz_ 접두사가 붙습니다: 목록 조회에 사용한 계정, include_subaccounts 사용 시 인증이 속한 계정 또는 하위 계정, 또는 ID로 조회한 경우 인증이 속하며 읽을 수 있는 모든 계정. 보통 하나입니다. 개인 인증의 경우 비어 있습니다.
object | null
인증 프로필의 주소. 주소가 설정되지 않은 경우 null입니다.

속성

string | null
string | null
US, DE, GB와 같은 두 글자 ISO 3166-1 국가 코드.
string
도로명 주소의 첫 번째 줄.
string | null
도로명 주소의 두 번째 줄.
string | null
우편번호입니다.
string | null
CA와 같은 주, 도 또는 지역 코드.
string | null
법적 사업자명.
string | null
private_corporation 또는 sole_proprietorship과 같은 비즈니스의 법적 실체 구조. 지원되는 값은 설립 국가에 따라 다릅니다. 비즈니스 구조를 참조하세요.
string | null
US, DE, GB와 같은 두 글자 ISO 3166-1 국가 코드.
string
인증 프로필이 생성된 시점(ISO 8601 타임스탬프).
string | null
YYYY-MM-DD 형식.
string | null
인증 프로필의 이메일 주소.
string | null
string | null
비즈니스 인증에 기록된 비즈니스 설립일(YYYY-MM-DD 형식). 비즈니스 인증에만 해당하며, 전송될 때까지 null입니다.
string
사용 가능한 옵션: individual, business
string | null
object[]
필수
비즈니스의 소유자와 각 소유자 자신의 인증 진행 상황. 개인 인증의 경우 비어 있습니다.

속성

string
필수
소유자 ID이며, 접두사는 own_입니다. 호스팅된 세션에서 추가된 소유자를 포함하여 소유자를 변경하거나 제거하려면 Update Verification의 owners에 이 값을 보내세요.
string | null
필수
기록된 소유자의 생년월일(YYYY-MM-DD 형식).
string | null
필수
string | null
필수
number | null
필수
개인이 소유한 비즈니스 지분(0~100).
string[]
필수
소유자의 인증이 반려되었을 때 제공업체가 거부한 항목: details(이름, 생년월일 또는 기타 정보가 신분증과 일치하지 않음), identity_document 또는 selfie. Update Verification으로 이 항목만 수정하세요. 그 외에는 비어 있습니다.사용 가능한 옵션: details, identity_document, selfie
object[]
필수
소유자의 문서와 진행 상황. verification_id로 추가된 소유자의 경우 비어 있습니다.

속성

string
id_card_front, id_card_back 또는 selfie와 같은 문서 슬롯 키.
string | null
제공업체가 새 문서를 요청하거나 인증을 거절한 경우, 이전 제출이 거부된 이유.
string
문서가 검토를 위해 전달될 때까지는 pending_upload, 그 이후에는 submitted입니다.사용 가능한 옵션: pending_upload, submitted
string[]
필수
해당 개인과 비즈니스의 관계.사용 가능한 옵션: ubo, director, representative, shareholder
string
필수
소유자 자신의 인증 진행 상태로, status와 같은 상태를 사용합니다. 문서를 다시 보내야 하는 경우 action_required입니다.사용 가능한 옵션: not_started, pending, processing, manual_review, approved, rejected, action_required
string | null
인증 프로필의 전화번호.
string | null
비즈니스 인증에 기록된 비즈니스 설립 주 또는 지역. 비즈니스 인증에만 해당하며, 전송될 때까지 null입니다.
string | null
미국의 주 파일 번호나 영국의 Company Number처럼 비즈니스가 설립지에서 등록된 번호. 비즈니스 인증에만 해당하며, 비즈니스 인증에 기록된 값이거나 전송될 때까지 null입니다.
object[]
검토를 계속하기 전에 Whop이 아직 필요로 하는 항목으로, 항목당 하나의 요구 사항입니다. Update Verification으로 답변하세요. 응답의 어떤 내용도 다시 표시되지 않습니다. 해당하지 않는 키는 생략됩니다. documents 또는 owners로 생성된 비즈니스 인증의 경우, 검토를 위해 전송하기 전에 아직 누락된 비즈니스 정보와 문서가 포함됩니다. 각 소유자의 문서는 해당 소유자 아래에 나열됩니다.

속성

string
필수
요청된 정보 항목 ID이며, 접두사는 inrqi_입니다.
string
라이브니스 인증 완료나 결제 보기와 같은 관련 작업의 URL. 사용 가능한 작업이 없으면 없습니다.
string
value 대신 이 항목에 답변하는 문서로, 예를 들어 EIN을 매칭할 수 없을 때의 IRS EIN 서한입니다. 수정된 value와 함께 또는 없이 문서의 페이지를 files로 보내세요. value만 허용되는 경우 없습니다.
string
이 요구 사항과 함께 표시되는 후속 질문.
boolean
표시될 때 후속 응답이 필수인지 여부.
string[]
후속 질문을 표시하게 하는 선택된 옵션 값.
object[]
제출이 거부된 후에 존재합니다.

속성

string
고정 오류 코드.
string
거부된 이유.
string
필수
사용자에게 표시할 안내. 검토자의 메모가 있으면 그대로 포함합니다.
boolean
항목을 건너뛸 수 있으면 true입니다.
string[]
select 항목에서 value가 가질 수 있는 값. id_document 항목에서는 허용되는 신분증 유형이며, 선택한 유형에 따라 보낼 documents 슬롯이 결정됩니다. 항목에 선택할 사항이 없으면 없습니다.
string
필수
필요한 것: bank_statement와 같은 문서 이름, 또는 ssn이나 identity_document와 같은 필드 키. 인식할 수 없는 값은 type으로 처리하세요.
string
텍스트 응답을 위한 선택적 네이티브 입력 형식.사용 가능한 옵션: yes_no, yes_no_na, date, url, number, tel
string
options가 있는 질문이 하나의 값을 받는지 여러 값을 받는지 여부.사용 가능한 옵션: single, multiple
object[]
컨텍스트를 위해 요구 사항과 함께 제공되는 문서.

속성

string
필수
파일 ID로, 접두사는 file_입니다.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
string | null
필수
원본 파일의 MIME 유형으로, 예를 들어 application/pdf입니다. 모더레이션으로 파일이 삭제되어도 유지됩니다.
string
필수
파일이 생성된 시점으로, ISO 8601 타임스탬프입니다.
number | null
필수
오디오 또는 동영상의 재생 시간(초)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름입니다.
integer | null
필수
이미지 또는 동영상의 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
integer | null
각 파트(마지막 파트 제외)가 가져야 하는 바이트 크기입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
string | null
멀티파트 업로드의 ID로, complete에 다시 전달합니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.
object[] | null
각 파트의 미리 서명된 URL입니다. 생성 시에만, 그리고 멀티파트 업로드에서만 존재합니다.

속성

integer
필수
멀티파트 업로드 내에서 이 파트의 1부터 시작하는 인덱스입니다.
string
필수
이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
string
필수
이 객체의 유형으로, 항상 file입니다.
boolean
필수
모더레이션으로 파일이 삭제되었는지 여부입니다. true이면 url은 대체 이미지를 제공합니다. filename, size, content_type은 여전히 원본 파일을 설명합니다.
integer | null
필수
파일 크기(바이트)입니다. 업로드가 완료될 때까지 null입니다.
object
업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 존재합니다.
string
필수
파일의 업로드 수명 주기 단계입니다.사용 가능한 옵션: pending, processing, ready, failed
string | null
파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 그리고 단일 파트 업로드에서만 존재합니다.
string | null
필수
파일을 다운로드할 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명된 URL을 받습니다. 업로드가 완료될 때까지 null입니다. 모더레이션으로 파일이 삭제된 경우 대체 이미지 URL입니다.
string
필수
public 파일은 서명되지 않은 CDN URL에서 제공됩니다. private 파일은 만료되는 서명된 URL에서 제공됩니다.사용 가능한 옵션: public, private
string | null
필수
오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
integer | null
필수
이미지 또는 동영상의 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 삭제된 경우 null입니다.
boolean
필수 증빙 파일을 서면 설명으로 대체할 수 있는지 여부.
boolean
이 요구 사항에 증빙 파일도 필요한지 여부.
string[]
증빙 파일 입력을 표시하게 하는 선택된 옵션 값.
string
필수
추론할 필요가 없도록 답변으로 보낼 내용: files(페이지 목록으로 된 문서), id_document(업로드하는 신분증의 슬롯 키와 함께 documents를 보냄), text, date, phone 또는 select(value를 보냄), text_with_files(value와 선택적 files를 보냄), address(address를 보냄), 또는 liveness(action_url을 연 다음 완료 후 value를 true로 보냄).
object[]
문서 업로드 인증의 문서와 진행 상황. documents를 보내 생성된 개인 인증에만 존재합니다. pending_upload 문서는 아직 수락되지 않았으므로, Create Verification을 다시 호출하여 전체 문서 세트를 다시 보내세요.

속성

string
id_card_front, id_card_back 또는 selfie와 같은 문서 슬롯 키.
string | null
제공업체가 새 문서를 요청하거나 인증을 거절한 경우, 이전 제출이 거부된 이유.
string
문서가 검토를 위해 전달될 때까지는 pending_upload, 그 이후에는 submitted입니다.사용 가능한 옵션: pending_upload, submitted
string | null
사용자가 신원 확인을 완료할 수 있는 호스팅된 인증 세션 URL. 생성 후 7일이 지나면 만료됩니다.
string
현재 인증 상태. 세션이 존재하기 전에는 not_started, 세션에 사용자 입력이 필요한 동안에는 pending, 새 제출에 대해 제공업체의 자동 확인이 실행되는 동안에는 processing, requested_information에 답변이 필요한 경우 action_required, 이미 보낸 정보(감사 답변 또는 지급 제공업체가 보유한 문서)가 검토 중인 동안에는 manual_review(제출할 것은 없으며 보통 영업일 기준 3일 이내에 완료), 성공 시 approved, 실패 시 rejected입니다. 새 세션을 시작하려면 Create Verification을 다시 호출하세요.사용 가능한 옵션: not_started, pending, processing, manual_review, approved, rejected, action_required
string
인증 프로필이 마지막으로 업데이트된 시점(ISO 8601 타임스탬프).
Verification