Skip to main content
통합에서 지원하는 고객, 크리에이터, 판매자, 셀러 또는 연결된 비즈니스에 계정을 사용하세요. Accounts API를 사용하여 계정을 생성하고, 자격 증명으로 볼 수 있는 계정을 나열하고, 계정을 조회하거나 업데이트하고, 플랫폼에서 관리하는 하위 계정을 정지하거나 삭제하고, 현재 API 키와 연결된 계정을 조회할 수 있습니다. business_type, industry_group, industry_type 필드는 계정을 분류합니다. 유효한 모든 값은 비즈니스 유형 및 업종 용어집을 참조하세요.

엔드포인트

수수료 마크업

수수료 마크업을 사용하면 플랫폼이 하위 계정에 요금을 추가하거나 지급 수수료를 보조할 수 있습니다. 계정 수수료 문서를 통해 관리하세요. 플랫폼 계정에서 기본값을 설정하거나 하위 계정에서 개별 수수료를 재정의할 수 있습니다. 예시, 한도, 자금 요구 사항은 수수료 마크업 및 보조금을 참조하세요.

수수료 엔드포인트

마크업을 구성하려면 company:update_child_fees 권한이 있는 플랫폼 계정의 API 키를 사용하세요. 반환되는 각 마크업에는 adjustable과 unadjustable_reason이 포함되어 있어 통합에서 편집 가능 여부를 판단할 수 있습니다.

수수료 읽기

markups 섹션에는 하위 계정의 실제 적용 요율이 포함됩니다. 플랫폼 계정의 child_markups 섹션에는 하위 계정에 대한 기본값이 포함됩니다. 마크업의 source는 해당 수준에서 구성된 경우 custom이고, 상속된 요율이나 0으로 넘어가는 경우 default입니다. default 필드는 사용자 정의 마크업을 지웠을 때 적용될 요율을 보여 줍니다. 반환되는 고정 금액은 Money 객체를 사용하며, 업데이트 시에는 fixed를 미국 달러 단위의 숫자로 받습니다.

플랫폼 기본값 설정

플랫폼 계정에서 child_markups를 업데이트하세요. 이 예시는 고정 요금 없이 2%의 결제 마크업을 설정합니다:
percentage: 2는 2%를 의미합니다. 기본값은 해당 수수료에 대한 재정의가 없는 하위 계정에 적용됩니다. 결제 마크업은 체크아웃 애플리케이션 수수료가 설정되지 않은 경우에 적용됩니다.

하위 계정 재정의 설정

하위 계정에서 markups를 업데이트하세요. 이 예시는 상속된 결제 마크업을 1% + $0.25로 대체합니다:
전송한 키만 변경됩니다. 다른 거래 유형에는 transfers, crypto_swaps, 레일별 키를 사용하는 deposits, 또는 지급 방법별 키를 사용하는 payouts를 사용하세요. 지원되는 키와 요청 스키마는 업데이트 엔드포인트를 참조하세요.

마크업 지우기

마크업을 지우려면 null을 전송하세요. 하위 계정의 재정의를 지우면 플랫폼 기본값이 복원되며, 기본값이 구성되지 않은 경우 0이 됩니다:
플랫폼 기본값을 지우려면 플랫폼 계정에 child_markups: { payments: null }을 전송하세요. 명시적인 { percentage: 0, fixed: 0 }은 구성된 요율로 유지됩니다. 상속을 복원하려면 null을 사용하세요. 계정은 법률 문서를 PDF 파일로 게시합니다: terms_of_service, privacy_policy, return_policy, cancellation_policy, shipping_policy, eula. 각 문서는 File로 반환되며, 업로드한 파일의 id를 사용하여 Update Account로 설정합니다. 새 분쟁은 기본적으로 이 문서들에서 정책 증거를 가져옵니다. 취소 정책 슬롯은 cancellation_policy, 그다음 terms_of_service, 그다음 return_policy 순으로 사용합니다. 환불 정책 슬롯은 return_policy, 그다음 terms_of_service 순으로 사용합니다. 아무것도 설정되지 않은 경우 두 슬롯 모두 Whop의 플랫폼 정책으로 대체되며, shipping_policy는 실물 상품 분쟁에 함께 포함됩니다. 여기서 한 번 설정하고, 특정 분쟁에 다른 버전의 정책이 필요한 경우에만 Upload Dispute Evidence를 사용하세요.
문서를 제거하려면 null을 전송하세요. PDF 파일만 허용됩니다.

속성

string
필수
biz_ 접두사가 붙은 계정 ID.
number | null
필수
계정의 누적 청구된 광고 지출(USD). 계정에 대해 stats:read 권한이 있는 호출자에 대해 list에서만 계산되며, 그 외에는 null입니다.
object[]
필수
계정 보유 자산(각각 USD 가치 포함). total_usd가 null이면 비어 있습니다.

속성

string
필수
보유한 총 금액(기본 단위, 십진수 문자열).
object
필수
사용 가능, 대기 중, 예비 금액으로 나눈 잔액(기본 단위 십진수 문자열)과 대기 중 금액이 정산될 것으로 예상되는 날짜.

속성

string
필수
지금 사용, 송금 또는 인출할 수 있는 금액(기본 단위, 십진수 문자열).
string
필수
이미 정산되어 계정의 암호화폐 지갑 또는 Whop Card로 이동하기를 기다리는 pending의 일부로, 이동 후 available이 됩니다. 이동은 보통 1시간 이내에 시작되며, 진행되는 동안에는 해당 금액이 대신 in_transit에 보고됩니다. 계정의 유지 최소 잔액을 보충하기 위해서만 이동한 금액은 포함되지 않습니다. 기본 단위, 십진수 문자열.
string
필수
카드 충전과 같이 계정 자체의 목적지 간에 이동 중인 금액. 기본 단위, 십진수 문자열.
string
필수
아직 정산 중인 최근 결제의 금액(기본 단위, 십진수 문자열).
object[]
필수
대기 중 금액이 정산될 것으로 예상되는 시기로, 하루에 하나의 항목이 가장 이른 날짜부터 나열됩니다. finishing_settlement를 포함하여 예정된 정산일이 없는 금액은 제외되므로, 이 항목들과 finishing_settlement의 합은 pending보다 작을 수는 있지만 클 수는 없습니다.

속성

string
필수
해당 날짜에 예상되는 금액(기본 단위, 십진수 문자열).
string
필수
이 금액의 정산이 완료될 것으로 예상되는 날짜(ISO 8601 날짜).
string
필수
보류된 금액(기본 단위, 십진수 문자열). 보류 사유와 해제 시점은 계정의 예비금을 조회하여 확인하세요.
string | null
필수
보유 자산 아이콘 URL.
string
필수
보유 자산의 표시 이름
number | null
필수
단위당 USD 가격. 환율을 사용할 수 없는 경우 null입니다.
string
필수
USDT, cbBTC, EUR과 같은 보유 자산 표시 기호.
string | null
필수
보유 자산의 USD 가치. 환율을 사용할 수 없는 경우 null입니다.
string | null
필수
계정 배너 이미지 URL.
object | null
필수
세금 계산에 사용되는 계정의 사업장 주소로, line1, line2, city, state, postal_code, country를 포함합니다. 주소가 설정되지 않은 경우 null입니다.
string | null
필수
세금 주소와 함께 사용되는 계정의 법적 사업자명.
string | null
필수
계정의 상위 수준 비즈니스 카테고리. 유효한 값은 비즈니스 유형 및 업종 용어집을 참조하세요.
boolean
필수
이 플랫폼 계정에서 하위 계정으로 대기 중 자금을 이체할 수 있는지 여부.
object | null
필수
계정의 취소 정책 문서. 게시하지 않은 경우 null입니다.

속성

string
필수
file_ 접두사가 붙은 파일 ID.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
원본 파일의 MIME 유형(예: application/pdf). 모더레이션으로 파일이 제거되어도 유지됩니다.
string
필수
파일이 생성된 시점(ISO 8601 타임스탬프).
number | null
필수
오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름.
integer | null
필수
이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
integer | null
각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
string | null
complete에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
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입니다.
object | null
필수
이 계정에 활성화된 결제 레일로, 각각 active, inactive 또는 pending(온보딩 또는 검토 진행 중)입니다. company:balance:read 범위가 있는 호출자에 대해 retrieve와 me에서만 계산되며, 그 외에는 null입니다.

속성

string
필수
은행 결제 수납: 자동 이체, 계좌 이체 및 현지 은행 레일사용 가능한 옵션: active, inactive, pending
string
필수
선구매 후결제(BNPL) 수납. 승인이 필요합니다사용 가능한 옵션: active, inactive, pending
string
필수
Apple Pay와 Google Pay를 포함한 카드 수납사용 가능한 옵션: active, inactive, pending
string
필수
계정의 가상 은행 계좌로의 은행 송금 또는 ACH 입금사용 가능한 옵션: active, inactive, pending
string
필수
저장된 결제 수단에 청구하여 잔액 충전사용 가능한 옵션: active, inactive, pending
string
필수
Whop 카드 발급. 카드 신청 승인이 필요합니다사용 가능한 옵션: active, inactive, pending
string
필수
계정의 암호화폐 지갑으로의 온체인 입금사용 가능한 옵션: active, inactive, pending
string
필수
암호화폐 지갑으로의 온체인 지급사용 가능한 옵션: active, inactive, pending
string
필수
적격 지급 목적지로의 즉시 지급사용 가능한 옵션: active, inactive, pending
string
필수
Whop Ads를 통한 광고 캠페인 시작. 계정의 신원 또는 비즈니스가 인증될 때까지, 요청된 광고 서비스 계약이 계정의 서명을 기다리는 동안, 그리고 계정이 Whop Ads에서 정지된 동안에는 inactive입니다.사용 가능한 옵션: active, inactive, pending
string
필수
외부 지급 목적지로의 일반 지급사용 가능한 옵션: active, inactive, pending
string
필수
다른 계정으로의 이체사용 가능한 옵션: active, inactive, pending
object | null
필수
계정의 Whop Cards 신청 세부 정보. company:balance:read 범위가 있는 호출자에 대해 list, retrieve, me에서 반환되며, 그 외에는 null이고 계정에 카드 신청이나 차단 신청 검토가 없는 경우에도 null입니다.

속성

string | null
필수
카드 발급사가 신청을 거절한 사유. 미국 내 인증된 개인 또는 비즈니스의 경우 unsupported_state가 unsupported_region을 대체합니다. compliance는 제재, 정치적 주요 인물 및 부정적 미디어 검사를 포함합니다. other는 이 목록에 없는 사유를 포함합니다. status가 denied가 아니거나 발급사가 신청을 거절하지 않은 경우 null입니다.사용 가능한 옵션: compromised_identity, duplicate, unsupported_region, compliance, fraud, verification_failed, unsupported_state, other
string | null
필수
카드 신청이 비즈니스(business, KYB)를 인증하는지 개인(individual, 소비자 신원)을 인증하는지 여부. 신청이 아직 인증에 연결되지 않은 경우 null입니다.사용 가능한 옵션: individual, business
string
필수
카드 신청의 현재 상태. approved는 카드를 발급할 수 있음을 의미합니다. needs_verification은 신청자가 아직 신원 인증을 완료하지 않았음을 의미하고, needs_information은 인증을 완료했지만 수정 가능한 사유로 서류가 거부되어 다시 제출해야 함을 의미합니다. pending과 manual_review는 진행 중입니다. denied, locked, canceled는 최종 상태입니다.사용 가능한 옵션: approved, pending, manual_review, denied, locked, canceled, needs_verification, needs_information
boolean
필수
체크아웃에서 구매자가 선택적으로 입력할 수 있는 VAT/세금 ID 필드를 표시할지 여부. 구매에 VAT ID가 필요하지는 않습니다.
object
필수
Form Company를 통해 관리되는 계정의 회사 설립 상태. 설립 체크아웃이 결제될 때까지 status는 draft이며, 이후에는 다운로드 가능한 문서와 처리 대기 중인 서명을 포함한 신고 진행 상황을 나타냅니다. 설립 상태를 일시적으로 사용할 수 없는 경우 비어 있습니다.

속성

object[]
정관(Articles of Organization) 및 EIN 확인서와 같이 다운로드 가능한 설립 문서. status가 draft를 벗어나면 존재합니다.

속성

string
필수
file_ 접두사가 붙은 문서 ID.
string
필수
Articles of Organization과 같이 사람이 읽을 수 있는 문서 이름.
string
필수
문서 카테고리: articles_of_organization, operating_agreement, ein_letter, signed_ss4, signed_form8821, 또는 회사를 대신하여 받은 우편물의 경우 mail.
string
필수
문서를 다운로드할 CDN URL.
boolean
IRS가 회사의 EIN을 발급했는지 여부. status가 draft를 벗어나면 존재합니다.
법인 형태 접미사를 포함한 등록 회사명(예: Acme, LLC). status가 draft를 벗어나면 존재합니다.
object
아직 설립자의 서명을 기다리고 있는 IRS 양식으로, 각각 호스팅된 서명 URL이 포함됩니다. status가 draft를 벗어나면 존재하며, 서명할 항목이 없으면 비어 있습니다.

속성

object
세금 정보 승인서인 IRS Form 8821의 서명 상태. 양식에 아직 설립자의 조치가 필요한 동안에만 존재합니다.

속성

string
서명 URL이 만료되는 시점(ISO 8601 타임스탬프). 서명 URL이 포함된 경우에만 존재합니다.
string
필수
설립자를 위한 서명 세션이 준비되면 pending, 서명 상태를 확인할 수 없으면 unknown입니다.사용 가능한 옵션: pending, unknown
string
설립자가 양식을 작성하는 호스팅된 서명 URL. status가 pending이고 호출자에게 incorporation:write가 있는 동안 존재합니다. 웹훅에서는 생략됩니다.
object
EIN 신청서인 IRS Form SS-4의 서명 상태. 양식에 아직 설립자의 조치가 필요한 동안에만 존재합니다.

속성

string
서명 URL이 만료되는 시점(ISO 8601 타임스탬프). 서명 URL이 포함된 경우에만 존재합니다.
string
필수
설립자를 위한 서명 세션이 준비되면 pending, 서명 상태를 확인할 수 없으면 unknown입니다.사용 가능한 옵션: pending, unknown
string
설립자가 양식을 작성하는 호스팅된 서명 URL. status가 pending이고 호출자에게 incorporation:write가 있는 동안 존재합니다. 웹훅에서는 생략됩니다.
boolean
주(州) 설립 신고가 완료되었는지 여부. status가 draft를 벗어나면 존재합니다.
string
사용 가능한 옵션: draft, processing, filed, rejected, completed
string | null
필수
계정이 위치한 국가.
string
필수
계정이 생성된 시점(ISO 8601 타임스탬프).
integer | null
필수
지난 30일 동안 계정에서 결제 완료 영수증이 있는 고유 고객 수로, 몇 시간마다 갱신됩니다. 계정에 대해 stats:read 권한이 있는 호출자에 대해 retrieve에서만 계산되며, 그 외에는 null이고 집계를 사용할 수 없는 경우에도 null입니다.
string | null
필수
계정 홍보 설명.
integer
상위 관리자 없이 비즈니스에 직접 보고하는 팀원 수. 단일 계정 조회 시 존재합니다.
boolean
필수
Whop이 이 계정의 분쟁 증거를 수집하고 제출하는지 여부. 활성화하면 계정이 승소한 분쟁에 부과되는 성공 수수료에 동의하게 됩니다.
boolean
필수
계정에서 Economic Intelligence가 켜져 있는지 여부. 약정 기간이 끝나면 자동으로 꺼집니다. 꺼져 있는 동안에는 계정이 실험을 활성화하거나 추천을 실행할 수 없습니다.
string | null
필수
계정 소유자 이메일 주소.
object | null
필수
계정의 최종 사용자 라이선스 계약 문서. 게시하지 않은 경우 null입니다.

속성

string
필수
file_ 접두사가 붙은 파일 ID.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
원본 파일의 MIME 유형(예: application/pdf). 모더레이션으로 파일이 제거되어도 유지됩니다.
string
필수
파일이 생성된 시점(ISO 8601 타임스탬프).
number | null
필수
오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름.
integer | null
필수
이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
integer | null
각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
string | null
complete에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
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입니다.
string | null
필수
상위 플랫폼이 이 하위 계정에 부여한 자체 식별자로, 플랫폼의 하위 계정 간에 고유합니다. 설정되지 않은 경우 null입니다.
object | null
필수
계정의 가장 최근 금융 신청. company:balance:read 범위가 있는 호출자에 대해 retrieve와 me에서만 계산되며, 그 외에는 null이고 계정이 금융을 신청한 적이 없는 경우에도 null입니다.

속성

string
필수
inrq_로 시작하는 계정의 가장 최근 금융 신청 ID. 요구 사항과 검토 피드백을 확인하려면 이를 조회하세요.
string
필수
가장 최근 금융 신청의 검토 상태: requires_collection(추가 정보 요청 이후를 포함하여 판매자를 기다리는 중), awaiting_review, approved, denied, completed. 금융 결제 수단의 활성화 여부는 capabilities.accept_bnpl_payments입니다.사용 가능한 옵션: requires_collection, awaiting_review, completed, approved, denied
string | null
필수
정지된 계정이 자체 지급 방법으로 잔액을 지급할 수 있는 시점(ISO 8601 타임스탬프). 분쟁으로 인해 늦춰질 수 있습니다. retrieve, me, suspend에서 계산되며, 그 외에는 null이고 status가 suspended가 아니거나 정지로 인해 잔액이 보류된 경우에도 null입니다.
string[]
필수
공개 계정 홈페이지 환경설정.사용 가능한 옵션: hide_member_count, hide_members_card
string | null
필수
계정의 구체적인 업종. 유효한 값은 비즈니스 유형 및 업종 용어집을 참조하세요.
string | null
필수
계정 인보이스에 사용되는 접두사.
object | null
필수
계정 owner의 Whop Levels 진행 상황으로, 소유자가 소유한 모든 계정에 걸쳐 집계되므로 모든 계정에 동일한 레벨이 표시됩니다. company:basic:read 범위가 있는 호출자에 대해 retrieve와 me에서만 계산되며, 그 외에는 null이고 계정이 Whop Levels에 참여하지 않은 경우에도 null입니다.

속성

integer
필수
이 계정 자체의 포인트만으로 산정한 레벨로, 0부터 10까지입니다. 소유자의 다른 계정이 레벨을 끌어올리면 current가 더 높습니다.
integer
필수
적용되는 레벨: 소유자가 이번 달 또는 그 이전 5개월 동안 도달한 최고 레벨로, 0부터 10까지입니다.
integer
필수
소유자가 소유한 모든 계정에서 이번 달에 획득한 포인트와 소유자의 파트너 포인트를 합산하여 내림한 값. 월 순합계가 0 미만인 계정은 0으로 계산됩니다.
object
필수
이번 달 포인트를 획득처별로 나눈 값. 각 획득처는 환불을 차감한 순액이므로 음수일 수 있습니다.

속성

integer
필수
환불을 차감한 결제된 Whop Ads 청구액에서 얻은 포인트: 1달러당 10포인트, 0 방향으로 반올림.
integer
필수
환불을 차감한 확정된 Whop Card 지출에서 얻은 포인트: 1달러당 10포인트, 0 방향으로 반올림.
integer
필수
소유자가 파트너로서 추천한 계정에서 얻은 포인트: 해당 계정이 3포인트를 얻을 때마다 1포인트, 0 방향으로 반올림.
integer
필수
Whop을 통해 체결된 무기한 선물 거래량에서 얻은 포인트: 거래 1달러당 1포인트, 0 방향으로 반올림.
string
필수
이번 달 포인트가 0으로 초기화되는 시점(ISO 8601 타임스탬프).
string | null
필수
계정 로고 이미지 URL.
object
필수
계정 생성 시 제공된 임의의 키/값 메타데이터.
string | null
필수
계정이 완료한 온보딩 유형.사용 가능한 옵션: platform, seller
string | null
필수
계정 Open Graph 이미지 URL.
string | null
필수
계정 Open Graph 이미지 변형.사용 가능한 옵션: white, black, orange
boolean
필수
이 계정에 결제 오케스트레이션이 활성화되어 있는지 여부.
string | null
필수
business_type이 other인 경우의 비즈니스 유형 세부 정보.
string | null
필수
industry_type이 other인 경우의 업종 세부 정보.
object
필수
계정을 소유한 단일 사용자로, 이 사용자의 이메일이 위의 email입니다. 팀원의 owner 역할과는 다르며, 해당 역할은 여러 명이 가질 수 있습니다.

속성

string
필수
user_ 접두사가 붙은 사용자 ID.
string | null
필수
표시 이름.
object
필수
아바타 래퍼. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
string
필수
공개 사용자 이름.
object | null
필수
하위 계정의 상위 계정. 독립 계정의 경우 null입니다.

속성

string
필수
biz_ 접두사가 붙은 계정 ID.
object
이 상위 계정이 조회 대상 하위 계정에 부과하는 마크업 요율로, 수수료 유형별 키(예: crypto_deposit_markup)를 사용하며 각각 percentage_fee와 fixed_fee_usd를 포함합니다. 하위 계정 자체의 재정의가 플랫폼 기본값보다 우선하여 결정됩니다.
string | null
필수
계정 로고 이미지 URL.
string
필수
계정 공개 경로 식별자.
string
필수
계정 표시 이름.
object | null
계정의 활성 1차 파트너. 조회 응답에 존재하며, 계정에 귀속된 활성 1차 파트너가 없는 경우 null입니다. 다른 응답에서는 생략됩니다.

속성

string
필수
user_ 접두사가 붙은 사용자 ID.
string | null
필수
파트너 연락용 이메일 주소. 파트너가 자신의 이메일 주소를 추가하지 않은 경우 Null입니다.
string | null
필수
표시 이름.
object
필수
아바타 래퍼. url은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.

속성

string
필수
아바타 이미지 URL. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
object | null
필수
추천이 파트너의 팀에 속한 경우, 파트너가 이 계정을 대신 추천한 비즈니스. 개인 추천의 경우 null입니다.

속성

string
필수
biz_ 접두사가 붙은 계정 ID.
string
필수
계정 표시 이름.
string
필수
공개 사용자 이름.
string | null
필수
사용자가 인증된 Whop Partner가 된 시점(ISO 8601 타임스탬프). 인증되지 않은 경우 Null입니다.
object | null
필수
계정에 현재 적용된 결제 건전성 제어. company:balance:read 범위가 있는 호출자에 대해 retrieve와 me에서만 계산되며, 그 외에는 null입니다.

속성

object
필수
차지백 전 분쟁 알림에 대한 자동 환불 설정.

속성

boolean
필수
계정 소유자가 이 임계값을 변경하지 못하도록 막혀 있는지 여부.
number | null
필수
자동으로 환불되는 최대 분쟁 알림 금액(USD). 자동 환불이 비활성화된 경우 null입니다.
number | null
필수
분쟁 알림당 부과되는 수수료(USD). 사용할 수 없는 경우 null입니다.
boolean
필수
체크아웃의 모든 카드 결제에 3-D Secure가 강제되는지 여부. 설정된 동안 계정은 이를 우회할 수 없습니다.
boolean
필수
결제 건전성 제어가 금융을 명시적으로 비활성화하는지 여부. 이는 capabilities.accept_bnpl_payments의 금융 승인과는 별개입니다.
number
필수
고위험 처리에 대한 추가 처리 수수료율.
object[]
필수
분쟁률 한도에 가까워지고 있다는 경고를 받은 결제 수단. 각 항목에는 payment_method, measure(disputes, disputes_and_tc40s 또는 fraud_disputes), ISO 8601 타임스탬프인 warned_at, 그리고 0.01이 1%인 분수로 표현된 rate, warning_rate, target_rate가 포함됩니다. 경고를 받은 수단이 없으면 비어 있습니다. 경고를 받은 수단이 약 4주 후에도 목표 비율을 초과하면 일시 중지되고 restricted_payment_methods에 표시됩니다.
number
필수
아직 정산되지 않은 대기 중 잔액을 계정의 카드 잔액 충전을 위해 선지급할 때 부과되는 수수료율로, 2는 2%를 의미합니다. 계정이 면제된 경우 0입니다.
integer
필수
결제가 사용 가능해지기 전에 대기 상태로 유지되는 추가 일수.
object
필수
들어오는 결제 금액에 현재 적용된 예비금.

속성

integer
필수
예비 자금이 해제되기 전까지 보류되는 일수.
number | null
필수
들어오는 결제 금액 중 예비금으로 보류되는 비율. 예비금이 적용되지 않은 경우 null입니다.
object
필수
해결 센터 사례에 대한 자동 환불 설정.

속성

number | null
필수
자동으로 환불되는 카드 결제 해결 센터 사례의 최대 금액(USD). 카드에 대한 자동 환불이 비활성화된 경우 null입니다.
number | null
필수
자동으로 환불되는 금융 결제 해결 센터 사례의 최대 금액(USD). 금융에 대한 자동 환불이 비활성화된 경우 null입니다.
boolean
필수
계정 소유자가 이 임계값들을 변경하지 못하도록 막혀 있는지 여부.
number | null
필수
자동으로 환불되는 PayPal 결제 해결 센터 사례의 최대 금액(USD). PayPal에 대한 자동 환불이 비활성화된 경우 null입니다.
string[]
필수
이 계정의 체크아웃에서 차단된 카드 브랜드. 차단된 브랜드가 없으면 비어 있습니다. 계정이 직접 다시 활성화할 수 없습니다.사용 가능한 옵션: card_visa, card_mastercard, card_american_express, card_discover_global_network, addi, affirm, afterpay_clearpay, alma, billie, capchase_pay, claritypay, flex_pay, klarna, kriya, kueski, mondu, oney, scalapay, sequra, sezzle, splitit, sunbit, tabby, tamara, zip, card_installments_three, card_installments_six, card_installments_twelve, oney_3x, oney_4x, klarna_pay_now, us_bank_account, sepa_debit, bacs_debit, au_becs_debit, acss_debit, pay_by_bank, payto, paypal, cashapp, venmo, amazon_pay, link, wechat_pay
string | null
필수
정산일이 없는 대기 중 자금이 아직 이동하지 않는 이유. kyc_incomplete, pending_information_request, update_payout_profile은 판매자가 조치할 수 있는 항목입니다. compliance_review는 판매자가 이미 제출한 인증을 검토 중이므로 검토가 완료될 때까지 이 자금이 대기 상태로 유지됨을 의미합니다. withdrawals_disabled는 Whop이 인출을 차단하여 이 자금이 사용 가능해질 수 없음을 의미합니다. 표시할 사유가 없는 경우 null입니다 — 아직 정산 중이거나 여기에 명시되지 않은 사유로 보류된 경우입니다.사용 가능한 옵션: kyc_incomplete, pending_information_request, update_payout_profile, compliance_review, withdrawals_disabled
object
필수
계정 잔액이 자동으로 인출되는 방식.

속성

integer | null
필수
자동 인출이 실행되는 날: weekly의 경우 0-6(일요일-토요일), monthly의 경우 1-31. manual과 daily의 경우 null입니다.
string
필수
계정 잔액이 자동으로 인출되는 빈도.사용 가능한 옵션: manual, daily, weekly, monthly
string | null
필수
자동 인출이 다음으로 예정된 날짜(ISO 8601 날짜). 단일한 다음 날짜가 적용되지 않는 manual과 daily의 경우 null입니다.
object | null
필수
체크아웃에서 계정의 기본 결제 수단. 변형 또는 체크아웃 구성 자체의 payment_method_configuration이 우선합니다. 계정이 Whop의 플랫폼 기본값을 사용하는 경우 null입니다.

속성

string[]
필수
기본값이 제공하더라도 이 체크아웃에서 제외하는 결제 수단.
string[]
필수
기본값이 제공하는 것 외에 이 체크아웃에서 추가로 제공하는 결제 수단.
boolean
필수
Whop의 기본 세트를 시작점으로 사용할지 여부. false이면 enabled만 제공됩니다.
object[]
필수
잔액 캐시에서 읽은 통화별 Whop 발행 플랫폼 크레딧. 크레딧은 Whop Ads와 같은 적격 Whop 상품에만 사용할 수 있고, 인출할 수 없으며, balances 또는 total_usd에 포함되지 않습니다. 계정에 크레딧이 없거나 total_usd가 null이면 비어 있습니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
계정의 개인정보 처리방침 문서. 게시하지 않은 경우 null입니다.

속성

string
필수
file_ 접두사가 붙은 파일 ID.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
원본 파일의 MIME 유형(예: application/pdf). 모더레이션으로 파일이 제거되어도 유지됩니다.
string
필수
파일이 생성된 시점(ISO 8601 타임스탬프).
number | null
필수
오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름.
integer | null
필수
이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
integer | null
각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
string | null
complete에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
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입니다.
object | null
필수
계정 상품에 기본으로 적용되는 세금 분류 코드로, id, name, product_type을 포함합니다. 기본값이 설정되지 않은 경우 null입니다.
사용 중단됨: 대신 GET /economic_intelligence?account_id=\{account_id} 엔드포인트를 사용하세요.

속성

string
필수
추천 항목. 새 값이 추가될 수 있으므로 알 수 없는 작업을 적절히 처리하세요사용 가능한 옵션: theme_business, create_product, create_plan, verify_identity, connect_affiliate_program, create_promotion, migrate_from_stripe, accept_first_payment, launch_first_ad, launch_draft_campaign, increase_ad_budget, refresh_ad_creatives, fix_ad_billing, exclude_customers_from_ads, retarget_abandoned_checkouts, fix_funnel_dropoff, invite_team_member, enable_tax_collection, create_card, apply_for_financing
string[]
필수
이 작업으로 잠금 해제되는 기능. 없으면 비어 있습니다
string
필수
행동 유도 버튼이 연결되는 URL
string
필수
버튼 레이블
string
필수
보조 문구. 없으면 비어 있습니다
string | null
필수
일러스트레이션 아이콘 URL 또는 null
integer | null
필수
0-100 사이의 예상 영향도. 순위가 매겨지지 않은 경우 null
string | null
필수
이 작업이 추천된 이유 또는 null
string
필수
항상 선택 사항 — 절대 차단하지 않음사용 가능한 옵션: optional
string
필수
추천 항목의 제목
boolean
필수
승인된 사용자가 2단계 인증을 활성화해야 하는지 여부.
object[] | null
필수
지급 및 카드 사용과 같은 기능의 차단을 해제하기 위해 계정 소유자가 수행해야 하는 작업으로, 표시 우선순위에 따라 정렬됩니다. company:balance:read 범위가 있는 호출자에 대해 retrieve와 me에서만 계산되며, 그 외에는 null입니다.

속성

string
필수
보유자가 해야 할 작업. 새 값이 추가될 수 있으므로 알 수 없는 작업을 적절히 처리하세요사용 가능한 옵션: deposit_funds, review_held_payments, submit_information_request, update_automatic_withdrawal_method, reauthorize_payout_methods, update_payout_method, update_payout_profile, card_usage_review, verify_identity, scale_account_setup, sign_formation_documents, configure_tax_remitter, add_vat_registration, confirm_tax_details, accept_payout_terms, enable_two_factor_authentication, respond_to_abuse_report
string[]
필수
이 작업이 해결될 때까지 제한되는 기능
string | null
필수
행동 유도 버튼이 연결되는 URL. 버튼이 없는 경우 null
string
필수
버튼 레이블. 버튼이 없는 경우 비어 있음
string
필수
보조 문구. 없으면 비어 있습니다
string | null
필수
작업의 일러스트레이션 아이콘 URL. 없는 경우 null
string
필수
required(지금 조치 필요) 또는 pending(검토 중)사용 가능한 옵션: required, pending
string
필수
작업의 제목
object | null
필수
계정의 반품 정책 문서. 게시하지 않은 경우 null입니다.

속성

string
필수
file_ 접두사가 붙은 파일 ID.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
원본 파일의 MIME 유형(예: application/pdf). 모더레이션으로 파일이 제거되어도 유지됩니다.
string
필수
파일이 생성된 시점(ISO 8601 타임스탬프).
number | null
필수
오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름.
integer | null
필수
이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
integer | null
각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
string | null
complete에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
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입니다.
object[]
이 계정의 활성 추천 링크를 통해 연결된 비즈니스 보상으로, 계정별 진행 상황과 원장 상태를 포함합니다. 조회 응답에 존재하며, 잔액 및 통계 읽기 권한이 모두 없으면 비어 있습니다.

속성

string
필수
prwd_ 접두사가 붙은 보상 정의 ID. 진행 상황과 상태는 해당 계정에 적용됩니다.
object
필수
이 보상을 받는 데 필요한 적격 USD 거래량.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
귀속 이후 이 계정이 보상 활동에 대해 누적한 적격 USD 거래량으로, 이행 규칙을 사용하여 계산됩니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
이 계정이 보상을 받을 자격을 얻는 활동.사용 가능한 옵션: sales, ad_spend
object
필수
이 보상에 대해 적립되는 USD 금액. 이행이 시작되면 저장된 지급 금액을 사용합니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
이 계정의 보상 상태. 적립(Credited)에는 게시된 원장 항목이 필요하며, 처리 중(processing)에는 이행을 기다리는 충족된 요구 사항이 포함됩니다. 취소 중(reversing)과 취소됨(reversed)은 이후의 보상 취소를 반영합니다.사용 가능한 옵션: in_progress, processing, credited, reversing, reversed, unavailable
string
필수
계정 공개 경로 식별자.
boolean
필수
Whop이 이 계정을 대신하여 고객에게 거래 이메일을 보내는지 여부.
object | null
필수
계정의 배송 정책 문서. 게시하지 않은 경우 null입니다.

속성

string
필수
file_ 접두사가 붙은 파일 ID.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
원본 파일의 MIME 유형(예: application/pdf). 모더레이션으로 파일이 제거되어도 유지됩니다.
string
필수
파일이 생성된 시점(ISO 8601 타임스탬프).
number | null
필수
오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름.
integer | null
필수
이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
integer | null
각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
string | null
complete에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
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
필수
계정이 다른 계정의 가입한 whop에 표시되는지 여부.
boolean
필수
소비자 직접 판매 상품 페이지에 리뷰가 표시되는지 여부.
boolean
필수
계정이 사용자 디렉터리에 사용자를 표시하는지 여부.
계정 소셜 링크.

속성

string
필수
소셜 링크의 ID
string | null
필수
소셜 링크의 선택적 표시 제목
string
필수
소셜 링크 URL
string
필수
이 링크의 소셜 플랫폼사용 가능한 옵션: x, instagram, facebook, tiktok, youtube, linkedin, twitch, website, custom
string | null
필수
계정이 Whop에서 운영될 수 있는지 여부: active 또는 suspended. list, retrieve, me, suspend에서 계산되며, 그 외에는 null입니다.
string | null
필수
계정이 정지된 이유로, Suspended - Fraudulent activity와 같은 레이블입니다. 기록된 사유가 없으면 Suspended입니다. retrieve, me, suspend에서 계산됩니다. 그 외에는 null이며, status가 suspended가 아닌 경우에도 null입니다.
object
필수
계정 스토어 페이지 표시 구성.

속성

string | null
필수
계정 스토어 페이지에 사용되는 강조 색상.사용 가능한 옵션: ruby, tomato, red, crimson, pink, plum, purple, violet, iris, cyan, teal, jade, green, grass, brown, blue, orange, indigo, sky, mint, yellow, amber, lime, lemon, magenta, gold, bronze, gray
string | null
필수
계정 스토어 페이지에 사용되는 레이아웃.사용 가능한 옵션: featured, compact
string | null
필수
계정 스토어 페이지에 사용되는 프로필 표시 방식.사용 가능한 옵션: personal, business
계정 스토어 페이지에 Whop 제휴 링크가 표시되는지 여부.
string | null
필수
이 계정의 대상 고객층.
string[]
필수
계정이 세금을 징수하는 미국 주 코드(50개 주와 DC): Whop이 납부하는 경우(tax_remitted_by whop) 전체 세트, 계정이 직접 납부하는 경우(self) 구성된 일부, 둘 다 아닌 경우 비어 있습니다. 업데이트 시 전체 목록을 전송하여 대체하세요(self인 경우에만 허용).
object[]
필수
계정 세금/VAT 등록. 설정된 항목이 없으면 비어 있습니다.

속성

string
필수
세금 식별자 ID.
string
필수
세금 ID 유형.사용 가능한 옵션: ad_nrt, ao_tin, ar_cuit, al_tin, am_tin, aw_tin, au_abn, au_arn, eu_vat, az_tin, bs_tin, bh_vat, bd_bin, bb_tin, by_tin, bj_ifu, bo_tin, ba_tin, br_cnpj, br_cpf, bg_uic, bf_ifu, kh_tin, cm_niu, ca_bn, ca_gst_hst, ca_pst_bc, ca_pst_mb, ca_pst_sk, ca_qst, cv_nif, cl_tin, cn_tin, co_nit, cd_nif, cr_tin, hr_oib, do_rcn, ec_ruc, eg_tin, sv_nit, et_tin, eu_oss_vat, ge_vat, gh_tin, de_stn, gb_vat, gn_nif, hk_br, hu_tin, is_vat, in_gst, id_npwp, il_vat, jp_cn, jp_rn, jp_trn, kz_bin, ke_pin, kg_tin, la_tin, li_uid, li_vat, my_frp, my_itn, my_sst, mr_nif, mx_rfc, md_vat, me_pib, ma_vat, np_pan, nz_gst, ng_tin, mk_vat, no_vat, no_voec, om_vat, pe_ruc, ph_tin, pl_nip, ro_tin, ru_inn, ru_kpp, sa_vat, sn_ninea, rs_pib, sg_gst, sg_uen, si_tin, za_vat, kr_brn, es_cif, ch_uid, ch_vat, tw_vat, tj_tin, tz_vat, th_vat, tr_tin, ug_tin, ua_vat, ae_trn, us_ein, uy_ruc, uz_tin, uz_vat, ve_rif, vn_tin, zm_tin, zw_tin, sr_fin, xi_vat
string
필수
세금 ID 값(예: DE123456789). 세금 ID 가이드를 참조하세요.
string | null
필수
계정의 세금을 계산하고 납부하는 주체. whop은 Whop이 계산하고 납부함을 의미합니다. self는 Whop이 계산하고 계정이 징수 및 납부함을 의미합니다. none은 둘 다 아니며 계정이 책임짐을 의미합니다. 새 비즈니스는 whop으로 시작하고, 새 연결 계정은 none으로 시작합니다. null은 계정에 아직 설정이 없음을 의미합니다.사용 가능한 옵션: whop, self, none
string | null
필수
계정 가격에 세금이 적용되는 방식: inclusive(표시 가격에 세금 포함) 또는 exclusive(세금 별도 추가). 설정되지 않은 경우 기본값은 exclusive이며, 계정에 결제 연결이 없는 경우에만 null입니다.사용 가능한 옵션: inclusive, exclusive
object | null
필수
계정의 서비스 약관 문서. 게시하지 않은 경우 null입니다.

속성

string
필수
file_ 접두사가 붙은 파일 ID.
string | null
필수
이미지 또는 동영상의 BlurHash 플레이스홀더. 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
원본 파일의 MIME 유형(예: application/pdf). 모더레이션으로 파일이 제거되어도 유지됩니다.
string
필수
파일이 생성된 시점(ISO 8601 타임스탬프).
number | null
필수
오디오 또는 동영상 재생 시간(초). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
string | null
필수
확장자를 포함한 원본 파일 이름.
integer | null
필수
이미지 또는 동영상 높이(픽셀). 사용할 수 없거나 모더레이션으로 제거된 경우 Null입니다.
integer | null
각 파트(마지막 제외)가 가져야 하는 바이트 크기. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
string | null
complete에 다시 전달되는 멀티파트 업로드의 ID. 생성 시에만, 그리고 멀티파트 업로드에만 존재합니다.
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입니다.
string | null
필수
지원되는 온세션 카드 결제에 대한 3D Secure 동작. mandate_challenge는 결제 처리 전에 3DS 챌린지를 요구합니다. mandate_if_required는 결제 처리업체가 요구하는 경우에만 챌린지를 의무화합니다. frictionless_if_required는 일반적인 프릭션리스 3DS 흐름을 사용합니다. mandate_challenge가 선택되지 않은 한 $1,000 이상의 결제는 mandate_if_required를 사용합니다. 위험 및 인증 복구 요구 사항이 이 환경설정보다 우선할 수 있습니다. null은 표준 체크아웃 흐름을 사용합니다.사용 가능한 옵션: mandate_challenge, mandate_if_required, frictionless_if_required
string
필수
계정 표시 이름.
number | null
필수
USD로 환산한 계정 누적 판매액. stats:read 범위가 있는 호출자에 대해 retrieve와 me에서만 계산되며, 그 외에는 null입니다.
string | null
필수
환율이 알려진 잔액 전체의 총 USD 가치. 단일 계정 조회(retrieve 및 me)에서만 계산되며, 목록 응답, 쓰기, 잔액 읽기 권한이 없는 경우 또는 잔액 소스를 사용할 수 없는 경우 null입니다.
trading_account | null
필수
트레이딩 계정 주소, 증거금 및 미결제 포지션의 스냅샷, WebSocket 구독. 단일 계정 조회에서 include_trading=true로 활성화하세요. 그 외에는 null이며, 트레이딩 권한이 없거나 Ethereum 지갑이 없는 경우에도 null입니다.

속성

string
필수
이 트레이딩 계정을 지원하는 Whop 지갑 ID로, cwal_ 접두사가 붙습니다.
string | null
필수
이 트레이딩 계정을 소유한 계정으로, biz_ 접두사가 붙습니다. 사용자가 소유한 경우 null입니다.
object | null
필수
Hyperliquid 전용 상태. provider가 hyperliquid인 경우 존재하며, 그 외에는 null입니다.

속성

string
필수
Hyperliquid 계정을 보유한 소문자 지갑 주소.
string | null
필수
deposit 거래로 이 계정에 옮길 수 있는 Plasma 상 Whop 지갑의 USDT0(십진수 문자열). 체인을 읽을 수 없는 경우 null입니다.
object | null
필수
메인 거래소와 xyz 마켓 전반의 계정 가치 및 증거금으로, Hyperliquid에서 최대 초당 한 번 읽어 옵니다. Hyperliquid를 읽을 수 없는 경우 null입니다. 실시간 업데이트에는 websocket_subscriptions를 사용하세요.

속성

object
필수
미실현 손익을 포함한 총 계정 가치(USD).

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
미결제 포지션 전반에 할당된 증거금(USD).

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
미결제 포지션의 합산 명목 가치(USD).

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
포지션을 청산하지 않고 지금 인출할 수 있는 USD.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
trading_position[] | null
필수
메인 거래소와 xyz 마켓 전반의 미결제 무기한 선물 포지션으로, Hyperliquid에서 최대 초당 한 번 읽어 옵니다. Hyperliquid를 읽을 수 없는 경우 null입니다. 실시간 업데이트에는 websocket_subscriptions를 사용하세요.

속성

string
필수
trdpos_ 접두사가 붙은 트레이딩 포지션 ID. 하나의 트레이딩 계정 내에서 마켓별로 고정됩니다.
object | null
필수
평균 진입 가격(USD). 제공자가 생략한 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
Hyperliquid 무기한 선물 세부 정보. Hyperliquid 포지션에 존재하며, 그 외에는 null입니다.

속성

object
필수
여러 기간에 걸쳐 포지션에 지불된 펀딩(USD).

속성

object | null
필수
계정 기록 전체에서 이 마켓에 지불된 펀딩(USD). 사용할 수 없는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
포지션 크기가 마지막으로 변경된 이후 지불된 펀딩(USD). 사용할 수 없는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object | null
필수
포지션이 열린 이후 지불된 펀딩(USD). 사용할 수 없는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
포지션의 증거금 모드와 배수.

속성

string
필수
cross는 포지션 간에 증거금을 공유합니다. isolated는 증거금을 이 포지션으로 제한합니다.사용 가능한 옵션: cross, isolated
integer
필수
포지션 증거금에 적용되는 배수(예: 10배의 경우 10).
object | null
필수
예상 청산 가격(USD). Hyperliquid가 보고하지 않는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
포지션에 할당된 증거금(USD).

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
십진수 비율 문자열로 표현한 자기자본이익률(예: 10%의 경우 0.1).
string
필수
제공자의 마켓 기호(예: ETH).
string
필수
object
필수
현재 포지션 가치(USD).

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
사용 가능한 옵션: long, short
string
필수
십진수 문자열로 표현한 절대 포지션 크기.
object
필수
미실현 손익(USD). 손실인 경우 음수입니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object[]
필수
실시간 계정 업데이트를 위한 구독. websocket_url에 연결한 후 각 message를 변경 없이 전송하세요.

속성

string
필수
이 구독이 여는 실시간 업데이트 스트림.사용 가능한 옵션: clearinghouse_state, open_orders, order_updates, user_fills, user_events
string
필수
Hyperliquid WebSocket을 통해 변경 없이 전송할 JSON 구독 메시지.
string
필수
실시간 업데이트를 위해 직접 연결할 Hyperliquid WebSocket URL.
string
필수
string
필수
포지션과 주문을 보유하는 거래 장소.사용 가능한 옵션: hyperliquid
object | null
필수
진입 가격과 손익이 포함된 Whop 지갑의 현물 보유 자산. 읽을 수 없는 경우 null입니다.

속성

object[]
필수
지갑이 아직 보유하고 있는 각 현물 자산과 평균 진입 가격 및 손익. 취득 원가는 가장 오래된 단위를 먼저 판매한 것으로 계산하며, Whop 외부에서 들어온 자산도 포함합니다.

속성

object | null
필수
아직 보유 중인 단위당 평균 지불 가격(USD)으로, 가장 오래된 단위를 먼저 판매한 것으로 계산합니다. 알 수 없는 경우 null입니다.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
아직 보유 중인 단위에 대해 지불한 USD 금액.

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
string
필수
GET /trades/markets의 현물 마켓 id(예: BTC, XAUT 또는 AAPL과 같은 토큰화된 주식의 티커).
object
필수
매도를 통해 이미 확정된 손익(USD).

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
object
필수
아직 보유 중인 단위의 가치에서 cost_basis를 뺀 값(USD).

속성

string
필수
주 단위 금액으로, 정확한 십진수 문자열입니다. 예를 들어 "10.00"은 10달러입니다. 전송 중 부동 소수점 반올림이 발생하지 않도록 문자열로 제공됩니다.
string
필수
소문자로 된 세 글자 ISO 4217 통화 코드.
integer
필수
금액이 가지는 소수 자릿수. 청구 자체가 실행되는 정밀도입니다.
integer
필수
표시할 소수 자릿수. 보통 decimals와 같지만 의도적으로 항상 같지는 않습니다. COP는 센타보 단위로 청구되지만 페소 단위로 표기되므로 각각 2와 0입니다. 이 값을 사용하여 자체 로캘에 맞게 숫자 형식을 지정하세요.
number | null
필수
cost_basis 대비 unrealized_pnl의 백분율로, 2는 2% 상승을 의미합니다. 알 수 없는 경우 null입니다.
string | null
필수
이 트레이딩 계정을 소유한 사용자로, user_ 접두사가 붙습니다. 계정이 소유한 경우 null입니다.
boolean
필수
계정이 로고를 대체 Open Graph 이미지로 사용하는지 여부.
object
필수
individual(KYC) 및 business(KYB) 프로필에 대한 계정 신원 인증 상태. 각각 생성될 때까지 null이며, 그 외에는 not_started, pending, manual_review, approved 또는 rejected 중 하나의 status입니다.
number | null
필수
지난 30일 동안 계정을 통한 거래량(결제 완료 영수증 기준 GMV)으로, USD로 환산됩니다. 계정에 대해 stats:read 권한이 있는 호출자에 대해 list에서만 계산되며, 그 외에는 null입니다.
number | null
필수
계정을 통한 누적 거래량 — 판매액과 받은 이체액의 합 — 으로, USD로 환산됩니다. 계정에 대해 stats:read 권한이 있는 호출자에 대해 list에서만 계산되며, 그 외에는 null입니다.
object | null
필수
계정의 기본 암호화폐 지갑. 프로비저닝된 지갑이 없으면 null입니다.

속성

string
필수
wallet_ 접두사가 붙은 지갑 ID.
string
필수
지갑의 온체인 주소
string
필수
지갑이 존재하는 블록체인 네트워크사용 가능한 옵션: solana, ethereum, bitcoin
string | null
필수
계정의 비즈니스 웹사이트 URL. 제공되지 않은 경우 null입니다. 설정하면 social_links에 website 항목도 추가됩니다.
string | null
계정이 Whop Partner 모드를 켠 시점(ISO 8601 타임스탬프). 단일 계정 조회 및 업데이트 응답에 존재하며, 업데이트 시 whop_partner_enabled: true를 전송하여 계정이 Whop Partner 모드를 켤 때까지 null입니다.
Account

비즈니스 유형 및 업종

세 가지 필드가 계정을 분류합니다: business_type, industry_group, industry_type. 전체 분류 체계는 별도 페이지에 있습니다:

비즈니스 유형 및 업종