Webhooks

Los webhooks permiten registrar una URL pública y suscribirse a eventos habilitados por el nivel de API de la tienda.

Operaciones

Listar webhooks: webhooks:read, nivel basic.
Crear, actualizar y eliminar: webhooks:write, nivel basic.

Al crear un webhook, la URL debe ser HTTP(S), pública y superar las validaciones SSRF del servidor.

{
  "url": "https://integracion.example.com/events",
  "eventos": ["orden.creada", "stock.actualizado"]
}

Eventos declarados

El contrato enumera estos eventos, aunque su disponibilidad depende del nivel de API:

orden.creada, orden.pagada, orden.cancelada
orden.preparando, orden.empaquetado, orden.lista_para_retirar
orden.enviada, orden.entregada, orden.envio_mayorista_actualizado
pago.reembolsado
stock.actualizado
contacto.creado
carrito.abandonado
devolucion.actualizada
producto.creado, producto.actualizado, variante.actualizada

Secret y límites

Crear una suscripción genera un secret de firma. La respuesta lo devuelve una sola vez; el listado de webhooks nunca lo incluye. Guardalo inmediatamente en un gestor de secretos del servidor.

El máximo declarado es 2 webhooks para basic, 10 para advanced y null para enterprise.