Recursos · Integración n8n

Integración Chargebee n8nAutomatiza Chargebee con n8n.

La facturación ya funciona sola, pero los avisos siguen saliendo a mano. La integración Chargebee n8n aporta un nodo con 5 operaciones sobre clientes, facturas y suscripciones, y un trigger que recibe 34 eventos de Chargebee por webhook. Pensada para equipos de operaciones y finanzas que ya usan n8n.

Probar la integración Chargebee en n8nVer las 5 operaciones

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

Por qué automatizar

¿Qué resuelve la integración Chargebee n8n?

Chargebee lleva las suscripciones, las facturas y los cobros recurrentes. n8n mueve esa información hacia las herramientas donde trabaja tu equipo. La integración se apoya en dos piezas. El Chargebee Trigger arranca un flujo de trabajo en cuanto ocurre algo en tu sitio de Chargebee. El nodo Chargebee ejecuta 5 operaciones repartidas en 3 recursos cuando hace falta leer o escribir datos de vuelta.

El cierre de mes es el punto de partida más habitual. La operación invoice.list devuelve las facturas del sitio, un filtro las acota al periodo que toca, y las líneas se acumulan en Google Sheets o siguen camino hacia ERPNext si la contabilidad vive ahí. Cuando alguien pide el detalle de una factura concreta, invoice.pdfUrl devuelve el enlace al PDF y el mensaje sale con el documento dentro.

Hay otro frente más ruidoso: los cobros. payment_failed se dispara cuando el intento de cargo contra la tarjeta no prospera, y ese aviso en un canal de Slack llega en segundos, con tiempo para reaccionar antes de que el cliente lo note. En la misma familia entran payment_succeeded, payment_refunded y los dos eventos de domiciliación, payment_initiated y refund_initiated.

Queda la parte de ciclo de vida, que es donde más se nota el trabajo manual. subscription_renewal_reminder avisa 3 días antes de la renovación y subscription_trial_ending lo hace 6 días antes de que termine la prueba. Con ese margen cabe un correo por Gmail, una tarea para quien lleva la cuenta, o una baja ordenada mediante subscription.cancel con la opción de fin de periodo activada. Y si el alta llega desde fuera, customer.create la escribe directamente en Chargebee.

¿Y lo que no está entre esas 5 operaciones del catálogo? Se resuelve con el nodo HTTP Request, que llama a cualquier endpoint de la API de Chargebee reutilizando el mismo credential mediante su autenticación predefinida. Un credential son las credenciales guardadas una sola vez en n8n, así que no aparece ninguna clave nueva que administrar.

Merece la pena entender el reparto antes de dibujar nada: el trigger es la mitad ancha de esta integración, con sus 34 eventos, y el nodo es la mitad concreta, con 5 operaciones muy definidas. Casi todos los flujos empiezan por el trigger y terminan en otra herramienta. La Reseña n8n entra en ese equilibrio con más detalle.

Conexión

¿Cómo conectar Chargebee con n8n?

  1. 01

    Genera una clave API en Chargebee

    Lo primero es tener una cuenta de Chargebee. Dentro de ella, genera una clave API siguiendo la documentación de Chargebee sobre creación de claves API. Es el único método de autenticación admitido en esta integración y sirve tanto para el nodo Chargebee como para el Chargebee Trigger. Copia la clave antes de salir de esa pantalla, porque la necesitas en el paso siguiente.

  2. 02

    Crea el credential en n8n

    Entra en el menú Credentials de n8n y añade un credential de Chargebee. Pide dos datos. Account Name es el nombre de tu sitio de Chargebee, solo el subdominio: si tu sitio es https://n8n.chargebee.com, el Account Name es n8n. API Key recibe la clave que acabas de generar. Guardado una vez, ese credential aparece en el desplegable de cualquier nodo Chargebee de cualquier flujo.

  3. 03

    Declara la URL del webhook en Chargebee

    El trigger necesita que Chargebee le hable. En tu panel de Chargebee, abre Settings, luego Configure Chargebee, baja hasta Webhooks y pulsa Add Webhook. Rellena el Webhook Name, pega el Webhook URL que muestra el nodo trigger en n8n y confirma con Create. Un webhook no es más que una URL a la que Chargebee llama justo cuando pasa algo, y por eso los eventos llegan en segundos sin consultar la API cada tanto.

Disparadores

¿Qué arranca un flujo desde Chargebee ?

Chargebee Trigger es el nodo que arranca un workflow cuando algo ocurre en Chargebee. Escucha 34 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Chargebee llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

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

El trigger también acepta * (cualquier evento). Útil para logs, peligroso en producción.

Notas de configuración

01Set up the Chargebee TriggerEl Chargebee Trigger (versión 1) arranca el flujo en cuanto ocurre un evento. De todo lo que se puede tocar en este nodo, solo un ajuste importa de verdad: la lista de eventos que va a escuchar.

El Chargebee Trigger (versión 1) arranca el flujo en cuanto ocurre un evento. De todo lo que se puede tocar en este nodo, solo un ajuste importa de verdad: la lista de eventos que va a escuchar.

Parámetros clave

  • Events: la lista de eventos a los que responde este flujo. Están los 34, agrupados por el objeto al que pertenecen, y marcas los que necesites.
  • Events con el valor *: el comodín, todos los eventos que envía Chargebee. Va bien para un flujo único que clasifica después, y va peor cuando el lienzo tiene que entenderse de un vistazo.
Cuándo usarlo
marca eventos concretos siempre que al final de la cadena haya un mensaje al cliente, porque una rama equivocada se ve enseguida. Reserva el comodín para flujos de registro y para la fase de observación, cuando todavía quieres saber qué emite tu sitio de Chargebee en una semana normal.
02React to subscription eventsLas suscripciones acaparan la mayor parte de los 34 eventos, algo lógico en una plataforma de facturación recurrente.

Las suscripciones acaparan la mayor parte de los 34 eventos, algo lógico en una plataforma de facturación recurrente.

Parámetros clave

  • Events, cambios de estado: subscription_created, subscription_started cuando arranca una suscripción futura, subscription_activated tras pasar de prueba a activa, subscription_changed en los elementos recurrentes, subscription_renewed, subscription_reactivated, subscription_deleted y subscription_shipping_address_updated.
  • Events, la baja: subscription_cancellation_scheduled cuando se programa para el final del periodo, subscription_cancelling 6 días antes de la fecha prevista, subscription_cancelled y subscription_scheduled_cancellation_removed si alguien da marcha atrás.
  • Events, los dos avisos anticipados: subscription_trial_ending 6 días antes del final de la prueba y subscription_renewal_reminder 3 días antes de la renovación.
Casos de uso
un flujo de retención enganchado a la baja programada y no a la baja consumada, para hablar con el cliente mientras la suscripción sigue viva.
03React to invoice and payment eventsEl dinero ocupa la otra mitad del mapa: 4 eventos de factura y 5 repartidos entre pagos y devoluciones.

El dinero ocupa la otra mitad del mapa: 4 eventos de factura y 5 repartidos entre pagos y devoluciones.

Parámetros clave

  • Events, facturas: invoice_generated al generarse una factura nueva, invoice_updated cuando cambia la dirección de facturación o de envío, cuando la factura se anula, o cuando el importe pendiente varía porque se aplicó o se retiró un pago, además de invoice_created e invoice_deleted.
  • Events, pagos: payment_succeeded al cobrarse, payment_failed cuando falla el intento de cargo a la tarjeta, payment_initiated en un pago por domiciliación, payment_refunded y refund_initiated para una devolución iniciada por domiciliación.
Cuándo usarlo
ojo con invoice_created, que solo aparece en facturación por consumo, sobre una factura pendiente a la que aún faltan cargos, y únicamente con la opción Notify for Pending Invoices activada. Para el día a día, el evento correcto es invoice_generated.
04React to card eventsLas tarjetas suman 5 eventos. Son los más silenciosos de la lista y, mirando el resultado, de los más agradecidos.

Las tarjetas suman 5 eventos. Son los más silenciosos de la lista y, mirando el resultado, de los más agradecidos.

Parámetros clave

  • Events, el aviso adelantado: card_expiring salta 30 días antes de la fecha de caducidad de la tarjeta del cliente.
  • Events, lo ya consumado: card_expired una vez pasada esa fecha, y card_deleted cuando se elimina una tarjeta de un cliente.
  • Events, el seguimiento normal: card_added y card_updated, cómodos para confirmar al cliente que su tarjeta nueva quedó registrada.
Casos de uso
una secuencia de recordatorio que nace con card_expiring y se corta en cuanto llega card_updated del mismo cliente. Con esos 30 días de margen el cobro fallido se evita antes de existir, y el flujo no necesita ninguna operación del nodo Chargebee, solo el trigger y la herramienta de envío que venga detrás.
05React to customer and transaction eventsCierran la cuenta dos grupos pequeños: 3 eventos sobre la ficha de cliente y 3 sobre transacciones.

Cierran la cuenta dos grupos pequeños: 3 eventos sobre la ficha de cliente y 3 sobre transacciones.

Parámetros clave

  • Events, clientes: customer_created, customer_changed ante cualquier modificación de la ficha y customer_deleted. Son los que conviene replicar en un CRM para que facturación y ventas manejen los mismos nombres.
  • Events, transacciones: transaction_created cuando se registra una transacción, transaction_deleted y transaction_updated, que cubre también la retirada de una transacción, un exceso de pago aplicado sobre una factura o un cambio en el importe capturable.
Casos de uso
para llevar un libro de movimientos al día, los eventos de transacción rinden más que los de factura, porque cuentan lo que le pasó de verdad al dinero y no lo que se facturó sobre el papel.
Acciones

¿Qué sabe hacer el nodo Chargebee ?

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

Matriz recursos × operaciones
RecursoCreateDeleteCancelListPDF Invoice URL
Customer✓
Invoice✓✓
Subscription✓✓

Customer

1 operación
01

Create a customer

customer.create

Lo que ves en n8n

Notas y casos de uso

Da de alta un cliente en Chargebee y devuelve la ficha creada al flujo, así un registro captado fuera entra en facturación sin copiarlo a mano.

Parámetros clave

  • Email: la dirección de correo del cliente, tomada del elemento que arrancó la ejecución.
  • User ID: tu propio identificador para ese cliente. Si lo dejas vacío, Chargebee genera uno.
  • First Name, Last Name, Phone y Company: los datos nominativos que salen en las facturas y en el listado de clientes.
  • Custom Properties: añade una propiedad que no está entre las predefinidas, como un código de plan o la persona responsable de la cuenta.
Casos de uso
un formulario de alta crea la ficha y esa misma ejecución avisa al equipo.

Invoice

2 operaciones
02

List an invoice

invoice.list

Lo que ves en n8n

Notas y casos de uso

Trae las facturas del sitio de Chargebee como items que los nodos siguientes pueden tratar. Es la pieza que sustituye al export mensual hecho a mano.

Parámetros clave

  • Max Results: cuántas facturas vuelven, con el tope por debajo de 100 que fija el nodo. Para un periodo largo, reparte en varias ejecuciones en vez de forzar esa cifra.
  • Filters: acota qué facturas se devuelven. Sin filtro recibes lo primero que entrega el sitio, que casi nunca es el conjunto que buscabas.
Casos de uso
una ejecución programada saca las facturas del mes que cierra y las apila en una hoja de cálculo. La revisión contable empieza con el fichero ya montado.
03

Get URL for the invoice PDF

invoice.pdfUrl

Lo que ves en n8n

Notas y casos de uso

Devuelve la URL del PDF de una factura. Ese enlace es lo que convierte un aviso de facturación en un mensaje que el cliente puede usar.

Parámetros clave

  • Invoice ID: el identificador de la factura que quieres, obligatorio, así que un valor vacío detiene el nodo. Suele venir del nodo anterior en forma de expresión, como {{ $json.id }}, la sintaxis de n8n para leer un campo del item entrante.
Casos de uso
un recordatorio de pago que lleva el enlace del documento, para que nadie tenga que entrar en su cuenta a averiguar de qué factura se habla.

Subscription

2 operaciones
04

Cancel a subscription

subscription.cancel

Lo que ves en n8n

Notas y casos de uso

Cancela una suscripción, ya sea en el acto o al terminar el periodo en curso. Elegir entre esas dos formas es prácticamente toda la operación.

Parámetros clave

  • Subscription ID: obligatorio, el identificador de la suscripción que se cancela. Vacío, detiene el nodo antes de llamar a Chargebee.
  • Schedule End of Term: desmarcado, la cancelación se aplica directamente. Marcado, queda programada para el final del periodo, que es lo que espera quien ya pagó ese tramo.
Casos de uso
una solicitud de baja recibida en la herramienta de soporte se procesa con la opción de fin de periodo, y el registro de churn se escribe en la misma ejecución.
05

Delete a subscription

subscription.delete

Lo que ves en n8n

Notas y casos de uso

Elimina la suscripción de Chargebee en lugar de cerrar su facturación. Es otra cosa distinta de cancelar, aunque las dos operaciones se parezcan en el formulario.

Parámetros clave

  • Subscription ID: obligatorio, el identificador de la suscripción que se elimina. El nodo espera el identificador, no el nombre del cliente ni la etiqueta del plan, así que tómalo del elemento que disparó el flujo.
Casos de uso
un flujo de limpieza que recoge las suscripciones nacidas de un formulario roto y las borra, dejando constancia en un canal de lo que se ha quitado. El rastro sobrevive al borrado.
Necesitas ayuda

¿Necesitas ayuda para automatizar Chargebee con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Chargebee y n8n, las dudas que llegan después

01¿La integración Chargebee n8n es gratis?
Sí por el lado de n8n. El nodo Chargebee y el Chargebee Trigger vienen incluidos con n8n, así que no hay nada que instalar ni ningún módulo que comprar, y no supone coste adicional en n8n. Vale igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un flujo se comporta igual en los dos sitios, de modo que puedes probar en uno y llevarlo al otro. Lo que cueste tu cuenta de Chargebee es otro asunto y depende de tu contrato con ellos.
02¿Qué credentials hacen falta para Chargebee en n8n?
Una clave API, y es el único método de autenticación admitido. El credential pide dos valores. Account Name es el nombre de tu sitio de Chargebee, solo el subdominio: para un sitio en https://n8n.chargebee.com, el Account Name es n8n. API Key es la clave que generas desde Chargebee siguiendo su documentación sobre creación de claves API. El mismo credential autentica el nodo Chargebee y el Chargebee Trigger. Una vez guardado en el menú Credentials, aparece en el desplegable de cada nodo y no hay que volver a escribirlo en ningún flujo.
03¿Qué límites tiene el nodo Chargebee en n8n?
Dos cosas conviene tener presentes. El nodo cubre 5 operaciones repartidas en 3 recursos: crear un cliente, listar facturas, obtener la URL del PDF de una factura, cancelar una suscripción y eliminar una suscripción. Todo lo que quede fuera de esas operaciones se resuelve con el nodo HTTP Request, que llama a cualquier endpoint de la API de Chargebee reutilizando el mismo credential mediante su autenticación predefinida. Y la operación List mantiene Max Results por debajo de 100, así que un periodo largo se cubre mejor con varias ejecuciones filtradas que con una sola llamada.
04¿El Chargebee Trigger funciona en tiempo real?
Sí. El Chargebee Trigger funciona por webhook, es decir, una URL a la que Chargebee llama en el momento en que sucede el evento, así que cada aviso llega a n8n en segundos y no hay ninguna consulta periódica a la API. Esa URL la declaras tú en Chargebee, entrando en Settings, después Configure Chargebee, después Webhooks y el botón Add Webhook. A partir de ahí marcas los eventos que te interesan en el parámetro Events del trigger, entre los 34 disponibles, o usas el comodín para recibirlos todos. El flujo tiene que estar activo.
05¿n8n o Make para Chargebee?
Depende de cuatro criterios y el precio es solo uno. Alojamiento: n8n corre en tu servidor o en n8n Cloud, mientras que Make es únicamente alojado, sin opción de autoalojamiento. De ahí sale el control de los datos, que pesa cuando los flujos transportan facturas y fichas de clientes. Modelo de coste: Make factura por operación, algo que se nota en un sitio de Chargebee movido, con 34 tipos de evento sobre la mesa. Lógica visual: los dos ofrecen un lienzo, y el bueno es el que tu equipo lee más rápido. Prueba el mismo flujo en ambos.
Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones