Antes de empezar, necesitas:
- Una clave de API con los alcances
payout:destination:readypayout:create_destination. - El inicio de sesión con PayPal habilitado en la cuenta. Ponte en contacto con Whop para activarlo. Hasta entonces,
supports_paypal_loginesfalsey el paso 2 devuelve403. - Una configuración de pagos salientes completada. Whop compara el nombre que figura en ella con la cuenta de PayPal.
- Una página
httpsa la que PayPal pueda devolver al titular, en un dominio añadido a la cuenta o a su plataforma. Añádelo con Create Domain yverification: {}. No es necesario que termine de verificarse.https://localhostfunciona para pruebas. - Whop SDK 2.5.0 o posterior, si usas un SDK.
Cómo funciona la redirección
Todo ocurre en el navegador del titular, en una sola pestaña. Nunca llamas a PayPal directamente.- Tu servidor inicia una sesión y obtiene una
authorize_urlen PayPal. - El navegador del titular va allí, y el titular inicia sesión y aprueba.
- PayPal devuelve el navegador a Whop, que lee el correo electrónico, el nombre y el estado de verificación de la cuenta.
- Whop envía el navegador a tu
return_urlcon?paypal_link_token=…o?error=…. - Tu servidor pasa el token a Whop, que comprueba el nombre y guarda el método.
- Encuentra el método de pago saliente
Lista los métodos de pago saliente admitidos y guarda el id del que tenga supports_paypal_login: true. Los SDK recorren todas las páginas de resultados por ti.
- Inicia el inicio de sesión
Crea una sesión de vinculación de PayPal y redirige al titular a su authorize_url. La sesión caduca en 15 minutos, en expires_at.
return_url con uno de estos:
Si el titular termina después de
expires_at, o después de que el dominio de return_url se elimine de la cuenta, Whop no puede devolverlo. Verá una página de “Invalid or expired link”.
- Guarda el método de pago saliente
En tu servidor, crea el método de pago saliente guardado con paypal_link_token en lugar de fields. Usa los mismos account_id, supported_payout_method_id y destination_currency que en la sesión, ya que el token solo funciona con ellos. Whop guarda el correo electrónico de PayPal y le da al método un nombre basado en él.
Si Whop rechaza la cuenta
Whop responde con un400 con un message para el titular, como una discrepancia en el nombre. Muéstralo tal cual.
- El token sobrevive a un rechazo, así que reintenta un error temporal con el mismo token.
- Si el mensaje indica que se vuelva a conectar PayPal, inicia una sesión nueva cuando el titular haya resuelto el problema.
- Una cuenta de PayPal no verificada o un correo electrónico no confirmado se guardan igualmente.
Lo que ve el titular
La pantalla de consentimiento de PayPal muestra a Whop como la app que solicita su correo electrónico, su nombre y su estado de verificación. Todas las redirecciones se mantienen en la pestaña que abrió PayPal, así que si usas una ventana emergente, tu página de retorno debe notificar a la ventana que la abrió y cerrarse.Próximos pasos
Enviar un pago saliente
Paga al método de PayPal que acabas de guardar
Referencia de la API de pagos salientes
Todos los endpoints de pagos salientes y métodos de pago saliente

