El cobro se confirmó: la plata entró

POST

Este es el evento con el que se entrega el producto. El cobro quedó registrado. No implica que el comprobante fiscal ya salió: eso es pago.facturado.

yaEstabaCobrado: true significa que el cobro ya estaba registrado y la llamada fue un reintento — no es un segundo cobro.

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 pago.confirmado.

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

pagoId

required

string format: uuid

solicitudId

required

string format: uuid

nullable

clienteId

required

string format: uuid

nullable

monto

required

Decimal como string: "1234.56"

string

moneda

required

string

canal

required

string

Allowed values: link tarjeta_registrada suscripcion manual qr_pos

paymentToken

required

string

nullable

rrn

string

nullable

authorizationCode

required

string

nullable

marca

string

nullable

mascara

string

nullable

yaEstabaCobrado

true si el cobro ya estaba registrado (reintento del integrador)

boolean

Ejemplo

{
  "id": "0199d1b0-1111-7000-8000-000000000000",
  "tipo": "pago.confirmado",
  "creadoEn": "2026-09-12T10:30:00.000-03:00",
  "cuentaId": "0199d1b0-0000-7000-8000-000000000000",
  "sucursalId": null,
  "datos": {
    "pagoId": "9b1c3d4e-5f60-4a7b-8c9d-0e1f2a3b4c5d",
    "solicitudId": "8f14e45f-ceea-467a-9f5a-2b1c3d4e5f60",
    "clienteId": "7e6d5c4b-3a2f-4e1d-9c8b-7a6f5e4d3c2b",
    "monto": "1234.56",
    "moneda": "UYU",
    "canal": "link",
    "paymentToken": "pt_abc123",
    "authorizationCode": "123456",
    "marca": "VISA",
    "mascara": "450995******3345"
  }
}

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