시작하기 전에 다음이 필요합니다:
payout:destination:read및payout:create_destination범위가 있는 API 키.- 계정에서 PayPal 로그인 활성화. 활성화하려면 Whop에 문의하세요. 그 전까지는
supports_paypal_login이false이며 2단계에서403이 반환됩니다. - 완료된 지급 설정. Whop은 지급 설정의 이름을 PayPal 계정과 대조합니다.
- 계정 또는 그 플랫폼에 추가된 도메인에 있는, PayPal이 소유자를 돌려보낼
https페이지. Create Domain과verification: {}으로 추가하세요. 인증이 완료될 필요는 없습니다. 테스트에는https://localhost를 사용할 수 있습니다. - SDK를 사용하는 경우 Whop SDK 2.5.0 이상.
리디렉션 작동 방식
모든 과정은 소유자의 브라우저에서 하나의 탭 안에서 이루어집니다. PayPal을 직접 호출할 필요는 없습니다.- 서버가 세션을 시작하고 PayPal의
authorize_url을 받습니다. - 소유자의 브라우저가 그곳으로 이동하고, 소유자가 로그인해 승인합니다.
- PayPal이 브라우저를 Whop으로 돌려보내고, Whop은 계정의 이메일, 이름, 인증 상태를 읽습니다.
- Whop이
?paypal_link_token=…또는?error=…와 함께 브라우저를return_url로 보냅니다. - 서버가 토큰을 Whop에 전달하면 Whop이 이름을 확인하고 수단을 저장합니다.
- 지급 수단 찾기
지원되는 지급 수단을 나열하고 supports_paypal_login: true인 항목의 id를 보관하세요. SDK가 모든 결과의 페이지를 자동으로 넘깁니다.
- 로그인 시작하기
PayPal 연결 세션을 생성하고 소유자를 해당 authorize_url로 리디렉션하세요. 세션은 15분 후 expires_at에 만료됩니다.
return_url로 돌아옵니다:
소유자가
expires_at 이후에 완료하거나, return_url 도메인이 계정에서 제거된 후에 완료하면 Whop은 소유자를 돌려보낼 수 없습니다. 소유자에게는 “Invalid or expired link” 페이지가 표시됩니다.
- 지급 수단 저장하기
서버에서 fields 대신 paypal_link_token을 사용해 저장된 지급 수단을 생성하세요. 토큰은 세션과 같은 값에서만 작동하므로 세션과 동일한 account_id, supported_payout_method_id, destination_currency를 사용하세요. Whop은 PayPal의 이메일을 저장하고 이를 따라 수단의 이름을 지정합니다.
Whop이 계정을 거부하는 경우
Whop은 이름 불일치 같은 소유자용message와 함께 400으로 응답합니다. 그대로 표시하세요.
- 토큰은 거부 후에도 유효하므로 일시적인 오류는 같은 토큰으로 재시도하세요.
- 메시지가 PayPal을 다시 연결하라고 안내하면 소유자가 문제를 해결한 후 새 세션을 시작하세요.
- 인증되지 않은 PayPal 계정이나 확인되지 않은 이메일도 저장됩니다.
소유자에게 표시되는 화면
PayPal의 동의 화면에는 소유자의 이메일, 이름, 인증 상태를 요청하는 앱으로 Whop이 표시됩니다. 모든 리디렉션은 PayPal을 연 탭 안에서 이루어지므로, 팝업을 사용한다면 반환 페이지가 팝업을 연 창에 알리고 닫혀야 합니다.다음 단계
지급 보내기
방금 저장한 PayPal 수단으로 지급합니다
Payouts API 레퍼런스
모든 지급 및 지급 수단 엔드포인트

