Recursos · Integración n8n

Integración PayPal n8nAutomatiza PayPal con n8n.

Un pago manual se revisa dos veces; una tanda de pagos manuales no se revisa nunca entera. La integración PayPal n8n trae 4 operaciones repartidas en 2 recursos, Payout y Payout Item, y un trigger que escucha por webhook. Sirve a quien paga cada mes a la misma lista de gente y quiere dejar de hacerlo a mano.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración PayPal n8n?

La integración PayPal n8n conecta una aplicación de la API REST de PayPal con tus flujos de trabajo. El nodo actúa sobre dos recursos: Payout, para crear un pago masivo y mostrar su detalle, y Payout Item, para cancelar un elemento no reclamado o ver el detalle de uno solo. El PayPal Trigger cubre el sentido contrario: PayPal llama a una URL de webhook que n8n registra al activar el flujo, y la ejecución arranca con esa llamada.

Hay tres escenarios que aparecen una y otra vez. Un marketplace que liquida a sus vendedores cada semana: una fila por vendedor en Google Sheets, una llamada a payout.create y un lote en lugar de transferencias sueltas. La revisión posterior: payout.get devuelve el detalle del lote y el flujo lo escribe junto a cada fila. La corrección puntual: payoutItem.cancel cancela un elemento no reclamado cuando alguien quedó registrado con la dirección equivocada, y la llamada afecta solo a ese elemento.

El dinero que entra y el que sale casi nunca viven en la misma herramienta. Los cobros llegan por Stripe, las transferencias internacionales salen por Wise, y el aviso al equipo de finanzas cae en Slack. En n8n esos nodos comparten un mismo flujo, unas mismas credenciales y un mismo registro de ejecución, así que una tanda de pagos se relee línea por línea y se puede volver a lanzar.

El nodo cubre los recursos Payout y Payout Item. Para cualquier endpoint de la API de PayPal que quede fuera de esa lista, el nodo HTTP Request lo llama directamente y reutiliza el mismo credential de PayPal mediante la autenticación predefinida. No hace falta un segundo juego de claves para la misma aplicación.

Dos detalles antes de construir nada. En payout.get, Return All encadena las páginas de la API y lo devuelve todo; desactivado, es Limit quien fija el número máximo de elementos devueltos. En el trigger, el campo Event Names or IDs es obligatorio: mientras esté vacío, el nodo se bloquea en vez de escucharlo todo.

Si todavía estás eligiendo plataforma, la Reseña n8n repasa el alojamiento, el modelo de coste y cómo se comporta el editor en flujos largos. En un pago recurrente, eso pesa más que el número de nodos disponibles.

Conexión

¿Cómo se conecta PayPal con n8n?

  1. 01

    Crea la aplicación en el panel de desarrollador

    Las claves no salen de la cuenta con la que envías dinero. Necesitas una cuenta de desarrollador de PayPal y su panel de desarrollador: Apps and Credentials, REST API apps, Create app. Al crear la aplicación se generan los dos valores que n8n espera, un Client ID y un Secret. Deja la pestaña abierta, porque los copias en el paso siguiente.

  2. 02

    Guarda el credential una sola vez

    En n8n, entra en el menú Credentials y crea un credential de PayPal. Un credential es el bloque de identificadores que los nodos reutilizan sin que los vuelvas a escribir. Este pide tres cosas: el Client ID generado con la aplicación, el Secret generado con ella, y un Environment, donde seleccionas Live o Sandbox. Una vez guardado, aparece en todos los flujos.

  3. 03

    Enlaza el nodo y el trigger con él

    Coloca el nodo PayPal o el PayPal Trigger en el lienzo y elige el credential en la lista desplegable del nodo. El mismo credential autentica a los dos, de modo que un flujo que escucha con el trigger y responde con un pago necesita una sola entrada. Después eliges el recurso, Payout o Payout Item, y la lista de operaciones se reduce a lo que ese recurso admite.

Disparadores

¿Qué pone en marcha un flujo desde PayPal ?

PayPal Trigger es el nodo que arranca un workflow cuando PayPal llama a n8n. Activas el workflow: n8n te da la URL del webhook que registras en PayPal, y cada llamada se convierte en una ejecución.

Lo que ves en n8n

Notas de configuración

01Set Up the PayPal TriggerEl PayPal Trigger es un nodo aparte del nodo PayPal: este último actúa, el trigger es el que arranca la ejecución. Su versión 1 pide poca cosa: el mismo credential de PayPal que usa el nodo de acción, elegido en la misma lista desplegable, y aquello que quieras escuchar. No hay nada más que configurar antes de una primera prueba.

El PayPal Trigger es un nodo aparte del nodo PayPal: este último actúa, el trigger es el que arranca la ejecución. Su versión 1 pide poca cosa: el mismo credential de PayPal que usa el nodo de acción, elegido en la misma lista desplegable, y aquello que quieras escuchar. No hay nada más que configurar antes de una primera prueba.

Parámetros clave

  • Event Names or IDs: obligatorio, de selección múltiple. O marcas entradas de la lista, o indicas los identificadores con una expresión, la sintaxis de n8n que busca un valor en vez de escribirlo fijo. Obligatorio significa que el nodo se niega a ejecutarse mientras el campo esté vacío, así que la selección se decide al principio y no es un filtro que añadas luego.
Cuándo usarlo
cuando es PayPal quien se entera primero de que ha pasado algo y n8n debe reaccionar, en lugar de ir a preguntar cada pocos minutos. El nodo de acción, en cambio, nunca arranca una ejecución por su cuenta: actúa cuando otro nodo ya ha empezado, así que un flujo que responde a PayPal nace en este trigger.
02Receive Events Over the WebhookEste trigger funciona por webhook, es decir, una URL a la que PayPal llama por su cuenta. n8n registra esa URL en PayPal cuando activas el flujo, y cada evento llega al lienzo en unos segundos. Aquí nadie relee la API a horas fijas, así que no hay frecuencia que ajustar ni hueco entre dos comprobaciones.

Este trigger funciona por webhook, es decir, una URL a la que PayPal llama por su cuenta. n8n registra esa URL en PayPal cuando activas el flujo, y cada evento llega al lienzo en unos segundos. Aquí nadie relee la API a horas fijas, así que no hay frecuencia que ajustar ni hueco entre dos comprobaciones.

Parámetros clave

  • Event Names or IDs: la selección que hagas en el trigger es la que decide qué llamadas ponen en marcha una ejecución.
Cuándo usarlo
para todo lo que deba salir al segundo y no a una hora fija, por ejemplo lanzar una conciliación en cuanto PayPal informa sobre un lote. Ojo a un detalle: el registro ocurre al activar, y un flujo inactivo no escucha nada.
Acciones

Lo que sabe hacer el nodo PayPal

El nodo PayPal expone 4 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetCancel
Payout✓✓
Payout Item✓✓

Payout

2 operaciones
01

Create a payout

payout.create

Lo que ves en n8n

Notas y casos de uso

Una sola llamada entrega a PayPal un lote entero: cada destinatario y cada importe.

Parámetros clave

  • Sender Batch ID: obligatorio. Un número de identificación que define el emisor, para seguir el pago en un sistema contable.
  • Items: añades destinatarios de uno en uno con Add Item, o pasas al campo JSON y entregas un array de elementos de pago individuales.
  • Recipient Type y Receiver Value: el tipo de identificador del destinatario, Email, Phone o PayPal ID, y el valor correspondiente, máximo 127 caracteres.
  • Amount y Currency: el valor, con una divisa entre AUD, BRL, CAD, CZK, DKK, EUR o USD.
Casos de uso
la liquidación semanal a los vendedores de un marketplace desde una hoja de cálculo.
02

Get a payout

payout.get

Lo que ves en n8n

Notas y casos de uso

Releer un lote le da al flujo el detalle de lo que se envió, en lugar de una suposición.

Parámetros clave

  • Payout Batch ID: obligatorio, el identificador del pago cuyo detalle quieres ver, a menudo {{ $json.field }} si un paso anterior lo guardó.
  • Return All: activado, n8n recorre las páginas de la API y lo devuelve todo; desactivado, Limit fija el número máximo de elementos devueltos.
Casos de uso
un resumen que relee un lote a posteriori y escribe una fila por elemento en el archivo de seguimiento contable.

Payout Item

2 operaciones
03

Cancel a payout item

payoutItem.cancel

Lo que ves en n8n

Notas y casos de uso

Un lote casi nunca está mal entero, está mal en una fila. Esta operación cancela un elemento de pago no reclamado, y la llamada apunta únicamente a ese elemento.

Parámetros clave

  • Payout Item ID: obligatorio, el identificador del elemento que se cancela. Es el identificador del elemento, no el del lote que recibió la creación.
Casos de uso
un circuito de aprobación en el que un responsable marca a un destinatario del lote y el flujo cancela ese elemento no reclamado sin deshacer el resto a mano.
04

Get a payout item

payoutItem.get

Lo que ves en n8n

Notas y casos de uso

Donde la vista del lote se queda en lo general, esta baja un nivel: muestra el detalle de un único elemento de pago.

Parámetros clave

  • Payout Item ID: obligatorio, el identificador del elemento cuyo detalle quieres ver. Un elemento por llamada, así que una lista de identificadores atraviesa el nodo de uno en uno.
Casos de uso
un flujo de soporte que toma la referencia de un elemento desde un formulario y responde con el detalle de esa fila, sin que nadie abra el panel de PayPal.
Necesitas ayuda

¿Necesitas ayuda para automatizar PayPal con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

PayPal y n8n, las dudas que vienen después

01¿La integración PayPal n8n es gratuita?
Sí, por el lado de n8n. El nodo PayPal y el PayPal Trigger vienen incluidos con n8n: no hay nada que instalar ni ningún módulo que comprar, tanto si trabajas en n8n Cloud, la oferta alojada por n8n, como en una instancia autoalojada en Community Edition con licencia Sustainable Use. Un flujo se comporta igual en los dos casos, así que una tanda de pagos montada en local se mueve después sin reescribirla. Lo que cuesta una cuenta de PayPal es otra pregunta y no se trata aquí. El único requisito por el lado de PayPal es una cuenta de desarrollador, porque ahí es donde se crea la aplicación que genera el Client ID y el Secret.
02¿Qué credenciales necesita el nodo PayPal?
Un único tipo de credential, basado en un cliente de API y un secreto. Necesitas una cuenta de desarrollador de PayPal y su panel: Apps and Credentials, REST API apps, Create app. Al crear la aplicación se generan un Client ID y un Secret. En n8n, el credential pide esos dos valores más un Environment, donde seleccionas Live o Sandbox. El mismo credential autentica al nodo PayPal y al PayPal Trigger, de modo que un flujo que escucha y paga solo necesita una entrada. Un credential se crea una vez en el menú Credentials y se reutiliza en todos los flujos, así que rotar el Secret se hace en un solo sitio.
03¿Qué límites tiene el nodo PayPal en n8n?
El nodo cubre 2 recursos y 4 operaciones: crear un pago masivo, mostrar el detalle de un lote, cancelar un elemento no reclamado y mostrar el detalle de un elemento. Para cualquier endpoint de la API de PayPal fuera de esa lista, el nodo HTTP Request lo llama directamente reutilizando el mismo credential de PayPal mediante la autenticación predefinida, con lo que basta una aplicación y un juego de claves. Dos límites de campo conviene tenerlos previstos: en Get a payout, Return All decide si n8n recorre todas las páginas de la API o se detiene en Limit, y Receiver Value admite 127 caracteres como máximo. El trigger exige al menos una entrada en Event Names or IDs.
04¿El PayPal Trigger reacciona en tiempo real?
Sí. El PayPal Trigger funciona por webhook, una URL a la que PayPal llama cuando ocurre algo. n8n registra esa URL en PayPal al activar el flujo y cada evento llega en unos segundos. Nada relee la API a horas fijas, así que no hay frecuencia que ajustar ni ventana en la que un evento se cuele entre dos comprobaciones. La consecuencia práctica es que la activación importa: un flujo inactivo no tiene URL registrada, y los eventos ocurridos mientras tanto no se quedan en cola esperando. Como el campo Event Names or IDs es obligatorio, la selección que hagas ahí es la que decide qué llamadas arrancan una ejecución.
05¿n8n o Make para automatizar PayPal?
Depende de cuatro criterios, y el precio es solo uno. El alojamiento: n8n se autoaloja con Docker o npm, o se usa en n8n Cloud, mientras que Make únicamente existe alojado. El control de los datos: un flujo de pagos transporta datos de destinatarios e importes, y autoalojar mantiene ese tráfico dentro de tu propia infraestructura. El modelo de coste: Make factura por operación, algo que un lote de pagos multiplica rápido, mientras que una instancia autoalojada de n8n no las cuenta. La lógica visual: los dos editores trabajan con nodos y la preferencia acaba siendo personal. Prueba el mismo flujo en ambos, porque las 4 operaciones de PayPal son las mismas.