Intégration Stripe n8nAutomatiser Stripe avec n8n.
Un paiement qui tombe dans Stripe peut lancer tout le reste. L'intégration Stripe n8n ouvre 20 opérations réparties sur 8 ressources, des paiements aux clients, des coupons aux cartes et aux compteurs d'usage. Son nœud déclencheur, lui, écoute 151 événements classés en 39 familles.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Que fait vraiment l'intégration Stripe n8n ?
L'intégration Stripe n8n, ce sont deux nœuds qui partagent un seul credential, l'accès que tu enregistres une fois dans n8n. Le nœud Stripe appelle l'API de Stripe et expose 20 opérations réparties sur 8 ressources : Balance, Charge, Coupon, Customer, Customer Card, Meter Event, Source et Token. Le nœud Stripe Trigger enregistre un webhook, c'est-à-dire une URL que Stripe appelle à chaque événement, et s'abonne à 151 événements regroupés en 39 familles.
Commence par l'impayé. Le trigger part sur invoice.payment_failed, l'opération Get a customer récupère le nom et l'email posés sur la fiche, et l'alerte arrive dans Slack, sur le canal de l'équipe qui suit les comptes. Le même workflow, la suite d'étapes que tu assembles dans n8n, se coupe sur invoice.paid : le client qui régularise le soir même n'est pas relancé le lendemain.
Vient la compta. Chaque charge.succeeded devient une ligne dans Google Sheets pour le suivi de la semaine, et une écriture dans Xero pour le cabinet. À la clôture, Get many charges avec Return All coché ramène tous les paiements de la période. Sans lui, l'export s'arrête à une page et le rapprochement est faux sans jamais planter.
Troisième terrain, la facturation à l'usage. Create a meter event remonte ce qu'un compte a consommé, un appel par unité, avec un Identifier qui rend une réexécution inoffensive pendant sa fenêtre glissante de 24 heures. La facture que Stripe construit ensuite repasse dans les mêmes alertes que les autres.
Le nœud s'arrête où s'arrêtent ses 8 ressources. Abonnements, remboursements, virements, payment intents et produits existent côté trigger comme événements, et n'ont aucune opération côté nœud. Quand un workflow doit écrire dessus, le nœud HTTP Request appelle l'endpoint directement et réutilise le credential Stripe via son authentification prédéfinie. Rien de plus à stocker.
Deux limites à connaître avant de monter quoi que ce soit. Le mode test et le mode live ont chacun leur clé et leurs objets, donc un workflow validé avec sk_test_ ne trouve plus rien dès que la clé live arrive. Et les opérations de liste ne parcourent les pages de l'API que si Return All est coché. Si le choix de la plateforme n'est pas tranché, l'Avis n8n le compare à Make sur l'hébergement et le coût, et la Formation n8n reprend les schémas de workflow sur lesquels ces flux de paiement reposent.
Comment connecter Stripe à n8n ?
- 01
Créer une clé secrète dans Stripe
Ouvre le tableau de bord développeur de Stripe et va dans API Keys. Dans la section Standard Keys, choisis Create secret key, donne-lui un nom qui dit où elle sert, par exemple
n8n integration, valide et copie la valeur affichée. En mode test, la manœuvre change : la clé secrète existe déjà, tu la dévoiles avec Reveal test key puis tu la copies. Générer une clé demande un compte Stripe admin ou développeur. - 02
Ranger la clé dans un credential n8n
Dans n8n, ouvre le menu Credentials, crée un credential Stripe et colle la valeur dans Secret Key. Les clés secrètes commencent par
sk_,sk_live_en mode live etsk_test_en mode test. Les clés publiables enpk_n'ont rien à faire là, les clés restreintes enrk_n'ont pas été testées. Une fois enregistré, il apparaît dans la liste des deux nœuds Stripe. - 03
Ajouter le Signature Secret après publication
Le Signature Secret n'existe qu'une fois l'endpoint créé. Publie le workflow monté sur le Stripe Trigger : n8n crée un endpoint webhook dans le compte Stripe. Dans le Dashboard Stripe, ouvre Workbench puis Webhooks (Developers puis Webhooks sur les anciens tableaux de bord), repère l'endpoint marqué Created by n8n for workflow ID, révèle la valeur sous Signing secret et colle ce
whsec_dans Signature Secret.
Qu'écoute le Stripe Trigger ?
Stripe Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Stripe. Il écoute 151 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Stripe appelle) sur ton compte.
Ce que tu vois dans n8n
Tous les événements, par famille
Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.
customer.*17customer.createddeletedupdated
customer.discount. createddeletedupdated
customer.source. createddeletedexpiringupdated
customer.subscription. createddeletedtrial_will_ end updated
customer.tax_ id. createddeletedupdated
charge.*13charge.capturedexpiredfailedpendingrefundedsucceededupdated
charge.dispute. closedcreatedfunds_reinstated funds_withdrawn updated
charge.refund. updated
invoice.*12invoice.createddeletedfinalizedmarked_uncollectible paidpayment_action_ required payment_failed payment_succeeded sentupcomingupdatedvoided
source.*7source.canceledchargeablefailedmandate_notification refund_attributes_ required
source.transaction. createdupdated
subscription_schedule.*7subscription_schedule. abortedcanceledcompletedcreatedexpiringreleasedupdated
account.*6account.updated
account.application. authorizeddeauthorized
account.external_ account. createddeletedupdated
payment_intent.*6payment_intent. amount_capturable_ updated canceledcreatedpayment_failed succeededrequires_action
payout.*5payout.canceledcreatedfailedpaidupdated
topup.*5topup.canceledcreatedfailedreversedsucceeded
transfer.*5transfer.createdfailedpaidreversedupdated
order.*4order.createdpayment_failed payment_succeeded updated
payment_method.*4payment_method. attachedcard_automatically_ updated detachedupdated
setup_intent.*4setup_intent. canceledcreatedsetup_failed succeeded
application_fee.*3application_fee. createdrefunded
application_fee. refund. updated
coupon.*3coupon.createddeletedupdated
credit_note.*3credit_note. createdupdatedvoided
invoiceitem.*3invoiceitem.createddeletedupdated
issuing_authorization.*3issuing_authorization. createdrequestupdated
person.*3person.createddeletedupdated
plan.*3plan.createddeletedupdated
product.*3product.createddeletedupdated
recipient.*3recipient.createddeletedupdated
reporting.*3reporting.report_ run. failedsucceeded
reporting.report_ type. updated
sku.*3sku.createddeletedupdated
issuing_card.*2issuing_card. createdupdated
issuing_cardholder.*2issuing_cardholder. createdupdated
issuing_dispute.*2issuing_dispute. createdupdated
issuing_settlement.*2issuing_settlement. createdupdated
issuing_transaction.*2issuing_transaction. createdupdated
radar.*2radar.early_ fraud_ warning. createdupdated
review.*2review.closedopened
tax_rate.*2tax_rate. createdupdated
balance.*1balance.available
capability.*1capability.updated
checkout.*1checkout.session. completed
file.*1file.created
invoice_payment.*1invoice_payment. paid
order_return.*1order_return. created
sigma.*1sigma.scheduled_ query_ run. created
Le trigger accepte aussi * (tout événement). Pratique pour du log, dangereux en production.
Notes de configuration
01Configure the Stripe Trigger
Ce nœud porte la partie webhook de l'intégration. Tu publies le workflow, n8n enregistre un endpoint dans le compte Stripe, et chaque événement arrive en quelques secondes. C'est Stripe qui appelle n8n, jamais l'inverse.
Paramètres clés
- Events : les événements auxquels l'endpoint s'abonne, 151 au total, répartis en 39 familles. Le joker
*les prend tous, pratique le temps d'inspecter un premier payload, ingérable en production. - API Version : facultatif, ce champ fige le format et la structure des payloads envoyés par Stripe. Laissé vide, Stripe applique la version d'API par défaut du compte à cet instant, et un changement ultérieur de cette valeur par défaut peut décaler le payload sous un workflow qui tournait très bien.
02invoice.*
Douze événements suivent une facture, de invoice.created à invoice.voided. C'est la famille à surveiller quand l'argent passe par une facture plutôt que par un encaissement direct.
invoice.payment_failed se déclenche quand une tentative de paiement sur une facture échoue, soit parce que le paiement a été refusé, soit parce qu'aucun moyen de paiement n'est enregistré. invoice.paid arrive quand la tentative réussit, et aussi quand la facture est marquée comme payée en dehors de Stripe. invoice.upcoming tombe un certain nombre de jours avant la facturation d'un abonnement, délai fixé dans tes réglages d'abonnement, et son payload ne porte aucun identifiant de facture.invoice.paid, et prévient le responsable du compte pendant que la facture suivante est encore à venir.03charge.*
Treize événements racontent la vie d'un paiement : charge.succeeded, charge.failed, charge.pending, charge.captured, charge.expired, charge.refunded et charge.updated, plus cinq événements de litige et charge.refund.updated. Entre le paiement en attente et le paiement capturé, la famille couvre aussi ce qui n'est pas encore encaissé.
charge.dispute.created arrive quand un client conteste un paiement auprès de sa banque, charge.dispute.funds_withdrawn quand l'argent quitte le compte, charge.dispute.funds_reinstated quand il revient, et charge.dispute.closed porte l'issue. Attention à charge.refunded, qui couvre aussi les remboursements partiels : c'est le montant qui compte, pas le nom de l'événement.charge.succeeded, et une alerte séparée sur charge.dispute.created, parce que celle-là réclame un humain dans la journée.04customer.*
Dix-sept événements, la plus grosse famille du trigger, et plusieurs objets derrière : le client lui-même avec created, deleted et updated, puis ses réductions, ses sources, ses abonnements et ses identifiants fiscaux.
customer.subscription.created marque une souscription, customer.subscription.updated couvre un changement de plan ou le passage d'un essai à un abonnement actif, customer.subscription.deleted la fin, et customer.subscription.trial_will_end tombe trois jours avant la fin prévue d'un essai. customer.source.expiring prévient qu'une carte ou une source expire à la fin du mois.Que sait faire le nœud Stripe ?
Le nœud Stripe expose 20 opérations sur 8 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | Create | Get | Get Many | Update | Delete | Add | Remove |
|---|---|---|---|---|---|---|---|
| Balance | ✓ | ||||||
| Charge | ✓ | ✓ | ✓ | ✓ | |||
| Coupon | ✓ | ✓ | |||||
| Customer | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Customer Card | ✓ | ✓ | ✓ | ||||
| Meter Event | ✓ | ||||||
| Source | ✓ | ✓ | ✓ | ||||
| Token | ✓ |
Sommaire des opérations
Balance
1 opérationGet a balance
balance.getCe que tu vois dans n8n
Notes & cas d'usage
Lire le solde du compte, c'est tout ce que fait cette opération. Elle renvoie ce que Stripe détient à l'instant T, d'un côté les fonds déjà disponibles, de l'autre ceux encore en attente. Aucun champ à remplir : le nœud interroge le compte rattaché au credential choisi.
Charge
4 opérationsCreate a charge
charge.createCe que tu vois dans n8n
Notes & cas d'usage
C'est ici qu'on encaisse un moyen de paiement déjà rattaché à un client. L'opération crée le paiement dans Stripe et renvoie l'objet créé avec son statut.
Paramètres clés
- Customer ID : le client auquel le paiement est associé, souvent
{{ $json.id }}repris du nœud précédent. - Amount : le montant en centimes, donc
100pour un dollar. - Currency Name or ID : un code ISO à trois lettres comme
USDouEUR, pris dans la liste ou écrit en expression. - Source ID : la source de paiement du client à débiter.
Get a charge
charge.getCe que tu vois dans n8n
Notes & cas d'usage
Un paiement, par son identifiant. Le nœud renvoie l'objet complet, donc le workflow peut brancher sur le statut, le montant ou les métadonnées sans second appel.
Paramètres clés
- Charge ID : l'identifiant du paiement à récupérer, en général
{{ $json.id }}quand un événement de paiement a lancé l'exécution.
Get many charges
charge.getAllCe que tu vois dans n8n
Notes & cas d'usage
Une liste de paiements, plutôt qu'un seul. En sortie, un item par paiement.
Paramètres clés
- Return All : coché, n8n enchaîne les pages de l'API Stripe jusqu'au dernier paiement du compte.
- Limit : lu uniquement quand Return All reste décoché, il plafonne le nombre de paiements ramenés par exécution.
Update a charge
charge.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifier un paiement après coup reste volontairement étroit. Quatre champs sont regroupés sous Update Fields, Description, Metadata, Receipt Email et Shipping, et rien d'autre ne bouge.
Paramètres clés
- Charge ID : le paiement à mettre à jour.
- Metadata : des paires clé et valeur attachées au paiement, ajoutées une par une avec Add Metadata Item.
Coupon
2 opérationsCreate a coupon
coupon.createCe que tu vois dans n8n
Notes & cas d'usage
Une remise définie dans Stripe plutôt que dans ton propre code. L'opération crée le coupon et le renvoie, prêt à être attaché à un client.
Paramètres clés
- Apply : la durée d'effet de la remise, Forever ou Once.
- Discount Type : Percent, ou Fixed Amount (in Cents).
- Amount Off : le montant en centimes retiré du total d'une facture.
- Percent Off : le pourcentage appliqué par le coupon.
- Currency Name or ID : le code ISO à trois lettres dans lequel le montant est exprimé.
Get many coupons
coupon.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les coupons qui existent dans le compte, le moyen le plus rapide de voir ce qui tourne encore avant d'en créer un de plus.
Paramètres clés
- Return All : activé, le nœud redemande des pages jusqu'à sortir la liste entière.
- Limit : Return All désactivé, c'est lui qui plafonne le nombre de coupons renvoyés.
Customer
5 opérationsCreate a customer
customer.createCe que tu vois dans n8n
Notes & cas d'usage
La fiche client sert d'ancrage à presque tout le reste dans Stripe : cartes, sources, paiements et factures s'y accrochent. Cette opération la crée et renvoie le nouvel identifiant.
Paramètres clés
- Name : le seul champ requis, nom complet ou raison sociale.
- Email : facultatif dans le nœud, rarement facultatif en vrai, puisque les reçus et les emails de facture partent là. Il est dans Additional Fields, à côté d'Address, Phone, Description, Metadata et Shipping.
Delete a customer
customer.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime un client du compte Stripe. Un identifiant, aucune option : l'opération est aussi simple à brancher qu'à déclencher par erreur.
Paramètres clés
- Customer ID : le client à supprimer. Mets un filtre ou une validation manuelle en amont, parce que n8n exécute le nœud dès qu'un item lui arrive.
Get a customer
customer.getCe que tu vois dans n8n
Notes & cas d'usage
Va chercher un client et renvoie la fiche telle qu'elle est stockée : le nom, l'email s'il a été renseigné, l'adresse, les métadonnées.
Paramètres clés
- Customer ID : l'identifiant du client à récupérer, lu la plupart du temps sur l'item entrant avec
{{ $json.id }}.
Get many customers
customer.getAllCe que tu vois dans n8n
Notes & cas d'usage
Parcourt la liste des clients au lieu d'une fiche, et sait la réduire avant même que quoi que ce soit ne remonte.
Paramètres clés
- Email : rangé sous Filters, il demande à Stripe les clients qui portent cette adresse, ce qui s'approche le plus d'une recherche par email.
- Return All : activé, le nœud parcourt toute la liste ; désactivé, Limit décide du nombre.
Update a customer
customer.updateCe que tu vois dans n8n
Notes & cas d'usage
Change ce que Stripe garde sur un client. Sept champs sont disponibles sous Update Fields, Address, Description, Email, Metadata, Name, Phone et Shipping, et seuls ceux que tu ajoutes sont touchés.
Paramètres clés
- Customer ID : le client à mettre à jour.
- Email : l'adresse que Stripe utilise pour les reçus et les emails de facture, à pousser le jour où elle change dans ta propre base.
Customer Card
3 opérationsAdd a customer card
customerCard.addCe que tu vois dans n8n
Notes & cas d'usage
Attache une carte à un client existant. Les données de carte ne circulent pas en clair ici : l'opération attend un jeton qui les représente déjà.
Paramètres clés
- Customer ID : le client auquel la carte est rattachée.
- Card Token : le jeton qui représente les informations sensibles de la carte, une chaîne
tok_produite par l'opération Create a token ou par ton propre tunnel de paiement.
Get a customer card
customerCard.getCe que tu vois dans n8n
Notes & cas d'usage
Relit une carte précise d'un client précis. Deux identifiants sont nécessaires, puisqu'un client peut en détenir plusieurs.
Paramètres clés
- Customer ID : le client dont on lit la carte.
- Source ID : la source à récupérer, c'est-à-dire l'identifiant de la carte chez ce client.
customer.source.expiring, avant d'encaisser quoi que ce soit dessus.Remove a customer card
customerCard.removeCe que tu vois dans n8n
Notes & cas d'usage
Détache une carte d'un client. Le nom du champ mérite un coup d'œil : cette opération réclame un Card ID là où la lecture réclame un Source ID.
Paramètres clés
- Customer ID : le client propriétaire de la carte.
- Card ID : la carte à retirer.
Meter Event
1 opérationCreate a meter event
meterEvent.createCe que tu vois dans n8n
Notes & cas d'usage
La facturation à l'usage réclame un compteur. Cette opération l'alimente : chaque appel déclare une unité consommée, pour un client, sur un compteur.
Paramètres clés
- Event Name : correspond au champ event_name du compteur configuré dans Stripe.
- Customer ID : le client Stripe auquel la consommation est imputée.
- Value : un entier, positif ou négatif.
- Identifier : facultatif, mais utile, car l'unicité est vérifiée sur une fenêtre glissante de 24 heures, ce qui empêche une réexécution de compter deux fois.
- Timestamp : le moment de l'événement, dans les 35 derniers jours ou jusqu'à 5 minutes dans le futur.
Source
3 opérationsCreate a source
source.createCe que tu vois dans n8n
Notes & cas d'usage
Fabrique une source de paiement et la rattache à un client. Dans le nœud, Type ne propose qu'une valeur, WeChat : c'est donc l'opération de ce moyen de paiement, pas une opération générique.
Paramètres clés
- Customer ID : le client auquel la source est rattachée.
- Type : WeChat, seule entrée de la liste.
- Amount et Currency Name or ID : non requis par le nœud, ils portent le montant en centimes et le code ISO quand la source en transporte un.
source.chargeable avant d'encaisser.Delete a source
source.deleteCe que tu vois dans n8n
Notes & cas d'usage
Retire une source d'un client, avec le même couple d'identifiants que la lecture. Rien d'autre ne se configure, donc le garde-fou doit vivre plus haut dans le workflow.
Paramètres clés
- Customer ID : le client dont la source disparaît.
- Source ID : la source à supprimer.
source.canceled ou source.failed, pour que la fiche client cesse de proposer un moyen de paiement mort.Get a source
source.getCe que tu vois dans n8n
Notes & cas d'usage
Renvoie une source seule, sans nommer de client. Seul l'identifiant de la source est requis, ce qui en fait la voie la plus courte pour inspecter l'objet derrière un événement de source.
Paramètres clés
- Source ID : l'identifiant de la source à récupérer.
source.chargeable relit la source pour confirmer son état, puis décide si l'encaissement peut partir.Token
1 opérationCreate a token
token.createCe que tu vois dans n8n
Notes & cas d'usage
Transforme des données de carte en jeton, pour ne jamais garder la carte de ton côté. C'est ce jeton qu'attend ensuite Add a customer card.
Paramètres clés
- Type : la liste ne contient qu'une entrée, Card Token.
- Card Number, CVC, Expiration Month et Expiration Year : les champs de la carte, aucun requis par le nœud, remplis depuis ce qui les a collectés. Les placeholders montrent la forme attendue,
4242424242424242pour le numéro et314pour le code imprimé au dos.
Besoin d'aide pour automatiser Stripe avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.


