Saltearse al contenido
Nappai Documentation

PayPal Payout

PayPal Payout envía dinero desde tu cuenta de PayPal a la cuenta de PayPal de otra persona, usando su correo electrónico. También consulta el estado de un envío que ya has hecho. PayPal llama a cada envío payout y lo agrupa en un lote; cada lote que crea este componente lleva un único destinatario.

Cuándo usarlo

  • Pagas comisiones a tus afiliados o colaboradores y quieres enviarles su importe al aprobarlo.
  • Devuelves una fianza o un reembolso a alguien que tiene cuenta de PayPal.
  • Quieres comprobar si un pago enviado ya ha llegado a su destinatario.

Configuración

Necesitas una credencial PayPal API con el Client ID y el Client Secret de tu aplicación de PayPal, y el entorno: Sandbox para pruebas o Live para envíos reales. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial PayPal API de tu cuenta.
Operation (obligatorio)La acción que realiza el componente: Create o Get. Por defecto, Create. Consulta Operaciones.
Payout Batch IDSolo en Get, y obligatorio en ella. El identificador del lote que PayPal devolvió al crear el envío.
Sender Batch IDSolo en Create, y obligatorio en ella. Un identificador tuyo para el envío, distinto cada vez, por ejemplo comisiones-2026-10-ana. PayPal no acepta dos envíos con el mismo, lo que evita pagar dos veces lo mismo.
Email SubjectSolo en Create. El asunto del correo con el que PayPal avisa al destinatario.
Recipient EmailSolo en Create, y obligatorio en ella. El correo de la cuenta de PayPal que recibe el dinero. En Sandbox, usa una de las cuentas personales de prueba de PayPal.
AmountSolo en Create, y obligatorio en ella. El importe con decimales, por ejemplo 10.50.
CurrencySolo en Create. La moneda del envío, como EUR o USD. Por defecto, USD.
NoteSolo en Create. Un mensaje para el destinatario. Opcional.

Operaciones

  • Create: envía el importe a la cuenta de PayPal del destinatario.
  • Get: devuelve el estado del lote y de su envío.

Resultado

La salida Data devuelve el lote: su identificador (Payout Batch ID), su estado, tu Sender Batch ID, el importe, la moneda, la comisión de PayPal y las fechas de creación y finalización. En Get, sale un elemento por cada envío del lote, con el identificador del envío, su estado, el destinatario y el importe.

El identificador de cada envío es el que usa PayPal Payout Item para consultarlo o cancelarlo. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.

Ejemplo

Una plataforma de cursos paga a sus profesores su parte de las ventas cada mes.

  1. El flujo lee de una hoja de cálculo el correo de PayPal de cada profesor y su importe del mes.
  2. Para cada profesor, añade PayPal Payout con Operation en Create.
  3. Pon en Sender Batch ID un identificador con el mes y el profesor, en Recipient Email su correo, en Amount su importe, Currency en EUR y en Email Subject “Tu liquidación de octubre”.
  4. Guarda el Payout Batch ID devuelto en la misma hoja para poder consultarlo después.

Buenas prácticas

  • Prueba tus flujos con una credencial en Sandbox antes de usar una en Live: el dinero enviado en Live es real.
  • Construye el Sender Batch ID con datos que identifiquen el pago, como el mes y el destinatario. Si el flujo se repite por error, PayPal rechaza el envío duplicado.

Componentes relacionados