Intégration PayPal n8nAutomatiser PayPal avec n8n.
Payer une liste de prestataires à la main, c'est autant d'occasions de se tromper. L'intégration PayPal n8n donne 4 opérations réparties sur 2 ressources, Payout et Payout Item, plus un trigger qui écoute par webhook. De quoi sortir les versements du tableur et les mettre dans un workflow qui tourne seul.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert vraiment l'intégration PayPal n8n ?
L'intégration PayPal n8n relie une application de l'API REST PayPal à tes workflows. Le nœud travaille sur deux ressources : Payout, pour créer un versement groupé et en afficher le détail, et Payout Item, pour annuler un élément non réclamé ou afficher le détail d'un seul. Le PayPal Trigger s'occupe du sens inverse : PayPal appelle une URL webhook que n8n enregistre à l'activation du workflow, et l'exécution démarre sur cet appel.
Trois situations reviennent tout le temps. Le paiement d'une liste de prestataires en fin de mois : une ligne par personne dans Google Sheets, un appel payout.create, un lot envoyé d'un coup. La relecture après coup : payout.get ramène le détail du lot, et le workflow le recopie en face de la bonne ligne. La correction ciblée : payoutItem.cancel annule un élément non réclamé quand quelqu'un a été saisi avec la mauvaise adresse, et l'appel ne porte que sur cet élément.
L'argent qui rentre et l'argent qui sort tiennent rarement dans le même outil. Les encaissements arrivent par Stripe, les virements internationaux passent par Wise, et la confirmation part par Gmail à la personne payée. Ces nœuds partagent le même workflow, les mêmes credentials et le même journal d'exécution : une campagne de versements se relit ligne par ligne, et se rejoue si besoin.
Le nœud couvre les ressources Payout et Payout Item. Pour n'importe quel endpoint de l'API PayPal en dehors de cette liste, le nœud HTTP Request l'appelle directement et réutilise le même credential PayPal via l'authentification prédéfinie. Pas de deuxième jeu de clés à gérer pour la même application.
Deux points à connaître avant de construire. Sur payout.get, Return All enchaîne les pages de l'API et ramène tout ; désactivé, c'est Limit qui fixe le nombre maximal d'items renvoyés. Côté trigger, le champ Event Names or IDs est requis : tant qu'il est vide, le nœud bloque au lieu d'écouter tout ce qui passe.
Si le choix de la plateforme n'est pas encore fait, l'Avis n8n détaille l'hébergement, le modèle de coût et le confort de l'éditeur sur les gros workflows. Sur un versement récurrent, ça pèse plus lourd que le nombre de nœuds disponibles.
Comment connecter PayPal à n8n ?
- 01
Créer l'application côté développeur PayPal
Les clés ne viennent pas du compte qui sert à envoyer l'argent. Il faut un compte développeur PayPal, puis le tableau de bord développeur : Apps and Credentials, REST API apps, Create app. La création de l'application génère les deux valeurs attendues par n8n, un Client ID et un Secret. Garde l'onglet ouvert, tu copies les deux à l'étape suivante.
- 02
Enregistrer le credential une seule fois
Dans n8n, menu Credentials, crée un credential PayPal. Un credential, c'est le bloc d'identifiants que les nœuds réutilisent sans que tu les retapes. Celui-ci demande trois choses : le Client ID généré avec l'application, le Secret généré en même temps, et un Environment, où tu sélectionnes Live ou Sandbox. Une fois enregistré, il est proposé dans tous les workflows.
- 03
Brancher le nœud et le trigger dessus
Pose le nœud PayPal ou le PayPal Trigger sur le canevas, puis choisis le credential dans la liste déroulante du nœud. Le même credential authentifie les deux, donc un workflow qui écoute avec le trigger et répond avec un versement n'a besoin que d'une entrée. Choisis ensuite la ressource, Payout ou Payout Item : la liste des opérations se réduit à ce que cette ressource accepte.
Qu'est-ce qui déclenche un workflow depuis PayPal ?
PayPal Trigger est le nœud qui démarre un workflow quand PayPal appelle n8n. Tu actives le workflow : n8n te donne l'URL du webhook à enregistrer dans PayPal, et chaque appel devient une exécution.
Ce que tu vois dans n8n
Notes de configuration
01Set Up the PayPal Trigger
Le PayPal Trigger est un nœud distinct du nœud PayPal : c'est lui qui démarre l'exécution, l'autre ne fait qu'agir. Sa version 1 demande peu de choses : le même credential PayPal que le nœud d'action, choisi dans la même liste déroulante, et ce que tu veux écouter. Rien d'autre à régler avant un premier test.
Paramètres clés
- Event Names or IDs : requis, sélection multiple. Soit tu coches des entrées dans la liste, soit tu indiques les identifiants avec une expression, la syntaxe n8n qui va chercher une valeur au lieu de l'écrire en dur. Requis veut dire que le nœud refuse de s'exécuter tant que le champ est vide : la sélection se décide au départ, ce n'est pas un filtre qu'on ajoute après coup.
02Receive Events Over the Webhook
Ce trigger fonctionne par webhook, c'est-à-dire une URL que PayPal appelle de lui-même. n8n enregistre cette URL auprès de PayPal au moment où tu actives le workflow, et chaque événement arrive sur le canevas en quelques secondes. L'URL est fabriquée par n8n, tu n'as pas à la taper toi-même. Rien ne relit l'API à heure fixe : aucune fréquence à régler, aucun trou entre deux vérifications.
Paramètres clés
- Event Names or IDs : la sélection faite dans le trigger décide des appels qui déclenchent réellement une exécution.
Ce que le nœud PayPal sait faire
Le nœud PayPal expose 4 opérations sur 2 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Payout
2 opérationsCreate a payout
payout.createCe que tu vois dans n8n
Notes & cas d'usage
Un seul appel confie à PayPal un lot complet : chaque bénéficiaire et chaque montant.
Paramètres clés
- Sender Batch ID : requis. Un numéro d'identification défini par l'émetteur, pour suivre le versement dans un système comptable.
- Items : tu ajoutes les bénéficiaires un par un avec Add Item, ou tu passes par le champ JSON et tu fournis un tableau d'éléments de versement individuels.
- Recipient Type et Receiver Value : le type d'identifiant du bénéficiaire, Email, Phone ou PayPal ID, et la valeur correspondante, 127 caractères au maximum.
- Amount et Currency : la valeur, avec une devise prise dans AUD, BRL, CAD, CZK, DKK, EUR ou USD.
Get a payout
payout.getCe que tu vois dans n8n
Notes & cas d'usage
Relire un lot donne au workflow le détail réel de ce qui a été envoyé, plutôt qu'une hypothèse.
Paramètres clés
- Payout Batch ID : requis, l'identifiant du versement dont on veut le détail, souvent
{{ $json.field }}quand une étape précédente l'a stocké. - Return All : activé, n8n parcourt les pages de l'API et ramène tout ; désactivé, Limit fixe le nombre maximal d'items renvoyés.
Payout Item
2 opérationsCancel a payout item
payoutItem.cancelCe que tu vois dans n8n
Notes & cas d'usage
Un lot est rarement faux en entier, il est faux sur une ligne. Cette opération annule un élément de versement non réclamé, et l'appel ne vise que celui-là.
Paramètres clés
- Payout Item ID : requis, l'identifiant de l'élément à annuler. C'est bien l'identifiant de l'élément, pas celui du lot fourni à la création.
Get a payout item
payoutItem.getCe que tu vois dans n8n
Notes & cas d'usage
Là où la vue du lot reste globale, celle-ci descend d'un cran : elle affiche le détail d'un seul élément de versement.
Paramètres clés
- Payout Item ID : requis, l'identifiant de l'élément dont on veut le détail. Un élément par appel, donc une liste d'identifiants traverse le nœud item par item.
Besoin d'aide pour automatiser PayPal avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
