Skip to main content
Whop은 사용자에게 문서, 세금 ID, 사업체 정보 같은 추가 정보가 필요할 때 **정보 요청(RFI, Request for Information)**을 생성합니다. 열려 있는 각 RFI는 인증의 requested_information 배열에 표시됩니다. 사용자가 모든 항목에 답할 때까지 인증의 status는 action_required로 유지됩니다. 각 항목은 수집할 하나의 정보를 나타내며, 한 번의 쓰기로 답합니다. requirement는 필요한 것을, 입력 type은 수집 방법을, label은 사용자에게 보여 줄 텍스트를 제공합니다. 응답에서는 항목에 해당하지 않는 키가 생략됩니다. 전체 목록은 모든 요구 사항을 참고하세요.

RFI 작동 방식

1

정보가 요청됨

Whop이 무언가가 필요하다고 표시합니다. 인증 상태가 action_required로 바뀌고 identity_profile.updated 웹훅이 발생합니다. (이 전환에는 identity_profile.needs_action도 발생하지만, identity_profile.updated는 모든 상태 변경을 포괄하는 웹훅입니다. 이를 구독하고 인증을 다시 가져와 남은 항목을 확인하세요.)
2

항목 읽기

GET /api/v1/verifications?account_id={biz_ tag}를 호출하세요. 각 인증의 requested_information 배열에 필요한 것과 수집할 답변 유형이 나열됩니다.
3

수집 및 제출

사용자에게서 정보를 받아 requested_information 배열과 함께 PATCH /api/v1/verifications/{id}로 다시 보내세요. Whop이 각 답변을 올바른 곳으로 전달합니다.
4

검토 계속

답변한 항목은 배열에서 사라집니다. 배열이 비면 답변을 검토하는 동안 인증이 processing으로 이동하며, 이 상태에서는 제출할 것이 없습니다. 최종적으로 approved가 되거나, 컴플라이언스 검토가 시작되면 manual_review가 됩니다. 답변이 거부되면 해당 항목은 이유를 설명하는 errors와 함께 action_required로 돌아갑니다. 다시 제출하세요.

RFI 읽기

cURL
RFI가 남아 있을 때 인증은 다음과 같습니다.

항목 필드

응답은 항목에 해당하는 키만 반환하므로, 항목에 확인해야 할 빈 배열이나 null이 포함되는 일은 없습니다. 응답은 열려 있는 항목만 반환합니다. 답변한 항목은 배열에서 사라지므로, 배열에 있는 항목은 모두 사용자가 아직 제출해야 하는 것입니다. 배열이 빌 때까지 인증은 action_required로 유지됩니다.

RFI에 답하기

requested_information 배열과 함께 인증의 idpf_ 태그로 PATCH를 보내세요. 각 항목에는 항목 id와 항목의 type에 맞는 정확히 하나의 답변 페이로드가 필요합니다. 항목의 다른 정보(카테고리나 문서 유형 등)는 다시 보낼 필요가 없습니다. 항목 id로 Whop이 답변이 속한 곳을 알 수 있습니다. 한 번의 요청으로 여러 항목에 답할 수 있습니다.
cURL

텍스트, 날짜, 전화번호, 선택 값

답변을 value로 전달하세요. 날짜는 YYYY-MM-DD, 전화번호는 E.164 형식(+12125550123)을 사용하며, 선택 값은 항목의 options 중 하나여야 합니다.

주소

address 객체를 전달하세요.
cURL
개인 또는 사업체 주소에는 사서함(PO box)을 사용할 수 없습니다.

문서

먼저 파일을 업로드한 다음 files에 해당 ID를 전달하세요.
cURL
각 항목에는 업로드 흐름에서 받은 file_ ID 또는 직접 업로드에서 받은 direct_upload_id를 사용합니다. 문서는 최대 32MB의 JPEG(Joint Photographic Experts Group), PNG(Portable Network Graphics) 또는 PDF 파일이어야 합니다. 한 페이지 문서는 항목이 하나인 목록이며, 별도의 단일 파일 필드는 없습니다. requirement가 Whop에 필요한 문서를 지정하고 나머지는 Whop이 처리하므로, 업로드한 문서의 종류를 명시할 필요가 없습니다.

여러 페이지로 된 문서

여러 페이지로 된 문서는 같은 files 목록에 페이지 순서대로 넣습니다.

신원 확인 문서

id_document 항목은 어떤 ID인지 묻습니다. 검토에서 허용하는 ID 유형을 나열한 options를 포함하며, 답변에서는 인증 만들기가 받는 것과 같은 키로 각 슬롯을 지정합니다.
cURL
키가 문서와 면을 동시에 지정하므로, 문서가 어떤 ID인지 나타내는 별도의 필드는 없습니다. Whop이 키로부터 이를 파악합니다. 업로드하는 문서의 모든 슬롯을 보내세요. Whop은 두 문서의 슬롯이 섞여 있거나 불완전한 문서는 아무것도 저장하기 전에 거부합니다. 항목의 options에 해당 검토에서 허용하는 ID 유형이 나와 있습니다. 파일 항목에 options가 없으면 value가 필요하지 않습니다.

민감한 값

세금 및 정부 ID 번호(ssn, ein, company_tax_id, personal_id_number)는 다른 값과 똑같이 제출하세요. Whop은 전송 중에 이를 보안 토큰으로 대체하고 보안 참조만 저장합니다.
cURL
이미 직접 값을 토큰화하고 있다면(Basis Theory), 대신 value_type: "vault_token"과 함께 토큰 ID를 전달하세요.

거부된 답변

Whop이 제출된 답변을 거부하면, 해당 항목은 errors가 설정된 상태로 requested_information에 돌아옵니다.
사용자에게 reason을 보여 주고, 필요하면 code에 따라 분기하세요. 인식할 수 없는 코드는 일반적인 거부로 처리하세요. 근본적인 문제를 해결하고 같은 항목 id로 다시 제출하세요. Whop이 수정된 답변을 수락할 때까지 인증은 action_required로 유지됩니다.

문서 거부 코드

Whop이 업로드된 문서를 거부하면 code가 무엇이 잘못되었는지 알려 줍니다. 받을 수 있는 코드는 다음과 같습니다. 여기의 모든 코드는 업로드에서 수정 가능한 문제를 설명합니다. Whop이 이 중 하나로 분류할 수 없는 거부는 사용할 수 없는 코드 대신 errors 없이 반환됩니다. errors가 없는 항목도 항상 처리하고, 사용자에게 보여 줄 텍스트로는 reason을 우선 사용하세요.

모든 요구 사항

각 항목의 requirement는 아래 값 중 하나입니다.

개인 정보

세금 및 정부 식별 번호

Whop은 전송 중에 이 값들을 보안 토큰으로 대체합니다. 민감한 값을 참고하세요.

신원 확인 문서

사업체 정보

사업체 문서

지급 계정 문서

지급 대상을 인증하기 위해 요청되는 문서는 문서 자체를 지정합니다. 파일 하나를 업로드하세요. label이 사용자에게 어떤 계정에 대한 것인지 알려 줍니다.

검토 질문