Ressources · Intégration n8n

Intégration Chargebee n8nAutomatiser Chargebee avec n8n.

Combien de relances de factures partent encore à la main chez toi ? L'intégration Chargebee n8n pose sur le canevas un nœud de 5 opérations (clients, factures, abonnements) et un trigger qui écoute 34 événements Chargebee par webhook. De quoi brancher la facturation sur le reste des outils.

Tester l'intégration Chargebee sur n8n Voir les 5 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

Que fait vraiment l'intégration Chargebee n8n ?

Chargebee gère l'abonnement, la facture et l'encaissement. n8n, lui, fait circuler ces informations vers les outils où travaillent tes équipes. L'intégration Chargebee n8n tient en deux briques. Le Chargebee Trigger démarre un workflow, c'est-à-dire une suite d'étapes automatisées, dès qu'un événement se produit sur ton site Chargebee. Le nœud Chargebee, lui, exécute 5 opérations réparties sur 3 ressources quand il faut écrire ou lire quelque chose.

Commence par le cas le plus rentable : la carte qui va expirer. L'événement card_expiring part 30 jours avant la date d'expiration. Trente jours, c'est largement le temps de demander une nouvelle carte sans urgence, par un message envoyé avec Gmail, et d'arrêter la séquence dès que card_updated arrive pour le même client. Le paiement échoué que tu évites ainsi ne coûte rien à personne.

Deuxième usage, moins glamour mais très demandé : suivre les résiliations. subscription_cancellation_scheduled annonce une résiliation programmée pour la fin de la période en cours, subscription_cancelling tombe 6 jours avant la date prévue, et subscription_scheduled_cancellation_removed signale un retour en arrière. Ces trois événements alimentent une ligne dans Google Sheets, et le fichier de churn se remplit tout seul, avec la date et le motif au bon endroit.

Troisième usage, côté écriture cette fois. Un formulaire d'inscription crée le client via customer.create, sans ressaisie. Plus tard, quand une facture arrive, invoice.pdfUrl renvoie le lien du PDF et la relance part avec le document déjà attaché. Si tu encaisses aussi via une autre plateforme, le nœud Stripe se branche sur le même canevas.

Pour tout ce qui sort de ces 5 opérations du catalogue, la réponse est le nœud HTTP Request : il appelle n'importe quel endpoint de l'API Chargebee en réutilisant le credential Chargebee via son authentification prédéfinie. Un credential, ce sont les identifiants enregistrés une fois dans n8n, donc pas de deuxième clé à gérer.

Un mot sur la répartition des forces. Le trigger est la partie large de cette intégration, le nœud la partie ciblée. Les workflows qui réagissent vivent dans le trigger, ceux qui écrivent enchaînent le nœud avec les autres outils. L'Avis n8n détaille ce que ça donne sur des automatisations plus lourdes, et la Formation n8n reprend la construction d'un workflow complet.

Connexion

Comment connecter Chargebee à n8n ?

01
Générer une clé API dans Chargebee
Il te faut d'abord un compte Chargebee. Dans ce compte, génère une clé API en suivant la documentation Chargebee consacrée à la création d'une clé API. C'est la seule méthode d'authentification acceptée ici, et elle sert autant au nœud Chargebee qu'au Chargebee Trigger. Copie la clé avant de quitter l'écran, tu en auras besoin à l'étape suivante.
02
Créer le credential côté n8n
Ouvre le menu Credentials de n8n et ajoute un credential Chargebee. Deux champs à remplir. Account Name attend le nom de ton site Chargebee, c'est-à-dire le sous-domaine seul : pour un site à l'adresse https://n8n.chargebee.com, l'Account Name est n8n. API Key reçoit la clé générée juste avant. Enregistré une fois, ce credential se retrouve dans la liste déroulante de tous tes workflows.
03
Déclarer l'URL du webhook dans Chargebee
Le trigger a besoin que Chargebee l'appelle. Dans ton tableau de bord Chargebee, va dans Settings, puis Configure Chargebee, descends jusqu'à Webhooks et clique sur Add Webhook. Renseigne un Webhook Name, colle le Webhook URL affiché par le nœud trigger dans n8n, puis valide avec Create. Un webhook, c'est une URL que Chargebee appelle au moment où l'événement se produit : les données arrivent en quelques secondes, sans interrogation régulière.

Déclencheurs

Qu'est-ce qui déclenche un workflow depuis Chargebee ?

Chargebee Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Chargebee. Il écoute 34 é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 Chargebee 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.

card_added.*1

card_added.
- card_added

card_deleted.*1

card_deleted.
- card_deleted

card_expired.*1

card_expired.
- card_expired

card_expiring.*1

card_expiring.
- card_expiring

card_updated.*1

card_updated.
- card_updated

customer_changed.*1

customer_changed.
- customer_changed

customer_created.*1

customer_created.
- customer_created

customer_deleted.*1

customer_deleted.
- customer_deleted

invoice_created.*1

invoice_created.
- invoice_created

invoice_deleted.*1

invoice_deleted.
- invoice_deleted

invoice_generated.*1

invoice_generated.
- invoice_generated

invoice_updated.*1

invoice_updated.
- invoice_updated

payment_failed.*1

payment_failed.
- payment_failed

payment_initiated.*1

payment_initiated.
- payment_initiated

payment_refunded.*1

payment_refunded.
- payment_refunded

payment_succeeded.*1

payment_succeeded.
- payment_succeeded

refund_initiated.*1

refund_initiated.
- refund_initiated

subscription_activated.*1

subscription_activated.
- subscription_activated

subscription_cancellation_scheduled.*1

subscription_cancellation_scheduled.
- subscription_cancellation_scheduled

subscription_cancelled.*1

subscription_cancelled.
- subscription_cancelled

subscription_cancelling.*1

subscription_cancelling.
- subscription_cancelling

subscription_changed.*1

subscription_changed.
- subscription_changed

subscription_created.*1

subscription_created.
- subscription_created

subscription_deleted.*1

subscription_deleted.
- subscription_deleted

subscription_reactivated.*1

subscription_reactivated.
- subscription_reactivated

subscription_renewal_reminder.*1

subscription_renewal_reminder.
- subscription_renewal_reminder

subscription_renewed.*1

subscription_renewed.
- subscription_renewed

subscription_scheduled_cancellation_removed.*1

subscription_scheduled_cancellation_removed.
- subscription_scheduled_cancellation_removed

subscription_shipping_address_updated.*1

subscription_shipping_address_updated.
- subscription_shipping_address_updated

subscription_started.*1

subscription_started.
- subscription_started

subscription_trial_ending.*1

subscription_trial_ending.
- subscription_trial_ending

transaction_created.*1

transaction_created.
- transaction_created

transaction_deleted.*1

transaction_deleted.
- transaction_deleted

transaction_updated.*1

transaction_updated.
- transaction_updated

Le trigger accepte aussi * (tout événement). Pratique pour du log, dangereux en production.

Notes de configuration

01Set up the Chargebee TriggerLe Chargebee Trigger (version 1) démarre le workflow quand un événement Chargebee se produit. Un seul réglage compte vraiment, et c'est la liste des événements.

Le Chargebee Trigger (version 1) démarre le workflow quand un événement Chargebee se produit. Un seul réglage compte vraiment, et c'est la liste des événements.

Paramètres clés

Events : la liste des événements auxquels ce workflow réagit. Les 34 événements y sont, regroupés par objet, et tu coches ce dont le workflow a besoin.
Events réglé sur * : le joker, tous les événements envoyés par Chargebee. Pratique pour un workflow unique qui trie ensuite en interne, moins lisible quand le canevas doit rester compréhensible par quelqu'un d'autre.

Quand l'utiliser

coche les événements précis dès qu'un client reçoit un message au bout de la chaîne, une erreur de branche se voit tout de suite. Garde le joker pour les workflows de journalisation et pour la phase d'observation, quand tu veux simplement voir ce que ton site Chargebee émet sur une semaine normale.

02React to subscription eventsL'abonnement concentre la plus grosse part des 34 événements, ce qui n'a rien d'étonnant sur une plateforme de facturation récurrente.

L'abonnement concentre la plus grosse part des 34 événements, ce qui n'a rien d'étonnant sur une plateforme de facturation récurrente.

Paramètres clés

Events, les changements d'état : subscription_created, subscription_started quand un abonnement futur démarre, subscription_activated après le passage de l'essai à l'état actif, subscription_changed sur les éléments récurrents, subscription_renewed, subscription_reactivated, subscription_deleted et subscription_shipping_address_updated.
Events, le parcours de résiliation : subscription_cancellation_scheduled, subscription_cancelling 6 jours avant la date prévue, subscription_cancelled, et subscription_scheduled_cancellation_removed quand la résiliation programmée est annulée.
Events, les deux avertissements : subscription_trial_ending 6 jours avant la fin de l'essai et subscription_renewal_reminder 3 jours avant le renouvellement.

Cas d'usage

un workflow de rétention branché sur la résiliation programmée plutôt que sur la résiliation déjà effective. La discussion a lieu tant que l'abonnement tourne encore.

03React to invoice and payment eventsL'argent qui bouge occupe l'autre moitié du tableau : 4 événements sur les factures, 5 sur les paiements et les remboursements.

L'argent qui bouge occupe l'autre moitié du tableau : 4 événements sur les factures, 5 sur les paiements et les remboursements.

Paramètres clés

Events, les factures : invoice_generated à la génération d'une nouvelle facture, invoice_updated quand l'adresse de facturation ou de livraison change, quand la facture est annulée, ou quand le montant dû bouge parce qu'un paiement a été appliqué ou retiré, plus invoice_created et invoice_deleted.
Events, les paiements : payment_succeeded quand l'encaissement aboutit, payment_failed quand la tentative de débit de la carte échoue, payment_initiated pour un paiement lancé en prélèvement, payment_refunded, et refund_initiated pour un remboursement lancé en prélèvement.

Quand l'utiliser

attention à invoice_created, réservé à la facturation à l'usage, sur une facture « Pending » qui attend encore des lignes, et uniquement si l'option Notify for Pending Invoices est activée. Au quotidien, c'est invoice_generated qu'il faut cocher.

04React to card eventsLes cartes forment un groupe de 5 événements. Ce sont les plus discrets de la liste, et probablement les plus rentables, car ils évitent des paiements refusés qui coûtent du temps à tout le monde.

Les cartes forment un groupe de 5 événements. Ce sont les plus discrets de la liste, et probablement les plus rentables, car ils évitent des paiements refusés qui coûtent du temps à tout le monde.

Paramètres clés

Events, l'alerte en avance : card_expiring part 30 jours avant l'expiration.
Events, le constat : card_expired une fois la date passée, et card_deleted quand une carte est supprimée chez un client.
Events, le suivi courant : card_added et card_updated, utiles pour confirmer au client que sa nouvelle carte est bien enregistrée.

Cas d'usage

une séquence de rappel déclenchée par card_expiring et stoppée dès l'arrivée de card_updated sur le même client. C'est la mécanique anti-churn la moins chère de cette page, et elle ne mobilise aucune opération du nœud Chargebee, seulement le trigger et l'outil d'envoi qui suit.

05React to customer and transaction eventsRestent deux groupes plus petits qui bouclent le compte : 3 événements sur la fiche client, 3 sur les transactions.

Restent deux groupes plus petits qui bouclent le compte : 3 événements sur la fiche client, 3 sur les transactions.

Paramètres clés

Events, les clients : customer_created, customer_changed dès qu'un client est modifié, et customer_deleted. Ce sont ceux à recopier vers un CRM pour que la facturation et le commercial voient les mêmes noms.
Events, les transactions : transaction_created quand une transaction est enregistrée, transaction_deleted, et transaction_updated, qui couvre aussi le retrait d'une transaction, l'application d'un excédent de paiement sur une facture, ou la modification du montant capturable.

Cas d'usage

pour tenir un journal comptable à jour, les événements de transaction valent mieux que ceux de facture. Ils racontent ce qui est réellement arrivé à l'argent, et non ce qui a été facturé sur le papier.

Actions

Que sait faire le nœud Chargebee ?

Le nœud Chargebee expose 5 opérations sur 3 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
Ressource	Create	Delete	Cancel	List	PDF Invoice URL
Customer	✓
Invoice				✓	✓
Subscription		✓	✓

Customer

1 opération

Create a customer

customer.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée le client dans Chargebee et renvoie la fiche créée au workflow. Une inscription captée ailleurs arrive donc dans la facturation sans deuxième saisie.

Paramètres clés

Email : l'adresse email du client, en général reprise de l'élément qui a déclenché l'exécution.
User ID : ton propre identifiant pour ce client. Laissé vide, il est généré automatiquement.
First Name, Last Name, Phone et Company : les informations nominatives qui apparaissent sur les factures et dans la liste des clients.
Custom Properties : ajoute une propriété absente de la liste prédéfinie, par exemple un code offre ou un responsable de compte.

Cas d'usage

un formulaire d'inscription crée la fiche, et la même exécution annonce le nouveau compte à l'équipe.

Invoice

2 opérations

List an invoice

invoice.list

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère les factures du site Chargebee sous forme d'items exploitables par les nœuds suivants. C'est la brique qui remplace l'export mensuel fait à la main.

Paramètres clés

Max Results : le nombre maximal de factures renvoyées, que le nœud garde sous 100. Pour une période plus longue, découpe en plusieurs exécutions plutôt que de pousser ce chiffre.
Filters : restreint les factures remontées. Sans filtre, tu récupères ce que le site renvoie en premier, rarement l'ensemble que tu visais.

Cas d'usage

une exécution programmée sort les factures du mois qui se termine et les empile dans un tableur. La revue compta commence sur un fichier déjà rempli.

Get URL for the invoice PDF

invoice.pdfUrl

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie l'URL du PDF d'une facture. Ce lien transforme une notification de facturation en message réellement utile.

Paramètres clés

Invoice ID : l'identifiant de la facture voulue, obligatoire, donc une valeur vide bloque l'exécution du nœud. Il vient le plus souvent du nœud précédent, sous forme d'expression comme {{ $json.id }}, la syntaxe n8n pour lire un champ de l'élément entrant.

Cas d'usage

une relance de paiement qui porte le lien du document. Le client n'a pas à se connecter pour comprendre de quoi on lui parle.

Subscription

2 opérations

Cancel a subscription

subscription.cancel

Ce que tu vois dans n8n

Notes & cas d'usage

Résilie un abonnement, soit tout de suite, soit à la fin de la période en cours. Le choix entre les deux constitue l'essentiel de cette opération.

Paramètres clés

Subscription ID : obligatoire. Sans lui, l'appel à Chargebee n'a pas lieu.
Schedule End of Term : décoché, la résiliation s'applique directement. Coché, elle est programmée pour la fin de la période, ce qu'attend un client qui a déjà réglé son terme.

Cas d'usage

une demande de résiliation venue d'un outil de support, traitée avec l'option de fin de période, et le journal de churn écrit dans la même exécution.

Delete a subscription

subscription.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime l'abonnement de Chargebee au lieu d'en arrêter la facturation. Rien à voir, donc, avec l'opération de résiliation juste au-dessus.

Paramètres clés

Subscription ID : obligatoire, l'identifiant de l'abonnement à supprimer. Le nœud attend bien l'identifiant, pas le nom du client ni le libellé de l'offre : récupère-le depuis l'élément qui a déclenché le workflow.

Cas d'usage

un workflow de nettoyage qui reprend les abonnements nés d'un formulaire cassé et les supprime, en écrivant au passage dans un canal ce qui a été retiré, pour que la trace de l'opération survive à la suppression du compte.

Besoin d'aide

Besoin d'aide pour automatiser Chargebee avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Chargebee et n8n, les questions qui suivent

01L'intégration Chargebee n8n est-elle gratuite ?

Oui du côté de n8n : rien à installer, aucun module à acheter. Le nœud Chargebee et le Chargebee Trigger sont livrés avec n8n sans coût supplémentaire, aussi bien sur n8n Cloud, l'offre hébergée par n8n, que sur une instance auto-hébergée en Community Edition sous licence Sustainable Use, et un workflow s'y comporte de la même façon, donc tu peux prototyper d'un côté et déployer de l'autre. Ce que coûte ton compte Chargebee est une autre histoire, liée à ton contrat avec Chargebee : cette page ne traite pas ce point.

02Quels credentials faut-il pour Chargebee dans n8n ?

Une clé API, et c'est la seule méthode d'authentification acceptée. Le credential demande deux valeurs. Account Name, qui est le nom de ton site Chargebee, le sous-domaine seul : pour un site à l'adresse https://n8n.chargebee.com, l'Account Name vaut n8n. API Key, générée depuis Chargebee en suivant leur documentation sur la création d'une clé API. Le même credential authentifie le nœud Chargebee et le Chargebee Trigger. Une fois enregistré dans le menu Credentials, il apparaît dans la liste déroulante de chaque nœud, sans avoir à ressaisir quoi que ce soit.

03Quelles sont les limites du nœud Chargebee dans n8n ?

Deux points à garder en tête. Le nœud couvre 5 opérations réparties sur 3 ressources : créer un client, lister les factures, obtenir l'URL du PDF d'une facture, résilier un abonnement et supprimer un abonnement. Tout ce qui sort de ces opérations passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Chargebee en réutilisant le même credential via son authentification prédéfinie. Deuxième point, l'opération List garde Max Results sous 100 : pour une longue période, mieux vaut plusieurs exécutions filtrées qu'un seul gros appel.

04Le Chargebee Trigger réagit-il en temps réel ?

Oui. Le Chargebee Trigger fonctionne par webhook, c'est-à-dire une URL que Chargebee appelle au moment où l'événement se produit. Chaque événement arrive donc en quelques secondes, sans interrogation régulière de l'API. Cette URL, tu la déclares toi-même dans Chargebee, via Settings, puis Configure Chargebee, puis Webhooks et le bouton Add Webhook. Ensuite tu coches les événements voulus dans le paramètre Events du trigger, parmi les 34 disponibles, ou tu utilises le joker pour tous les recevoir. Le workflow doit être actif pour que le webhook l'atteigne.

05n8n ou Make pour Chargebee ?

Ça dépend de quatre critères, et le prix n'en est qu'un. L'hébergement d'abord : n8n tourne sur ton serveur ou sur n8n Cloud, alors que Make est hébergé uniquement, sans option d'auto-hébergement. La maîtrise des données suit, et elle pèse quand les workflows transportent des factures et des fiches clients. Le modèle de coût ensuite : Make facture à l'opération, ce qui monte vite sur un site Chargebee actif avec 34 types d'événements. La logique visuelle enfin : les deux offrent un canevas, et celui que ton équipe lit le plus vite est le bon.

Générer une clé API dans Chargebee

Créer le credential côté n8n

Déclarer l'URL du webhook dans Chargebee

Tous les événements, par famille

Notes de configuration

Besoin d'aide pour automatiser Chargebee avec n8n ?