Skip to main content
인증 만들기 요청에 신원 확인 문서 사진을 보내 API만으로 사람을 인증하세요. 호스팅 세션도, 후속 호출도 필요 없습니다. POST 한 번 후 결과를 폴링하면 됩니다.

전송할 파일

사진 속 문서와 일치하는 document_type을 선택하세요. 이 값에 따라 documents 객체에 포함해야 하는 키가 정확히 결정됩니다. 더도 덜도 아닌 딱 그 키들입니다. 모든 값은 파일의 원시 바이트를 base64로 인코딩한 것입니다.

파일 규칙

  • JPEG(Joint Photographic Experts Group), PNG(Portable Network Graphics) 또는 PDF. Whop은 파일의 실제 바이트로 유형을 감지하므로 확장자는 중요하지 않습니다.
  • selfie는 본인 얼굴이 나온 JPEG 또는 PNG 사진이어야 합니다.
  • 파일당 최대 5MB이며, 인코딩 전 크기로 측정합니다.
  • 전체 세트를 한 번의 요청으로 보내세요. 파일이 누락되었거나, 너무 크거나, 읽을 수 없으면 정확한 키를 명시한 오류와 함께 전체 요청이 실패합니다. 해당 파일을 수정하고 같은 요청을 다시 보내세요. 일부만 제출되는 경우는 절대 없습니다.

전체 예시

201은 Whop이 모든 문서를 수락하고 검토를 시작했다는 뜻입니다. 응답의 required_documents에는 각 키가 submitted로 표시됩니다. status가 approved 또는 rejected가 될 때까지 인증 조회를 폴링하세요.
business_website는 선택 사항입니다. 생략하면 지급 설정에 계정의 whop.com 페이지가 사용됩니다. 값을 보내는 경우 외부 사이트나 소셜 링크여야 합니다. Whop 스토어 페이지는 거부됩니다.

Whop이 문서를 거부하는 경우

검토자가 사진을 수락할 수 없으면 status가 action_required로 돌아가고, 거부된 키가 required_documents에 rejection_reason과 함께 pending_upload로 표시됩니다. 더 나은 사진으로 같은 인증 만들기 요청을 다시 보내세요. 검토는 자동으로 재개됩니다.

국가별 지원 범위

Whop은 대부분의 국가에 있는 사람에 대해 id_card, drivers, passport를 허용합니다. 아래 표는 예외를 나열합니다. 이 표에 있는 국가의 경우 나열된 값만 사용할 수 있습니다. 그 외의 값은 앞서 설명한 거부 흐름을 통해 반환됩니다. Whop은 대부분의 국가에서 residence_permit도 허용하지만, 지원 범위는 더 좁습니다. 앞의 표 외에도 다음 국가에 있는 사람에 대해서는 이를 허용하지 않습니다. AG, AW, BB, BF, BI, BL, BZ, CV, CW, DM, GG, GI, GN, GS, GU, GY, IM, IO, JE, KI, KM, LC, LR, MF, ML, MP, MQ, MU, NC, NR, NU, NZ, PF, PG, PN, PR, PS, PW, SB, SC, SM, SR, ST, SX, SY, SZ, TC, TL, TO, VC, VI, WS Whop은 다음 국가에 있는 사람에게 신원 인증을 제공하지 않으며 모든 문서 유형을 거부합니다. AF(아프가니스탄), BY(벨라루스), CU(쿠바), HT(아이티), IQ(이라크), IR(이란), KP(북한), LY(리비아), MM(미얀마), MZ(모잠비크), RU(러시아), SD(수단), SO(소말리아), SS(남수단)
이 표는 2026년 7월 기준 Whop의 인증 구성을 반영합니다. 국가별 허용 여부는 검토 중에 적용되므로, 해당 사람의 국가에서 유효하지 않은 문서 유형은 사전 오류가 아니라 rejection_reason과 함께 실패합니다.