Integración Stripe n8nAutomatiza Stripe con n8n.
Un cobro que entra en Stripe puede poner en marcha todo lo demás. La integración Stripe n8n abre 20 operaciones repartidas en 8 recursos, de los cobros a los clientes, de los cupones a las tarjetas y a los contadores de consumo. Su nodo disparador escucha 151 eventos agrupados en 39 familias.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué cubre de verdad la integración Stripe n8n?
La integración Stripe n8n son dos nodos que comparten un mismo credential, el acceso que guardas una sola vez en n8n. El nodo Stripe llama a la API de Stripe y expone 20 operaciones repartidas en 8 recursos: Balance, Charge, Coupon, Customer, Customer Card, Meter Event, Source y Token. El nodo Stripe Trigger registra un webhook, es decir una URL que Stripe llama en cada evento, y se suscribe a 151 eventos agrupados en 39 familias.
Empieza por el recibo devuelto. El trigger, el nodo que despierta el flujo, salta con invoice.payment_failed, la operación Get a customer recupera el nombre y el correo guardados en la ficha, y el aviso sale por Gmail con la referencia de la factura dentro. Ese mismo flujo se detiene con invoice.paid cuando el cliente paga esa misma tarde.
Sigue la contabilidad. Cada charge.succeeded se convierte en una fila de Google Sheets para la revisión semanal, y en un documento de Invoiceninja para quien cierra el mes. Get many charges con Return All activado es lo que hace ese cierre fiable: media lista de cobros rompe la conciliación sin dar ningún error.
Tercer terreno, la facturación por consumo. Create a meter event declara lo que ha gastado una cuenta, una llamada por unidad, con un Identifier que vuelve inofensiva una reejecución dentro de su ventana móvil de 24 horas. La factura que Stripe construye después vuelve a pasar por los mismos avisos.
El nodo termina donde terminan sus 8 recursos. Suscripciones, reembolsos, transferencias, payment intents y productos aparecen en el trigger como eventos y no tienen operación en el nodo. Cuando un flujo necesita escribir sobre ellos, el nodo HTTP Request llama al endpoint directamente y reutiliza el credential de Stripe con su autenticación predefinida, sin guardar ninguna clave nueva.
Hay dos límites que conviene mirar antes de montar nada. El modo de prueba y el modo real tienen cada uno su clave y sus objetos, así que un flujo validado con sk_test_ deja de encontrar nada en cuanto entra la clave real. Y las operaciones de lista solo recorren las páginas de la API si Return All está activado. Si todavía dudas de plataforma, la Reseña n8n la compara con Make en alojamiento y coste, y el Curso n8n repasa los patrones de flujo en los que se apoyan estos cobros.
¿Cómo se conecta Stripe con n8n?
- 01
Crear una clave secreta en Stripe
Abre el panel de desarrollador de Stripe y entra en API Keys. En la sección Standard Keys elige Create secret key, ponle un nombre que diga dónde se usa, por ejemplo
n8n integration, confirma y copia el valor que aparece. En modo de prueba el camino cambia: la clave secreta ya existe, la muestras con Reveal test key y la copias. Generar una clave pide una cuenta de Stripe de administrador o de desarrollador. - 02
Guardar la clave en un credential de n8n
En n8n, abre el menú Credentials, crea un credential de Stripe y pega el valor en Secret Key. Las claves secretas empiezan por
sk_,sk_live_en modo real ysk_test_en modo de prueba. Las claves publicables con prefijopk_no sirven aquí, y las restringidas con prefijork_no se han probado. Una vez guardado, aparece en la lista de los dos nodos de Stripe. - 03
Añadir el Signature Secret tras publicar
El Signature Secret solo existe cuando existe el endpoint. Publica el flujo montado sobre el Stripe Trigger: n8n crea un endpoint de webhook en la cuenta de Stripe. En el Dashboard de Stripe abre Workbench y luego Webhooks (Developers y luego Webhooks en paneles antiguos), localiza el endpoint descrito como Created by n8n for workflow ID, muestra el valor bajo Signing secret y pégalo en Signature Secret.
¿Qué escucha el Stripe Trigger?
Stripe Trigger es el nodo que arranca un workflow cuando algo ocurre en Stripe. Escucha 151 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Stripe 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.
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
El trigger también acepta * (cualquier evento). Útil para logs, peligroso en producción.
Notas de configuración
01Configure the Stripe Trigger
Este nodo lleva la parte de webhook de la integración. Publicas el flujo, n8n registra un endpoint en la cuenta de Stripe, y cada evento llega en unos segundos. Es Stripe quien llama a n8n, nunca al revés.
Parámetros clave
- Events: los eventos a los que se suscribe el endpoint, 151 en total repartidos en 39 familias. El comodín
*los coge todos, útil mientras inspeccionas el primer payload e inmanejable en producción. - API Version: opcional, fija el formato y la estructura de los payloads que envía Stripe. Vacío, Stripe aplica la versión de API predeterminada de la cuenta en ese momento, y un cambio posterior de ese valor puede mover el payload bajo un flujo que funcionaba perfectamente.
02invoice.*
Doce eventos siguen a una factura, de invoice.created a invoice.voided. Es la familia que hay que vigilar cuando el dinero pasa por una factura y no por un cobro directo.
invoice.payment_failed salta cuando un intento de pago sobre una factura falla, sea porque el pago se rechaza o porque no hay ningún método de pago guardado. invoice.paid llega cuando el intento sale bien, y también cuando la factura se marca como pagada fuera de Stripe. invoice.upcoming aparece unos días antes de que una suscripción facture, según los ajustes de suscripción, y su payload no lleva identificador de factura.invoice.paid y avisa al responsable de la cuenta mientras la siguiente factura todavía está por emitir.03charge.*
Trece eventos cuentan la vida de un cobro: charge.succeeded, charge.failed, charge.pending, charge.captured, charge.expired, charge.refunded y charge.updated, más cinco eventos de disputa y charge.refund.updated. Entre el cobro pendiente y el capturado, la familia también describe lo que aún no está liquidado.
charge.dispute.created llega cuando un cliente reclama un cobro a su banco, charge.dispute.funds_withdrawn cuando el dinero sale de la cuenta, charge.dispute.funds_reinstated cuando vuelve, y charge.dispute.closed trae el desenlace. Ojo con charge.refunded, que cubre también los reembolsos parciales: manda el importe, no el nombre del evento.charge.succeeded y un aviso aparte con charge.dispute.created, porque ese pide una persona el mismo día.04customer.*
Diecisiete eventos, la familia más grande del trigger, y varios objetos detrás: el cliente con created, deleted y updated, luego sus descuentos, sus fuentes de pago, sus suscripciones y sus identificadores fiscales.
customer.subscription.created marca un alta, customer.subscription.updated cubre un cambio de plan o el paso de la prueba a activo, customer.subscription.deleted el final, y customer.subscription.trial_will_end llega tres días antes de que termine una prueba. customer.source.expiring avisa de que una tarjeta o una fuente caduca a fin de mes.¿Qué sabe hacer el nodo Stripe ?
El nodo Stripe expone 20 operaciones en 8 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create | Get | Get Many | Update | Delete | Add | Remove |
|---|---|---|---|---|---|---|---|
| Balance | ✓ | ||||||
| Charge | ✓ | ✓ | ✓ | ✓ | |||
| Coupon | ✓ | ✓ | |||||
| Customer | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Customer Card | ✓ | ✓ | ✓ | ||||
| Meter Event | ✓ | ||||||
| Source | ✓ | ✓ | ✓ | ||||
| Token | ✓ |
Índice de operaciones
Balance
1 operaciónGet a balance
balance.getLo que ves en n8n
Notas y casos de uso
Leer el saldo de la cuenta es todo lo que hace esta operación. Devuelve lo que Stripe tiene ahora mismo, por un lado los fondos ya disponibles y por otro los que siguen pendientes. No hay ningún campo que rellenar: el nodo consulta la cuenta que hay detrás del credential elegido.
Charge
4 operacionesCreate a charge
charge.createLo que ves en n8n
Notas y casos de uso
Aquí se cobra a una fuente de pago ya asociada a un cliente. La operación crea el cobro y devuelve su estado.
Parámetros clave
- Customer ID: el cliente al que se asocia el cobro, casi siempre
{{ $json.id }}del nodo anterior. - Amount: el importe en céntimos, así que
100equivale a un dólar. - Currency Name or ID: un código ISO de tres letras,
USDoEUR, elegido en la lista o escrito como expresión. - Source ID: la fuente de pago del cliente que se carga.
Get a charge
charge.getLo que ves en n8n
Notas y casos de uso
Un cobro, por su identificador. El nodo devuelve el objeto completo, así que el flujo puede ramificar por el estado, el importe o los metadatos sin una segunda llamada.
Parámetros clave
- Charge ID: el identificador del cobro que se recupera, normalmente
{{ $json.id }}cuando un evento de cobro ha lanzado la ejecución.
Get many charges
charge.getAllLo que ves en n8n
Notas y casos de uso
Trae una lista de cobros en lugar de uno solo, con un elemento por cobro en la salida.
Parámetros clave
- Return All: activado, n8n recorre las páginas de la API de Stripe hasta el último cobro de la cuenta.
- Limit: solo se lee con Return All desactivado, y pone el techo de cobros por ejecución.
Update a charge
charge.updateLo que ves en n8n
Notas y casos de uso
Editar un cobro a posteriori es estrecho a propósito. Bajo Update Fields hay cuatro campos, Description, Metadata, Receipt Email y Shipping, y nada más se mueve.
Parámetros clave
- Charge ID: el cobro que se actualiza.
- Metadata: pares de clave y valor pegados al cobro, añadidos de uno en uno con Add Metadata Item.
Coupon
2 operacionesCreate a coupon
coupon.createLo que ves en n8n
Notas y casos de uso
Un descuento definido en Stripe y no en tu propio código. La operación crea el cupón y lo devuelve, listo para asociarlo a un cliente.
Parámetros clave
- Apply: cuánto dura el descuento, Forever u Once.
- Discount Type: Percent, o Fixed Amount (in Cents).
- Amount Off: el importe en céntimos que se resta del total de una factura.
- Percent Off: el porcentaje que aplica el cupón.
- Currency Name or ID: el código ISO de tres letras en el que se expresa el importe.
Get many coupons
coupon.getAllLo que ves en n8n
Notas y casos de uso
Lista los cupones que existen en la cuenta, la vía más rápida para ver qué sigue vivo antes de crear otro más.
Parámetros clave
- Return All: activado, el nodo sigue pidiendo páginas hasta sacar la lista entera.
- Limit: con Return All desactivado, es quien limita cuántos cupones vuelven.
Customer
5 operacionesCreate a customer
customer.createLo que ves en n8n
Notas y casos de uso
La ficha de cliente ancla casi todo lo demás en Stripe: tarjetas, fuentes, cobros y facturas cuelgan de ella. Esta operación la crea y devuelve el identificador nuevo.
Parámetros clave
- Name: el único campo obligatorio, nombre completo o razón social.
- Email: opcional en el nodo, rara vez opcional en la práctica, porque los recibos y los correos de factura salen ahí. Está en Additional Fields, junto a Address, Phone, Description, Metadata y Shipping.
Delete a customer
customer.deleteLo que ves en n8n
Notas y casos de uso
Borra un cliente de la cuenta de Stripe. Un identificador y ninguna opción, lo que hace esta operación tan fácil de montar como de disparar sin querer.
Parámetros clave
- Customer ID: el cliente que se borra. Conviene poner un filtro o una validación manual antes, porque n8n ejecuta el nodo en cuanto le llega un elemento.
Get a customer
customer.getLo que ves en n8n
Notas y casos de uso
Va a buscar un cliente y devuelve la ficha tal como está guardada: el nombre, el correo si se rellenó, la dirección, los metadatos.
Parámetros clave
- Customer ID: el identificador del cliente que se recupera, leído casi siempre del elemento entrante con
{{ $json.id }}.
Get many customers
customer.getAllLo que ves en n8n
Notas y casos de uso
Recorre la lista de clientes en vez de una ficha, y sabe reducirla antes de que vuelva nada.
Parámetros clave
- Email: está bajo Filters y pide a Stripe los clientes con esa dirección, lo más parecido a una búsqueda por correo que ofrece el nodo.
- Return All: activado, el nodo recorre la lista completa; desactivado, Limit decide cuántos llegan.
Update a customer
customer.updateLo que ves en n8n
Notas y casos de uso
Cambia lo que Stripe guarda de un cliente. Hay siete campos bajo Update Fields, Address, Description, Email, Metadata, Name, Phone y Shipping, y solo se tocan los que añades.
Parámetros clave
- Customer ID: el cliente que se actualiza.
- Email: la dirección que Stripe usa para recibos y correos de factura, conviene empujarla el día que cambia en tu propia base.
Customer Card
3 operacionesAdd a customer card
customerCard.addLo que ves en n8n
Notas y casos de uso
Asocia una tarjeta a un cliente que ya existe. Los datos de la tarjeta no viajan en claro por aquí: la operación espera un token que ya los representa.
Parámetros clave
- Customer ID: el cliente al que se asocia la tarjeta.
- Card Token: el token que representa la información sensible de la tarjeta, una cadena
tok_creada por la operación Create a token o por tu propio proceso de pago.
Get a customer card
customerCard.getLo que ves en n8n
Notas y casos de uso
Relee una tarjeta concreta de un cliente concreto. Hacen falta dos identificadores, porque un cliente puede tener varias.
Parámetros clave
- Customer ID: el cliente cuya tarjeta se lee.
- Source ID: la fuente que se recupera, es decir el identificador de la tarjeta en ese cliente.
customer.source.expiring, antes de cargar nada sobre ella.Remove a customer card
customerCard.removeLo que ves en n8n
Notas y casos de uso
Desasocia una tarjeta de un cliente. Fíjate en el nombre del campo: esta operación pide un Card ID donde la lectura pide un Source ID.
Parámetros clave
- Customer ID: el cliente dueño de la tarjeta.
- Card ID: la tarjeta que se retira.
Meter Event
1 operaciónCreate a meter event
meterEvent.createLo que ves en n8n
Notas y casos de uso
La facturación por consumo necesita un contador y esta operación lo alimenta: cada llamada declara una unidad consumida, para un cliente y un contador.
Parámetros clave
- Event Name: coincide con el campo event_name del contador creado en Stripe.
- Customer ID: el cliente al que se imputa el consumo.
- Value: un entero, positivo o negativo.
- Identifier: opcional y muy útil: la unicidad se controla en una ventana móvil de 24 horas, lo que impide que una reejecución cuente dos veces.
- Timestamp: el momento del evento, dentro de los últimos 35 días o hasta 5 minutos en el futuro.
Source
3 operacionesCreate a source
source.createLo que ves en n8n
Notas y casos de uso
Construye una fuente de pago y la asocia a un cliente. En el nodo, Type ofrece un solo valor, WeChat, así que esta es la operación de ese método de pago y no una genérica.
Parámetros clave
- Customer ID: el cliente al que se asocia la fuente.
- Type: WeChat, la única entrada de la lista.
- Amount y Currency Name or ID: no obligatorios en el nodo, llevan el importe en céntimos y el código ISO cuando la fuente carga uno.
source.chargeable antes de cobrar.Delete a source
source.deleteLo que ves en n8n
Notas y casos de uso
Quita una fuente de un cliente, con la misma pareja de identificadores que usa la lectura. No hay nada más que configurar, así que el freno tiene que vivir más arriba en el flujo.
Parámetros clave
- Customer ID: el cliente cuya fuente desaparece.
- Source ID: la fuente que se borra.
source.canceled o source.failed, para que la ficha deje de ofrecer un método de pago muerto.Get a source
source.getLo que ves en n8n
Notas y casos de uso
Devuelve una fuente por sí sola, sin nombrar a ningún cliente. Solo pide el identificador de la fuente, lo que la convierte en el camino más corto para inspeccionar el objeto que hay detrás de un evento de fuente.
Parámetros clave
- Source ID: el identificador de la fuente que se recupera.
source.chargeable relee la fuente para confirmar su estado y decide si el cobro puede salir.Token
1 operaciónCreate a token
token.createLo que ves en n8n
Notas y casos de uso
Convierte los datos de una tarjeta en un token, para no guardar nunca la tarjeta de tu lado. Ese token es justo lo que espera después Add a customer card.
Parámetros clave
- Type: la lista tiene una sola entrada, Card Token.
- Card Number, CVC, Expiration Month y Expiration Year: los campos de la tarjeta, ninguno obligatorio en el nodo, rellenados desde donde se hayan recogido. Los placeholders enseñan la forma esperada,
4242424242424242para el número y314para el código impreso al dorso.
¿Necesitas ayuda para automatizar Stripe con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.


