curl --request PATCH \
--url https://e-cf.acpay.do/sandbox/v1/webhooks/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"active": false
}
'{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"url": "https://erp.distribuidoracaribe.com.do/webhooks/ecf",
"events": [
"ecf.accepted",
"ecf.rejected"
],
"active": true,
"createdAt": "2026-09-27T14:00:00.000Z",
"updatedAt": "2026-09-27T14:00:00.000Z"
}{
"error": {
"status": 400,
"message": "La solicitud no es válida.",
"details": [
"items.0.quantity: debe ser un número entero.",
"dueDate: es obligatoria cuando paymentType es credit."
]
}
}{
"error": {
"status": 401,
"message": "Esta llave pertenece a otro ambiente."
}
}{
"error": {
"status": 403,
"message": "La llave no tiene permiso para esta operación."
}
}{
"error": {
"status": 404,
"message": "Documento no encontrado."
}
}{
"error": {
"status": 429,
"message": "Demasiadas solicitudes. Intenta de nuevo más tarde."
}
}{
"error": {
"status": 502,
"message": "El servicio de facturación electrónica tuvo un error inesperado. Intenta de nuevo más tarde."
}
}{
"error": {
"status": 503,
"message": "El servicio de facturación electrónica no está disponible. Intenta de nuevo en unos minutos."
}
}Modificar un webhook
Cambia la URL, los eventos o si está activo (active: false lo pausa sin borrarlo). Solo se modifican los campos enviados; envía al menos uno. No exige Idempotency-Key: repetir la misma solicitud deja el webhook igual. El secreto no cambia.
curl --request PATCH \
--url https://e-cf.acpay.do/sandbox/v1/webhooks/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"active": false
}
'{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"url": "https://erp.distribuidoracaribe.com.do/webhooks/ecf",
"events": [
"ecf.accepted",
"ecf.rejected"
],
"active": true,
"createdAt": "2026-09-27T14:00:00.000Z",
"updatedAt": "2026-09-27T14:00:00.000Z"
}{
"error": {
"status": 400,
"message": "La solicitud no es válida.",
"details": [
"items.0.quantity: debe ser un número entero.",
"dueDate: es obligatoria cuando paymentType es credit."
]
}
}{
"error": {
"status": 401,
"message": "Esta llave pertenece a otro ambiente."
}
}{
"error": {
"status": 403,
"message": "La llave no tiene permiso para esta operación."
}
}{
"error": {
"status": 404,
"message": "Documento no encontrado."
}
}{
"error": {
"status": 429,
"message": "Demasiadas solicitudes. Intenta de nuevo más tarde."
}
}{
"error": {
"status": 502,
"message": "El servicio de facturación electrónica tuvo un error inesperado. Intenta de nuevo más tarde."
}
}{
"error": {
"status": 503,
"message": "El servicio de facturación electrónica no está disponible. Intenta de nuevo en unos minutos."
}
}Autorizaciones
Llave de API de AC-PAY del ambiente de esta URL.
Parámetros de ruta
Identificador del webhook (UUID).
"7c9e6679-7425-40de-944b-e07fc1f90ae7"
Cuerpo
Nueva URL HTTPS (hasta 2048 caracteres).
2048"https://erp.distribuidoracaribe.com.do/webhooks/ecf-v2"
Nueva lista de eventos (al menos uno, sin repetir). Reemplaza la anterior.
1ecf.accepted, ecf.rejected, ecf.cancelled ["ecf.accepted"]
false pausa el webhook (no recibe eventos) sin borrarlo; true lo reactiva.
false
Respuesta
Webhook modificado.
"7c9e6679-7425-40de-944b-e07fc1f90ae7"
"https://erp.distribuidoracaribe.com.do/webhooks/ecf"
Eventos suscritos.
ecf.accepted, ecf.rejected, ecf.cancelled ["ecf.accepted", "ecf.rejected"]
Si recibe eventos. Uno inactivo no recibe nada.
true
"2026-09-27T14:00:00.000Z"
"2026-09-27T14:00:00.000Z"