이 페이지는
@whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.Whop Elements는 자체 사이트에 삽입하는 호스팅형 테마 지원 UI 컴포넌트입니다. 각 엘리먼트는 Whop의 CDN에서 제공되는 격리된 프레임에서 렌더링됩니다. 가볍고 완전한 타입을 갖춘 패키지를 설치하면 엘리먼트 코드는 자동으로 최신 상태를 유지합니다.
설치
요구 사항
Content security policy
@whop/elements의 contentSecurityPolicy()는 전달한 환경에 대해 이 표의 모든 소스를 반환합니다. 페이지 측 작업에 대한 행은 프레임이 아닌 사용자의 페이지에서 실행됩니다. Apple Pay, Google Pay, PayPal 및 Plaid 은행 계좌 연결을 위해 엘리먼트가 로드하는 스크립트는 다른 회사에서 제공하며 이 행 외의 리소스를 로드할 수 있습니다. 각 제공업체의 Content Security Policy 가이드도 확인하세요.모달 엘리먼트는 인라인 스타일로 뒤의 페이지를 어둡게 처리합니다. 인라인 스타일을 허용하지 않는
style-src에서는 페이지가 어두워지지 않지만 모달은 계속 작동합니다.시작하기 전에
두 가지가 필요합니다:accountId.biz_접두사가 붙은 계정 ID, 또는 사용자 자신의 데이터에 대해서는user_접두사가 붙은 사용자 ID입니다. 결제 화면은 대신 플랜이나 금액을 받으며, 각 엘리먼트 페이지에 필요한 항목이 안내되어 있습니다.- 마운트하는 엘리먼트로 범위가 지정된 액세스 토큰을 생성하는 서버 엔드포인트.
첫 번째 엘리먼트 마운트하기
스크립트 태그 대신 npm을 사용하고 싶으신가요? 토큰은 SDK가 호출하는 콜백이 아니라 직접 설정하는 값입니다. 만료되기 전에 새 토큰을 설정하세요:React에서는 같은 객체를
loadWhop()은 같은 호스팅 스크립트를 삽입하고 전역 생성자를 resolve합니다:인증
핸들을 생성할 때accessToken을 전달합니다. 엘리먼트마다 토큰을 하나씩 사용하지 말고 핸들 전체에 토큰 하나를 사용하세요. 핸들은 그 아래의 모든 엘리먼트에 해당 토큰을 전송하므로, 필요한 모든 스코프를 하나의 토큰에 요청하세요. 각 엘리먼트 페이지에 해당 엘리먼트가 읽는 스코프가 나열되어 있습니다.accessToken을 생략하면 요청에 대신 사용자의 세션 쿠키가 사용됩니다. 이는 whop.com에서만 작동합니다. API는 교차 출처 프리플라이트에 Access-Control-Allow-Credentials를 보내지 않으므로, 자체 도메인의 페이지에는 대체할 세션이 없어 토큰을 전달해야 합니다.전역 구성
생성 시 전달하는 모든 항목은 해당 인스턴스에서 생성된 모든 엘리먼트 그룹에 적용됩니다(핸들 자체의 옵션으로 그룹별로 재정의할 수 있습니다):모든 엘리먼트의 시각적 사용자 지정입니다.
theme(라이트/다크 + 팔레트), variables(CSS 사용자 지정 속성), classes(파트별 스타일 선언)를 포함합니다. 색 구성표는 엘리먼트가 처음 그려지기 전에 적용되므로 어두운 페이지가 밝게 깜박이지 않습니다. Appearance를 참고하세요.엘리먼트 UI 텍스트의 로케일입니다. 앱에 빌드된 로케일 중 하나여야 하며, 그 외의 값은 기본 로케일로 대체됩니다. 기본값은
"en"입니다."en", "es", "zh", "nl", "pt", "de", "hu", "it", "fr", "ja", "pl", "tr" 중 하나입니다.엘리먼트가 통신하는 Whop API 환경입니다.
"sandbox"는 샌드박스 API를 대상으로 합니다(테스트 데이터, 실제 돈은 이동하지 않음). 환경을 선택하는 것이 구매자가 입력한 내용을 엘리먼트가 보내는 위치를 변경하는 유일한 방법이며, 두 환경 모두 Whop 자체 환경입니다. 샌드박스 환경은 아직 정식 출시되지 않았습니다. 기본값은 "production"입니다.엘리먼트가 페이지에 토스트 알림을 표시할 수 있는지 여부입니다. 토스트 알림은 오른쪽 하단에 렌더링되는 짧은 상태 메시지(“Payment method added”, “Payment failed”)입니다. 완전히 끄려면
false로 설정하세요. 기본값은 true입니다.Whop 픽셀을 건너뜁니다. 기본적으로 엘리먼트는 아직 Whop 광고 픽셀이 실행되지 않는 페이지에 픽셀을 로드하며, 엘리먼트가 작동하는 계정(엘리먼트 그룹의
accountId 또는 체크아웃 플랜의 판매자)으로 범위를 지정합니다. 또한 엘리먼트 분석을 픽셀의 방문자 ID와 연결합니다. 이는 Whop의 ID 그래프에서 엘리먼트 활동을 광고 어트리뷰션 데이터와 결합할 수 있게 하는 일회성 ID 연결입니다. 둘 다 하지 않으려면 true로 설정하세요. 사용 분석 자체에는 영향을 주지 않습니다(핸들별로 analytics: false로 끌 수 있습니다). 기본값은 false입니다.<WhopElements appearance={…} locale={…}>로 전달합니다.toasts 전역 설정은 이 페이지에서 실제로 작동합니다. 아래 버튼은 엘리먼트가 사용하는 것과 같은 경로로 토스트를 보내며, 이 페이지의 appearance로 테마가 적용됩니다:엘리먼트가 처리하는 것과 직접 담당하는 것
각 엘리먼트는 자체 데이터를 가져오고 자체 로딩, 빈 상태, 오류 상태를 렌더링합니다.탐색과 저장은 직접 처리합니다. 엘리먼트는 선택과 결과를 이벤트로 보고하며, 데이터베이스에 절대 기록하지 않습니다.예외는 페이지를 벗어나는 흐름입니다. 엘리먼트가returnUrl을 받는 경우 탭을 해당 위치로 이동시키므로 구매자가 페이지를 벗어날 수 있습니다. 구매자는 외부 단계가 성공한 후뿐만 아니라 실패하거나 중단된 후에도 그곳에 도착하며, URL에는 status(succeeded, failed, canceled)와 시도 ID가 추가됩니다. 따라서 returnUrl 페이지는 성공 메시지를 표시하기 전에 status를 읽어야 합니다. 주문 이행은 브라우저 콜백이 아니라 웹훅에서 처리하세요.엘리먼트는 프레임에서 실행되므로 직렬화 가능한 값만 경계를 넘을 수 있습니다. 공유 DOM이 없으며 객체 동일성은 유지되지 않습니다.문제 해결
사용 가능한 엘리먼트
Payments
plan_ ID 또는 인라인 통화와 금액으로 결제를 수금하거나, mode: "setup"으로 청구 없이 결제 수단을 저장합니다.Verifications
계정의 신원 정보를 수집하고 인증합니다.
Checkout
Whop 체크아웃 세션 API를 기반으로 하나 이상의 플랜에 대한 전체 호스팅 체크아웃을 구동합니다. 항목별 가격 요약, 프로모션 코드, 구매자가 결제하는 통화, 그리고 전체 결제 수집 화면(내부에 구성된 결제 엘리먼트)을 포함합니다.
Ads
광고 계정입니다.
Tracking
계정의 추적 대상 오디언스입니다. 픽셀이 확인한 모든 사람과 그들이 수행한 모든 이벤트를 포함합니다.
Wallet
계정의 자금 관련 화면을 구동합니다.
Websites
계정의 웹사이트입니다. whop.site에 구축된 모든 사이트와 Whop 픽셀이 보고하는 모든 도메인을 도메인별 트래픽 및 귀속 수익과 함께 표시합니다.
Dashboard
사이트에 삽입된 계정 자체의 대시보드 화면입니다.
Delivery
비즈니스를 위한 고객 배송 추적입니다.
Chat
채널 목록과 메시지 검색을 갖춘 실시간 채팅입니다.
다음 단계
- Appearance: 테마, CSS 변수, 파트별 스타일 재지정
- Create Access Token: 서버가 토큰을 발급하는 엔드포인트

