Desarrolladores / Webhooks
Entrega al menos una vez
Hasta 6 intentos de reintento con espera exponencial
Estadísticas y registros de entrega por endpoint
Cobertura de eventos en directo
Carrito
Finalizar compra
Pedidos
Pagos
Disputas y contracargos
Mantente al tanto de las disputas de pago y contracargos.
Pagos
Sigue las transferencias de pago y su estado.
Ciclo de vida de los webhooks
Gestiona y monitoriza tus endpoints de webhook.
CloudEvents 1.0
La entrega de eventos es de tipo «al menos una vez» y no tiene un orden global. Si implementas la idempotencia en tu endpoint, elimina los duplicados combinando source + id. El mismo ID de evento nunca representará dos eventos distintos.
versión de la especificación
Siempre "1.0". Seguimos la semántica de CloudEvents en toda la plataforma.
tipo
El identificador del tipo de evento (por ejemplo, cope.order.completed).
fuente
El servicio de origen. Combínalo con el ID para garantizar la idempotencia.
id
ID único de evento, estable entre reintentos. Úsalo para evitar duplicados.
tiempo
Marca de tiempo según RFC 3339 de cuándo se emitió el evento.
asunto
El ID del recurso principal al que hace referencia este evento.
datos
La carga útil específica del evento. Esquema documentado según el tipo de evento.
Modelo de seguridad
Garantías de entrega
5xx · Tiempo de espera agotado
Reintentar según lo programado
Un mismo evento puede entregarse más de una vez en caso de reintento. La idempotencia en tu endpoint es responsabilidad tuya: elimina duplicados usando source + id.
4xx
No reintentable
Las respuestas 4xx se consideran un "no quiero recibir este evento" definitivo. Las registramos y continuamos sin reintentar.
Fallo persistente
Desactivación automática
Los endpoints que fallan de forma constante se desactivan automáticamente. Enviamos un evento webhook.endpoint.auto_disabled y un correo electrónico al propietario.
Garantía i.
Entrega garantizada al menos una vez.
Un mismo evento puede entregarse más de una vez en caso de reintento. La idempotencia en tu endpoint es responsabilidad tuya: elimina duplicados usando source + id.
Garantía ii.
Sin orden global.
Es posible que los eventos de un mismo asunto no lleguen en orden. Tu endpoint no debe dar por sentada la secuencia. Si el orden es importante para tu controlador, utiliza el campo time del evento.
Uso de webhooks en producción
Actuales y próximos
Endpoints exclusivamente HTTPS con firma HMAC-SHA256 y protección contra repetición de transacciones.
En directo
Cargas útiles JSON de CloudEvents 1.0 para todos los tipos de eventos.
En directo
Entrega de tipo "al menos una vez" con deduplicación determinista basada en origen e identificador.
En directo
Reintentos con retroceso exponencial (30 s, 5 min, 30 min, 2 h, 12 h, máx. 6).
En directo
Desactivación automática para fallos persistentes, con notificación y correo electrónico de aviso.
En directo
Cobertura de eventos en carrito, checkout, pedidos, pagos, reembolsos, disputas, contracargos y liquidaciones.
En directo
API de gestión de endpoints con CRUD, filtrado de suscripción por tipo y clave secreta de firma de un solo uso.
En directo
Prueba sintética activable por endpoint.
En directo
Reenvío de eventos individuales o en lote (últimos 90 días).
En directo
Registros y estadísticas de entrega por endpoint (tasa de éxito y latencia p99).
En directo
Rotación de firmas secretas con período de gracia. Actualmente, rotar una firma secreta requiere crear un nuevo endpoint. La rotación con período de gracia ya está en desarrollo.
muy pronto
Redacción de PII por endpoint. Configura qué campos se ocultan antes de la entrega de forma individualizada para cada endpoint.
muy pronto
Ya están disponibles los conectores de Zapier, Make y n8n. Hoy mismo puedes integrarte con cualquiera de ellos gestionando nuestros webhooks directamente. Muy pronto lanzaremos conectores nativos oficiales con autenticación gestionada.
muy pronto
Orden de entrega garantizado y procesamiento único. No está en nuestra hoja de ruta inmediata. El modelo de procesamiento al menos una vez está diseñado así de forma intencionada. La idempotencia se gestiona en tu propio endpoint.
muy pronto