Skip to main content
지급이 소유자 본인의 PayPal 계정으로만 전달되도록 하세요. 소유자는 이메일을 입력하는 대신 PayPal에 로그인하며, Whop은 PayPal 계정의 이름이 지급 설정과 일치하면 PayPal의 이메일을 저장합니다.
시작하기 전에 다음이 필요합니다:
  • 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을 직접 호출할 필요는 없습니다.
  1. 서버가 세션을 시작하고 PayPal의 authorize_url을 받습니다.
  2. 소유자의 브라우저가 그곳으로 이동하고, 소유자가 로그인해 승인합니다.
  3. PayPal이 브라우저를 Whop으로 돌려보내고, Whop은 계정의 이메일, 이름, 인증 상태를 읽습니다.
  4. Whop이 ?paypal_link_token=… 또는 ?error=…와 함께 브라우저를 return_url로 보냅니다.
  5. 서버가 토큰을 Whop에 전달하면 Whop이 이름을 확인하고 수단을 저장합니다.

  1. 지급 수단 찾기

지원되는 지급 수단을 나열하고 supports_paypal_login: true인 항목의 id를 보관하세요. SDK가 모든 결과의 페이지를 자동으로 넘깁니다.

  1. 로그인 시작하기

PayPal 연결 세션을 생성하고 소유자를 해당 authorize_url로 리디렉션하세요. 세션은 15분 후 expires_at에 만료됩니다.
브라우저는 다음 중 하나와 함께 return_url로 돌아옵니다: 소유자가 expires_at 이후에 완료하거나, return_url 도메인이 계정에서 제거된 후에 완료하면 Whop은 소유자를 돌려보낼 수 없습니다. 소유자에게는 “Invalid or expired link” 페이지가 표시됩니다.

  1. 지급 수단 저장하기

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

모든 지급 및 지급 수단 엔드포인트