Entrega de prueba

POST

Entrega sintética que dispara POST /v1/webhooks/{id}/probar. Sirve para verificar URL, firma y conectividad de punta a punta antes de que ocurra un hecho real.

Diferencias con una entrega real: se envía con un solo intento (una prueba que reintenta con backoff durante 12 horas no prueba nada) y cada prueba es un evento nuevo, así que no se deduplica contra la anterior. datos es mínimo y su forma no es un contrato.

No es suscribible: no se puede pedir en el array eventos de una suscripción.

Cuerpo de la solicitud ^required

Envelope del evento de prueba, firmado igual que cualquier otra entrega

Cuerpo de CUALQUIER entrega de webhook. datos cambia según tipo; el resto del envelope es idéntico en todos los eventos.

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

Payload propio del tipo de evento

object

Ejemplo

{
  "id": "0199d1b0-1111-7000-8000-000000000000",
  "tipo": "webhook.test",
  "creadoEn": "2026-09-12T10:30:00.000-03:00",
  "cuentaId": "0199d1b0-0000-7000-8000-000000000000",
  "sucursalId": null,
  "datos": {
    "prueba": true
  }
}

Respuestas

200

Recibido. Cualquier 2xx cierra la entrega.