Webhook

Los webhooks son notificaciones automáticas que la API envía cada vez que ocurre un evento relacionado con un MED. Así no necesita estar consultando la API: solo recibe y procesa el evento cuando llega.

Eventos de webhook

Cada webhook representa un cambio en el ciclo de vida del MED.

Tipos de evento

Evento	Descripción
MED_CREATED	MED creado
MED_CLOSED	MED cerrado
MED_APPEALED	Defensa del MED presentada
MED_APPROVED	MED aprobado
MED_REJECTED	MED rechazado

Datos del webhook

Campo	Tipo	Obligatorio	Descripción
type	string (enum) - MED_CREATED, MED_CLOSED, MED_APPEALED, MED_APPROVED, MED_REJECTED	Sí	Tipo del evento
data	object	Sí	Datos del MED (ver Sub-Objetos data)

Sub-Objetos

data

Campo	Tipo	Obligatorio	Descripción
id	string (UUID)	Sí	Identificador único de la transacción
amount	number	Sí	Monto de la transacción (entero, en centavos)
externalCode	string	No	Su código de referencia
createdAt	string (ISO)	Sí	Fecha de creación
status	string (enum) - BLOCKED, PAID, PROCESSING_INFRACTION, INFRACTION	Sí	BLOCKED: transacción bloqueada por un MED PAID: transacción liberada PROCESSING_INFRACTION: infracción en procesamiento INFRACTION: infracción confirmada
endToEnd	string	No	Identificador end-to-end de la transacción
med	object	Sí	Datos del MED (ver Sub-Objeto Med)

Med

Campo	Tipo	Obligatorio	Descripción
id	string (UUID)	Sí	Identificador único del MED
createdAt	string (ISO)	Sí	Fecha de creación
status	string (enum) - PENDING, APPEALED, APPROVED, REJECTED	Sí	Estado del MED

Ejemplo de payload

{
  "type": "MED_CREATED",
  "data": {
    "id": "553e8400-e29b-41d4-a716-436251480000",
    "amount": 10000,
    "externalCode": "TRANS-123",
    "createdAt": "2026-03-06T12:49:04.681Z",
    "status": "BLOCKED",
    "endToEnd": "E2E123456789",
    "med": {
      "id": "993e8400-e29b-41d4-a716-436251480001",
      "createdAt": "2026-03-06T12:49:04.681Z",
      "status": "PENDING"
    }
  }
}