Skip to main content
제휴사는 추천한 판매에 대해 커미션을 받습니다. API 흐름은 두 부분으로 구성됩니다. 제휴사 레코드를 생성한 다음, 커미션을 정의하는 오버라이드를 추가합니다.

기여도 산정 방식

  1. 사용자에 대한 제휴사 레코드를 생성한 다음 오버라이드를 추가합니다. 각 오버라이드는 product_direct_link 및 checkout_direct_link 필드를 반환합니다. 이는 제휴사가 공유하는 추천 URL입니다(?a=<username>이 포함됨).
  2. 구매자가 링크를 사용합니다. Whop은 제휴사 쿠키를 저장합니다(기본 기여 기간은 30일).
  3. 구매자가 기간 내에 결제합니다. 일치하는 오버라이드가 커미션을 계산합니다: standard(변형별, 비율 또는 고정 수수료) 또는 rev_share(수익 비율, 상품별 또는 계정 전체).
  4. Whop은 커미션을 제휴사에 귀속시키고 오버라이드의 total_referral_earnings_usd 필드에 반영합니다.
환불 시 커미션이 취소됩니다. 구매자가 기간 내에 환불하면 해당 판매에 대한 제휴사의 수익이 자동으로 회수됩니다.
제휴사가 지급을 받으려면 Whop 계정이 필요합니다. 수익은 레코드에 누적됩니다. 지급은 이체를 통해 제휴사의 계정 잔액으로 이루어집니다. 아직 계정이 없다면 하위 계정 등록으로 온보딩하세요.

제휴사 생성하기

user_identifier는 유연하게 확인됩니다. 사용자 이름, 이메일, 사용자 ID 또는 Discord ID를 전달하세요. 해당 계정과 사용자 쌍에 대한 제휴사 레코드가 이미 있으면 Whop은 기존 레코드를 반환합니다(멱등성).

커미션 오버라이드 추가하기

제휴사 레코드 자체는 커미션을 정의하지 않습니다. 오버라이드를 추가하여 제휴사가 받을 금액을 결정하세요.

표준(변형별)

commission_value 규칙:
  • "percentage": 1–100 사이의 정수(40 = 40%).
  • "flat_fee": 달러 금액(10 = $10).
applies_to_payments:
  • "first_payment": 제휴사는 최초 구매에 대해서만 수익을 받습니다.
  • "all_payments": 제휴사는 모든 반복 결제에 대해서도 수익을 받습니다.

수익 공유(수익 비율)

수익 공유 오버라이드는 항상 비율 기반입니다. commission_type: "flat_fee"를 전달하지 마세요.

오버라이드 관리하기

제휴사 관리하기

계정 수준 제휴사 설정

세 가지 계정 필드가 Whop이 사용자에게 제휴 프로그램을 표시하는 방식을 제어합니다. Account 리소스를 통해 업데이트하세요.

수익 추적하기

각 오버라이드에는 해당 오버라이드의 누적 수익(미국 달러 기준)을 반영하는 total_referral_earnings_usd 필드가 포함됩니다. 현재 합계를 확인하려면 오버라이드를 다시 가져오거나 제휴사의 오버라이드 목록을 조회하세요.
v1에는 전용 affiliate.* 웹훅이 없으며, 공개 payment 스키마는 제휴사 연결 정보를 노출하지 않습니다. 지급 일정에 맞춰 affiliates.overrides.list를 폴링하고 최신 total_referral_earnings_usd 값을 마지막으로 저장한 값과 비교하세요.

오버라이드 응답 필드

다음 단계

제휴사 수익 지급하기

누적된 커미션을 잔액에서 제휴사 계정으로 이체합니다.

결제 받기

추천 쿠키가 설정되어 있으면 체크아웃 구성이 판매를 자동으로 귀속시킵니다.

웹훅 수신하기

일반 판매 원격 측정에는 payment.succeeded를 사용하세요. 제휴사 기여도는 여전히 폴링으로 확인합니다.

Affiliates API 레퍼런스

전체 리소스입니다. 엔드포인트, 필드, 오버라이드 스키마를 다룹니다.