만들 수 있는 것
- 자신의 링크를 자신의 오디언스와 공유하는 직접 운영하는 추천 프로그램.
- 추천한 대상에 대한 보고: 어떤 비즈니스와 사용자가 여전히 활성 상태인지, 각각이 무엇을 창출하는지.
- 모든 항목의 기반이 되는 거래와 요율까지 세분화된 수익 명세서.
- 파트너 리더보드를 활용한 공개 순위 페이지.
핵심 객체
파트너, 추천된 비즈니스, 파트너 수익. 각 객체는 핵심 개념에 정의되어 있습니다.등록
POST /partners는 호출한 사용자를 등록하고 해당 파트너 비즈니스가 수익을 받을 수 있도록 합니다. 크레딧을 받기 위해 공유하는 URL인 referral_link와 whop_partner_enabled_at을 반환합니다. 다시 등록해도 원래 등록 시간이 초기화되지 않고 유지되므로, 이 호출은 안전하게 반복할 수 있습니다.
partner:create 권한이 필요합니다. 추천 및 수익을 읽으려면 partner:basic:read가 필요하며, 추천된 비즈니스 목록 조회에는 referral:basic:read도 허용됩니다. 권한을 참고하세요.
수익 발생 대상
추천된 비즈니스의payout_percentages는 수입원별 요율을 소수로 나타내므로 0.3은 30%를 의미합니다. 네 가지 중 세 가지는 Whop 매출총이익의 일정 비율입니다. 광고 지출은 예외로, 지출 자체의 일정 비율입니다.
파트너 비즈니스를 위해 성사된 비즈니스의 경우 해당 요율은 팀에 귀속됩니다.
GET /partners/businesses/:id는 각 요율에서 본인의 몫인 my_payout_percentages도 반환합니다. 직접 비즈니스를 추천한 경우에는 전체 요율입니다. 파트너 비즈니스의 거래에서는 요율 중 본인 팀의 몫입니다. 매니저는 자신의 몫에서 하위 담당자의 몫을 뺀 금액을 받고, 거래 참여자는 자신의 몫을 받습니다. 해당 비즈니스에서 수익이 없으면 null입니다.
GET /partners/businesses는 추천한 모든 항목을 최신순으로 나열합니다. 각 파트너 비즈니스에는 coma_ ID, active 또는 removed인 status, 그리고 referral_started_at과 referral_expires_at이 포함됩니다.
earnings_usd와 volume_usd는 단일 숫자가 아니라 객체입니다. earnings_usd는 completed, pending, total로 나뉩니다. volume_usd는 attributed, awaiting_settlement, settled로 나뉩니다.
수익 조회
GET /partners/businesses/{id}/earnings는 하나의 비즈니스에 대해 Whop이 지급하는 금액을 항목별로 나열합니다. 각 수익에는 income_source, 수익의 출처인 transaction_amount_usd, 그리고 payout_percentage가 표시됩니다.
수익은 지급되기 전에 정산됩니다. 정산되기 전까지 commission_amount_usd와 payout_percentage는 모두 null입니다.
데이터가 있는 경우
financial_activity는 수수료의 기반이 되는 수입 및 비용 항목을 세분화합니다. Whop이 해당 세부 정보를 기록하기 전에 정산된 수익의 경우 null입니다.
리더보드
GET /partners/leaderboard는 파트너 수익을 기준으로 추천인의 순위를 매깁니다. period 매개변수는 day, month, year, last_30_days 또는 all_time을 받으며 기본값은 all_time입니다.
인증은 선택 사항입니다. 익명 호출자는 leaders에서 순위를 받고, 인증된 호출자는 me에서 자신의 순위도 받습니다. 아직 추천 수익이 없으면 me는 null입니다.
다음 단계
파트너로 등록
한 번의 호출로 가입하고 추천 링크를 받으세요.
추천 목록 조회
유치한 모든 비즈니스와 수익.
제휴사
자체 상품 내 추천 추적.
Partners 레퍼런스
플레이그라운드가 포함된 모든 파트너 엔드포인트.

