Skip to main content
Asegúrate de que los pagos salientes solo lleguen a una cuenta de PayPal que sea propiedad del titular. El titular inicia sesión en PayPal en lugar de escribir un correo electrónico, y Whop guarda el correo electrónico de PayPal una vez que su nombre coincide con su configuración de pagos salientes.
Antes de empezar, necesitas:
  • Una clave de API con los alcances payout:destination:read y payout:create_destination.
  • El inicio de sesión con PayPal habilitado en la cuenta. Ponte en contacto con Whop para activarlo. Hasta entonces, supports_paypal_login es false y el paso 2 devuelve 403.
  • Una configuración de pagos salientes completada. Whop compara el nombre que figura en ella con la cuenta de PayPal.
  • Una página https a la que PayPal pueda devolver al titular, en un dominio añadido a la cuenta o a su plataforma. Añádelo con Create Domain y verification: {}. No es necesario que termine de verificarse. https://localhost funciona 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.
  1. Tu servidor inicia una sesión y obtiene una authorize_url en PayPal.
  2. El navegador del titular va allí, y el titular inicia sesión y aprueba.
  3. PayPal devuelve el navegador a Whop, que lee el correo electrónico, el nombre y el estado de verificación de la cuenta.
  4. Whop envía el navegador a tu return_url con ?paypal_link_token=… o ?error=….
  5. Tu servidor pasa el token a Whop, que comprueba el nombre y guarda el método.

  1. 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.

  1. 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.
El navegador vuelve a tu 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”.

  1. 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.
La respuesta es el nuevo método de pago saliente, abreviado:
Ya puedes enviarle un pago saliente.

Si Whop rechaza la cuenta

Whop responde con un 400 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