El link de cobro se anuló antes de pagarse

POST

El link ya no se puede pagar. Se emite una sola vez aunque se anule dos veces (la segunda llamada responde 200 sin re-emitir).

Lo entrega Host Factura a la url de tu suscripción, no es una ruta de esta API. Respondé 2xx en menos de 10 segundos; cualquier otra cosa dispara el backoff (5 s, 30 s, 5 min, 30 min, 2 h, 12 h y después DEAD).

Cuerpo de la solicitud ^required

Envelope del evento, firmado con HMAC-SHA256

Entrega del evento link.anulado.

object

id

required

UUID v7 del evento. ESTABLE entre reintentos: es la clave de deduplicación del receptor

string format: uuid

tipo

required

Tipo del evento, p. ej. pago.confirmado

string

creadoEn

required

ISO 8601 con offset America/Montevideo

string

cuentaId

required

Cuenta que originó el evento

string format: uuid

sucursalId

required

Sucursal del evento, o null si es de la cuenta entera

string format: uuid

nullable

datos

required

object

id

required

string format: uuid

referenciaExterna

required

integer

nullable

referenciaIntegrador

required

string

nullable

estado

required

string

Allowed values: borrador pendiente en_verificacion pagada expirada anulada fallida

monto

required

string

moneda

required

string

clienteId

required

string format: uuid

nullable

cfeEmitidoId

required

string format: uuid

nullable

politicaFiscal

required

string

descripcion

required

string

nullable

expiraEn

required

string

nullable

tieneBorrador

required

boolean

motivo

Sólo en link.anulado

string

nullable

Ejemplo

{
  "id": "0199d1b0-1111-7000-8000-000000000000",
  "tipo": "link.anulado",
  "creadoEn": "2026-09-12T10:30:00.000-03:00",
  "cuentaId": "0199d1b0-0000-7000-8000-000000000000",
  "sucursalId": null,
  "datos": {
    "id": "8f14e45f-ceea-467a-9f5a-2b1c3d4e5f60",
    "referenciaExterna": 1042,
    "referenciaIntegrador": "orden-12345",
    "estado": "anulada",
    "monto": "1234.56",
    "moneda": "UYU",
    "clienteId": "7e6d5c4b-3a2f-4e1d-9c8b-7a6f5e4d3c2b",
    "cfeEmitidoId": null,
    "politicaFiscal": "facturar_al_cobrar",
    "descripcion": "Orden 12345",
    "expiraEn": "2026-09-19T23:59:59.000-03:00",
    "tieneBorrador": true,
    "motivo": "El comprador pidió cambiar el medio de pago"
  }
}

Respuestas

200

Recibido. Cualquier 2xx cierra la entrega; el cuerpo de la respuesta se ignora.

410

Endpoint retirado. Host Factura NO desuscribe automáticamente: la entrega se reintenta igual y después queda DEAD. Para dejar de recibir, borrá la suscripción con DELETE /v1/webhooks/{id}.