Se dio de baja una tarjeta

POST

La tarjeta ya no se puede usar para cobrar. Es baja lógica: la fila se apaga porque hay cobros y suscripciones que la referencian. yaNoExistiaEnProveedor: true sigue siendo una baja efectiva, no un error.

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 tarjeta.baja.

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

clienteId

required

string format: uuid

mascara

required

PAN enmascarado. NUNCA viaja el número completo ni el CVV

string

brandCode

required

string

brand

required

string

nullable

dueDate

required

string

nullable

tipo

required

string

nullable

recurringEligible

required

false = no sirve para cobro desatendido: una suscripción declinaría cada período

boolean

activo

required

boolean

elegibleParaRecurrente

Alias de recurringEligible en el alta

boolean

yaNoExistiaEnProveedor

Sólo en tarjeta.baja: del otro lado ya no estaba

boolean

auditNumber

string

nullable

Ejemplo

{
  "id": "0199d1b0-1111-7000-8000-000000000000",
  "tipo": "tarjeta.baja",
  "creadoEn": "2026-09-12T10:30:00.000-03:00",
  "cuentaId": "0199d1b0-0000-7000-8000-000000000000",
  "sucursalId": null,
  "datos": {
    "id": "3a2f1e0d-9c8b-4a7f-8e6d-5c4b3a2f1e0d",
    "clienteId": "7e6d5c4b-3a2f-4e1d-9c8b-7a6f5e4d3c2b",
    "mascara": "589656******2345",
    "brandCode": "CABAL",
    "brand": "Cabal",
    "dueDate": "0930",
    "tipo": "credito",
    "recurringEligible": true,
    "activo": false,
    "yaNoExistiaEnProveedor": false,
    "auditNumber": "000789"
  }
}

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