Se dio de baja la suscripción

POST

Baja definitiva. recurrenteDeshabilitado: true significa que además se apagó el cfe_recurrente vinculado: dejarlo vivo seguiría facturando un servicio que nadie paga.

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 suscripcion.cancelada.

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

suscripcionIdProveedor

required

string

planPagoId

required

string format: uuid

clienteId

required

string format: uuid

medioPagoClienteId

required

string format: uuid

nullable

estado

required

string

Allowed values: active past_due paused cancelled

currentPeriodStart

required

string

nullable

currentPeriodEnd

required

string

nullable

nextChargeAt

required

string

nullable

cfeRecurrenteId

required

string format: uuid

nullable

retryCount

required

integer

estadoProveedor

Estado que devolvió la red de pagos en la transición

string

nullable

recurrenteDeshabilitado

Sólo en suscripcion.cancelada: si se apagó el cfe_recurrente vinculado

boolean

Ejemplo

{
  "id": "0199d1b0-1111-7000-8000-000000000000",
  "tipo": "suscripcion.cancelada",
  "creadoEn": "2026-09-12T10:30:00.000-03:00",
  "cuentaId": "0199d1b0-0000-7000-8000-000000000000",
  "sucursalId": null,
  "datos": {
    "id": "5c4b3a2f-1e0d-4c9b-8a7f-6e5d4c3b2a19",
    "suscripcionIdProveedor": "sub_abc123",
    "planPagoId": "4b3a2f1e-0d9c-4b8a-9f7e-6d5c4b3a2f1e",
    "clienteId": "7e6d5c4b-3a2f-4e1d-9c8b-7a6f5e4d3c2b",
    "medioPagoClienteId": "3a2f1e0d-9c8b-4a7f-8e6d-5c4b3a2f1e0d",
    "estado": "cancelled",
    "currentPeriodStart": "2026-09-01T00:00:00.000-03:00",
    "currentPeriodEnd": "2026-09-30T23:59:59.000-03:00",
    "nextChargeAt": null,
    "cfeRecurrenteId": null,
    "retryCount": 0,
    "estadoProveedor": "paused",
    "recurrenteDeshabilitado": true
  }
}

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}.