Skip to main content
추천이 유지되는 동안 네 가지 개별 수입원에서 수익을 얻습니다. 한 번의 호출로 등록되고 링크가 반환됩니다. 나머지는 모두 추천한 대상과 얻은 수익을 보고합니다.

만들 수 있는 것

  • 자신의 링크를 자신의 오디언스와 공유하는 직접 운영하는 추천 프로그램.
  • 추천한 대상에 대한 보고: 어떤 비즈니스와 사용자가 여전히 활성 상태인지, 각각이 무엇을 창출하는지.
  • 모든 항목의 기반이 되는 거래와 요율까지 세분화된 수익 명세서.
  • 파트너 리더보드를 활용한 공개 순위 페이지.

핵심 객체

파트너, 추천된 비즈니스, 파트너 수익. 각 객체는 핵심 개념에 정의되어 있습니다.

등록

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 레퍼런스

플레이그라운드가 포함된 모든 파트너 엔드포인트.