Saltar al contenido principal
Usa este endpoint para eliminar de forma permanente un endpoint de webhook. Una vez eliminado, VelaFi deja de enviar de inmediato notificaciones de eventos a la URL asociada. Los webhooks eliminados aparecen en Listar webhooks con status: 30, pero no se pueden restaurar; crea un webhook nuevo si necesitas volver a registrar la misma URL o el mismo tipo de evento.
Todas las solicitudes deben incluir el encabezado X-BH-TOKEN con un token obtenido de GET /v2/token/generate (consulta Autenticación). La eliminación es irreversible.

​
Endpoint

DELETE https://api.velafi.com/v2/webhook/{webhookId}

​
Parámetro de ruta

​
string
requerido
ID único del webhook que se eliminará. Lo obtienes de la respuesta de Listar webhooks.

​
Campos de la respuesta

​
number
Código de respuesta de tipo HTTP. 200 indica éxito.
​
string
Mensaje de estado legible, por ejemplo SUCCESS.
​
boolean
true si el webhook se eliminó.

​
Ejemplo

cURL
Respuesta
La eliminación es permanente y no se puede deshacer. Los eventos que ocurren mientras no existe un webhook activo para el tipo de evento no se ponen en cola. Los eventos que ya están en cola no se cancelan: si creas un webhook nuevo para el mismo tipo de evento en un plazo aproximado de 15 días, se entregan a la URL del webhook nuevo con el webhookId del webhook eliminado. Crea un webhook nuevo de inmediato si necesitas que la entrega continúe.