Skip to main content
이 가이드는 Whop Rails를 사용해 Mercor Clone 데모의 핵심을 재현하는 방법을 보여줍니다. 주요 페이지를 만들고, Checkout 요소로 결제를 연결하고, 하위 계정에 대규모로 지급합니다. 예제 저장소를 보려면 Mercor clone 저장소를 방문하세요. 또는 아래 튜토리얼을 따라 시작하세요:
환경 변수 설정
의존성 설치
서버 라우트용 Whop 클라이언트를 하나 만드세요. SDK는 모든 요청에 자신이 생성된 기준 API 버전을 전송합니다.

  1. 프로젝트 구조와 페이지

마켓플레이스 흐름을 반영하는 App Router 구조(Next.js)를 만드세요. 자금 충전과 작업 관리를 위한 리크루터 페이지, 지급과 제출을 위한 수익자 페이지, 그리고 필요하면 관리자 화면을 추가하세요. 폴더 구조
최소한의 리크루터 잔액 페이지 예시
최소한의 수익자 지급 페이지 예시

  1. Checkout 요소를 사용한 결제 흐름

서버: 인라인 일회성 변형과 결제를 리크루터 계정에 다시 연결하기 위한 자체 메타데이터로 Whop 체크아웃 구성을 만드세요.
클라이언트: “Add Funds” 모달을 열고 @whop/elements-react로 Whop Elements 체크아웃을 마운트하세요.
완료된 체크아웃은 탭을 returnUrl로 리디렉션하므로 모달에는 완료 콜백이 필요하지 않습니다. 아래 웹훅에서 리크루터의 잔액을 충전하고 returnUrl이 가리키는 페이지에 표시하세요. 웹훅: 서명을 확인하고, Whop 결제 이벤트를 수신하고, payment.succeeded에서 리크루터 잔액을 충전하세요. 웹훅을 생성할 때 api_version_date를 고정하여 data가 현재 Payment 객체가 되도록 하세요. 이 객체에서 total은 십진수 문자열 amount를 가진 금액 객체입니다.

  1. 하위 계정 지급(계정 설정 + 지급 포털)

플랫폼 계정 아래에 Whop 하위 계정(수익자 계정)을 만드세요. 사용자 ID를 external_id로 전달하면 생성을 재시도해도 동일한 하위 계정이 반환됩니다. 반환된 ID를 whopId로 저장하여 이체를 라우팅하세요. 나중에 사용자 ID로 계정을 찾으려면 whop.accounts.list({ external_id })를 호출하세요.
Whop Elements로 지급 포털 임베드하기 서버에서 수익자 계정용 액세스 토큰을 발급한 다음(하위 계정 지급 활성화 참고), 이 토큰으로 지갑 화면을 마운트하세요:
작업 완료: 수익자의 whopAccountId와 제출별 멱등성 키를 사용해 플랫폼에서 수익자 하위 계정으로 자금을 이체하세요.
이것이 Mercor 스타일 마켓플레이스의 핵심입니다. 리크루터는 결제를 통해 잔액을 충전하고, 수익자는 지급 계정(하위 계정)을 설정하며, 완료된 작업은 플랫폼 수수료를 뺀 금액을 수익자에게 이체합니다. 참고 저장소: Mercor clone