Diferencias

Webhook y API: la diferencia

Con una API, tu programa pide datos o acciones a otro servicio; con un webhook, ese servicio avisa a tu programa cuando ocurre algo.

Por

Director de Ciade · 9 min de lectura ·

Foto: Vitaly Gariev / Unsplash · tratamiento Ciade · Licencia de Unsplash
Índice del artículo
  1. En 30 segundos
  2. Una tienda, dos necesidades
  3. Elige según la necesidad
  4. Del pago al almacén
  5. El error típico: dar el pedido por resuelto
  6. Dos controles que no debes confundir
  7. Opciones y precios en España
  8. Prueba la conexión entre pagos y almacén
  9. Por dónde seguir
  10. Dudas sobre webhook y API, respuestas cortas

En 30 segundos

  1. Con una API, tu programa pide datos o acciones a otro servicio; con un webhook, ese servicio avisa a tu programa cuando ocurre algo.

  2. Pueden trabajar juntos: el aviso inicia la tramitación de una compra y la consulta permite comprobar su estado antes de prepararla.

Una tienda, dos necesidades

Imagina una tienda de material de oficina en Valladolid. Un cliente pregunta si su pago sigue pendiente: el equipo necesita consultarlo ahora. Más tarde se confirma otra compra y el almacén necesita enterarse para prepararla. En este ejemplo, Stripe es el servicio de pagos. Es un ejemplo ilustrativo, no un caso de cliente.

Una API es una interfaz: una forma acordada de que dos programas se pidan datos o acciones. Un webhook es un aviso entre programas cuando sucede un hecho, como un cambio en un pago. La diferencia práctica está en quién inicia la comunicación. Aquí comparamos la consulta habitual por API con la recepción de avisos; un webhook también envía una petición a la dirección del receptor. Piensa en consultar en la ventanilla de un almacén frente a dejar un teléfono para que avisen de una llegada. La comparación ayuda a distinguir las necesidades; no significa que el aviso siempre llegue al instante ni describe todos los tipos de API.

Consultar o recibir un aviso

Quién empieza

API: El programa que necesita el dato o la acción.

Webhook: El servicio donde ocurre el hecho.

Cuándo

API: Cuando lo pide tu programa, puntualmente o según una programación.

Webhook: Cuando ocurre uno de los eventos elegidos para recibir avisos.

Qué devuelve

API: La respuesta de la operación solicitada, dentro de los permisos concedidos.

Webhook: Datos del evento. Puede hacer falta consultar después por API.

Qué preparar

API: Acceso a la operación, credenciales —claves u otros datos de acceso— si se exigen y tratamiento de errores.

Webhook: Una dirección receptora accesible, selección de eventos y comprobación del remitente.

Elige según la necesidad

API: saberlo ahora

Para responder al cliente, consulta el estado del pago que ya existe. Recuperar sus detalles no equivale a crear otro cobro.

Webhook: reaccionar

Si el hecho ocurre en otro servicio, busca su aviso disponible. Si no ofrece ese evento, estudia una consulta periódica u otra integración admitida.

Ambos: completar

Si el aviso no trae todos los datos, consulta lo que falta. No elijas una herramienta hasta saber qué información recibe y qué operación puede pedir después.

Del pago al almacén

  1. Stripe avisa
  2. Valida y registra
  3. Consulta por API
  4. Comprueba pedido
  5. Prepara orden
  6. Almacén revisa

El error típico: dar el pedido por resuelto

Configura el circuito para que el programa consulte por API el registro de la compra en Stripe y contraste el pago con el pedido. Si sigue pendiente, conserva el trabajo por resolver; si ya se tramitó, no crea otra orden, aunque lleguen avisos simultáneos. Registra por separado recepción, tramitación e incidencias. No dependas de que el comprador vuelva a la web: puede pagar y no llegar a ella. Los medios de pago con confirmación diferida requieren atender sus cambios posteriores.

Al probar la conexión entre pagos y almacén, pide que se autorice el envío tras revisar pedido, dirección y artículos. Administración resuelve discrepancias y decide las devoluciones. El texto del aviso no debe servir para volver a cobrar ni cambiar el destinatario. Con poco volumen, Stripe también contempla tramitar los pedidos manualmente.

Dos controles que no debes confundir

La clave de API permite pedir operaciones con los permisos concedidos. La firma del webhook sirve para comprobar quién envía el aviso: en Stripe se valida con el secreto del receptor, un dato privado para verificar la firma, y el contenido original del mensaje, sin reconstruirlo. Son controles distintos. Guardar una clave no demuestra que el aviso sea auténtico. Limita los permisos a las operaciones necesarias y conserva las claves secretas fuera del código público y del navegador. Si usas n8n, configurar los controles de acceso al receptor no demuestra por sí solo que esté validando la firma de Stripe. El paso HTTP Request de n8n permite configurar la operación, sus parámetros y autenticación según el servicio. Cuando existen credenciales predefinidas, su documentación recomienda utilizarlas. Que la aplicación tenga una API no significa que cualquier clave permita leer todos los datos ni realizar todas las operaciones. Al consultar, también hay que interpretar los errores de la respuesta según la documentación de la operación. Acuerda qué hará el programa si no obtiene el dato necesario: no debe continuar como si la consulta hubiera confirmado el pago.

Opciones y precios en España

Cumplen funciones distintas: Stripe gestiona los pagos; n8n puede organizar la recepción y las consultas. Cloud y Community son alternativas entre sí. Puedes prescindir de n8n si tu aplicación ya tiene un receptor adecuado.

Datos comprobados el 4 de noviembre de 2026.

Stripe

Stripe

ComercialDisponible con requisitos
Papel
API para consultar pagos y webhooks para recibir sus eventos. La aplicación receptora relaciona cada compra con el pedido y conserva su tramitación.
Precio y alcance y límite concreto

España figura entre los países admitidos. El alta depende de la actividad y de las restricciones aplicables.

Precio y alcance
Estándar: 1,5 % + 0,25 € por pago con tarjeta estándar del Espacio Económico Europeo. Sin cuota mensual ni de configuración. Es comisión de cobro, no precio por aviso. Stripe no repercute IVA sobre estas comisiones a cuentas españolas; pueden existir obligaciones de autoliquidación.
Límite concreto
Confirma que tu actividad está admitida y que la comisión indicada corresponde a las tarjetas de tus clientes.

n8n Cloud

n8n

ComercialDisponible
Papel
Servicio en la nube gestionada, donde el proveedor administra el servidor. Su paso Webhook recibe datos; HTTP Request permite consultar una API con sus credenciales.
Precio y alcance y límite concreto

El acceso desde España se deduce de las condiciones de n8n y la cobertura de Paddle, su vendedor, que admite ventas españolas en euros.

Precio y alcance
Starter: 20 €/mes equivalentes con pago anual, sin IVA; 2.500 ejecuciones al mes. Una ejecución es una pasada del proceso completo, no cada paso ni cada consulta. El año se paga por adelantado; continuar después de la prueba requiere suscripción.
Límite concreto
Comprueba el volumen de ejecuciones y que el flujo publicado utiliza la dirección de producción, distinta de la dirección de prueba.

n8n Community

n8n

MixtoDisponible con requisitos
Papel
Edición para instalar en tu servidor. Además de las conexiones, tú o tu proveedor mantenéis alojamiento, copias, actualizaciones y funcionamiento.
Precio y alcance y límite concreto

La licencia mundial permite instalarlo en España dentro de sus condiciones. El código disponible tiene restricciones comerciales.

Precio y alcance
0 € de licencia para el uso interno permitido. Infraestructura y trabajo aparte, con la fiscalidad de los servicios que contrates. No equivale a un coste total nulo.
Límite concreto
La Sustainable Use License no permite ofrecer acceso para que clientes externos creen sus propios flujos sin la licencia correspondiente.

Referencias del 4 de noviembre de 2026. Confirma el importe final y su fiscalidad al contratar.

Prueba la conexión entre pagos y almacén

Comprueba el resultado del pedido. Prueba una compra confirmada y otra pendiente: solo la primera debe avanzar hacia la preparación. Repite el aviso y haz llegar el mismo pedido simultáneamente por dos llamadas. El resultado esperado es una única orden interna, no dos órdenes que después deba corregir el almacén. Pide que te enseñen el estado final y el registro de tramitación; ver una notificación en pantalla no basta para decidir que el circuito está listo. Para Stripe existen entornos de prueba que permiten ensayar sin afectar datos reales ni redes bancarias. Acuerda con quien haga el montaje qué pruebas se ejecutarán ahí y qué evidencia entregará.

Por dónde seguir

Si necesitas ampliar un concepto, consulta qué es un webhook, qué es una API y qué es una clave de API. Para pasar del esquema al montaje, sigue con webhooks en la práctica. Empieza por tu operación concreta: qué hecho quieres detectar y qué debe ocurrir después.

Si buscas ayuda para conectar los programas de tu empresa, consulta las automatizaciones de Ciade. Lleva un pedido de ejemplo, el programa que utilizas y la persona que lo revisará. La compatibilidad con tu almacén depende de las operaciones, permisos y plan disponibles; no se deduce de que la herramienta tenga una API.

Dudas sobre webhook y API, respuestas cortas

¿Un webhook es otra llamada a una API?

Un webhook también envía una petición a la dirección del receptor. La diferencia práctica está en quién empieza: en una consulta, tu programa pide datos; con el webhook, el servicio envía el aviso cuando ocurre el evento elegido. No son mecanismos incompatibles ni tienes que escoger solo uno.

¿Tengo que consultar por API si ya recibo webhooks?

Puede hacer falta. El aviso contiene datos del evento, pero la aplicación puede necesitar consultar después el estado de la compra o recuperar información que falta. Stripe combina ambos mecanismos para tramitar pedidos: recibir el aviso no sustituye comprobar el pago y registrar la tramitación.

¿Por qué puede aparecer dos veces el mismo pedido?

Stripe puede enviar eventos duplicados y no garantiza su orden de llegada. Si cada recepción crea una orden nueva, puedes repetir la preparación del pedido. El proceso debe reconocer lo ya tramitado y evitar repetir sus efectos, incluso cuando llegan varias llamadas simultáneas para la misma compra.

¿Qué plazos ofrece Stripe para recuperar un aviso fallido?

En modo real, Stripe reintenta las entregas fallidas durante hasta 3 días. Para solicitar un reenvío manual, permite hacerlo hasta 15 días después desde el panel y hasta 30 días mediante su herramienta de comandos. Son plazos de Stripe: no los des por válidos para otros proveedores.

Fuentes

Fuentes oficiales, consultadas el 4 de noviembre de 2026

  1. GitHub — About webhooks
  2. Stripe — Authentication
  3. Stripe — Retrieve a PaymentIntent
  4. Stripe — Receive Stripe events in your webhook endpoint
  5. Stripe — Fulfill orders, Full page
  6. GitHub — Handling failed webhook deliveries
  7. Stripe — Disponibilidad global
  8. Stripe — Empresas restringidas y prohibidas
  9. Stripe — Tarifas y comisiones, España
  10. Stripe — Tributación global de las comisiones
  11. n8n — Webhook node
  12. n8n — HTTP Request node
  13. n8n — Plans and Pricing
  14. n8n — Self-Serve Terms
  15. n8n — Community License FAQ
  16. n8n — Sustainable Use License
  17. n8n — How do I get a refund for incorrectly charged VAT?
  18. Paddle — Supported countries
  19. Paddle — Which countries are supported by Paddle?
  20. Stripe — API Reference

Cómo lo comprobamos. Documentación oficial, precios y condiciones consultados el 4 de noviembre de 2026. No hemos probado este circuito en cuentas reales ni medido sus resultados o ahorro.

Qué ha cambiado.

  • 4 de noviembre de 2026: Reescrito con comparación visual, ejemplo de Valladolid, precios españoles y controles de origen, duplicados y recuperación.

Términos relacionados

Aprende a usar la IA en tu trabajo, con criterio.

El nivel 0 es gratis: cuarenta minutos para entender qué pedirle a la IA y qué revisar. El programa completo enseña a implementarla en tu propio negocio, tarea a tarea.

El canal de Telegram de Ciade

El lunes, una palabra del glosario. El miércoles, un consejo práctico. El viernes, las noticias de IA de la semana. Y el martes, el boletín.

Unirme al canal

Tú decides qué medimos

Las cookies técnicas hacen que la web funcione. Con tu permiso, además, medimos las visitas con Ahrefs y de qué campaña llegas, y Meta mide nuestros anuncios y puede mostrarte los de Ciade en Facebook e Instagram. Puedes cambiarlo cuando quieras en «Configurar cookies», al pie de la página. Política de cookies