Skip to main content
하위 계정을 위한 결제를 수금하는 방법은 두 가지입니다:
  1. 직접 청구: 하위 계정에 대한 체크아웃을 생성하고 애플리케이션 수수료를 수금합니다.
  2. 이체: 플랫폼 계정으로 결제를 수금하고 나중에 하위 계정으로 자금을 이체합니다.

직접 청구

하위 계정의 ID로 체크아웃 구성을 생성하여 하위 계정에서 직접 고객에게 청구하세요. 하위 계정이 Whop 수수료, 환불, 분쟁을 책임집니다.

작동 방식

  1. application_fee_amount를 포함하여 하위 계정에 대한 체크아웃 구성을 생성합니다
  2. 고객이 구매하면 Whop이 하위 계정에서 직접 청구를 생성합니다
  3. 플랫폼이 애플리케이션 수수료를 수금하고, 나머지 금액은 하위 계정으로 갑니다
  4. 하위 계정이 해당 거래의 분쟁이나 환불을 처리합니다

예시

plan이라는 호환성 입력을 사용해 인라인 변형을 생성하세요.
이 예시에서:
  • account_id는 Whop이 청구를 생성할 하위 계정의 ID입니다
  • variant.initial_price는 변형의 총 결제 금액입니다(10.00 미국 달러)
  • variant.application_fee_amount는 플랫폼이 수금하는 수수료입니다(1.23 미국 달러)
  • 하위 계정은 8.77 미국 달러(10.00 - 1.23)를 받습니다

제한 사항

  • application_fee_amount는 양수여야 하며 총 결제 금액보다 작아야 합니다
  • 애플리케이션 수수료는 캡처된 결제 금액을 초과할 수 없습니다

이체

플랫폼이 먼저 결제를 수금하거나, 백엔드에서 각 하위 계정에 얼마를 언제 지급할지 결정하는 경우 이체를 사용하세요.

이체하기 전에

  • 출발 계정: 자금을 보내는 계정은 고객 확인(KYC) 인증을 완료해야 하며 이체에 충분한 잔액이 있어야 합니다. 대시보드에서 또는 잔액에 자금 추가를 통해 잔액을 충전할 수 있습니다.
  • 도착 계정: 수신자는 이미 Whop 계정이 있어야 합니다. 없다면 먼저 하위 계정 등록으로 온보딩하세요.
  • 정산 책임: 이체를 사용하면 플랫폼이 원래 결제의 판매 주체(merchant of record)가 됩니다. 플랫폼이 해당 결제의 수수료, 분쟁, 환불을 처리합니다.

예시

플랫폼 계정으로 결제를 수금한 다음, 하위 계정의 몫을 이체하세요:
이 예시에서:
  • origin_id는 플랫폼의 계정 ID입니다(Whop이 자금을 차감하는 곳)
  • destination_id는 하위 계정의 ID입니다(Whop이 자금을 입금하는 곳)
  • amount는 이체할 금액입니다
  • metadata는 참조용 사용자 지정 데이터를 저장합니다

이체 실패 처리

출발 계정이 인증되지 않았거나, 출발 계정의 잔액이 너무 적거나, 도착 계정이 아직 자금을 받을 수 없는 경우 이체가 실패합니다. 재시도하기 전에 근본 원인을 해결하세요. 원인을 검토하지 않고 실패한 이체를 재시도하지 마세요.

일반적인 용도

  • 예약된 크리에이터 지급
  • 제휴사 지급
  • 주문 정산 후 마켓플레이스 분배

결제 흐름 선택

백엔드가 지급 시점과 금액을 제어하는 경우 이체를 사용하세요. 하위 계정이 원래 구매의 수수료, 분쟁, 환불을 책임져야 하는 경우 직접 청구를 사용하세요.

API 레퍼런스

Create Checkout Configuration

애플리케이션 수수료가 포함된 체크아웃 구성 생성

Create Transfer

계정 간 자금 이체

결제 받기

체크아웃 링크와 Checkout 엘리먼트에 대해 알아보기

하위 계정 등록

수신자 계정을 생성하고 지급 전에 온보딩 완료하기