MED — Mecanismo Especial de Devolución
¿Qué es el MED?
El MED (Mecanismo Especial de Devolución — "Mecanismo Especial de Devolução") es un mecanismo regulado por el Banco Central de Brasil que permite devolver montos de transacciones PIX cuando existe sospecha de fraude o falla operacional. A diferencia de un reverso común, el MED implica un análisis formal entre las instituciones financieras, con plazos y reglas definidos por el BACEN.
El MED es un proceso regulatorio obligatorio. Su empresa debe estar preparada para recibir, analizar y responder a las notificaciones de MED dentro de los plazos establecidos por el Banco Central.
¿Cuándo se abre un MED?
Un MED puede ser accionado por el banco del pagador (banco solicitante) en dos escenarios:
| Escenario | Descripción | Ejemplo |
|---|---|---|
| Fraude | Sospecha de transacción no autorizada, ingeniería social, acceso fraudulento | El pagador alega que no realizó el PIX |
| Falla operacional | Error de sistema que resultó en crédito indebido | PIX duplicado por falla técnica |
Causas
El campo cause indica el motivo del MED cuando está disponible (ej: UNAUTHORIZED_TRANSACTION, SOCIAL_ENGINEERING). En algunos casos, cause puede ser null — en ese escenario, description contiene el texto descriptivo de la solicitud.
Valores posibles de cause
| Valor | Descripción |
|---|---|
UNAUTHORIZED_TRANSACTION | El pagador alega que no autorizó la transacción |
FRAUDULENT_ACCESS | Acceso indebido a la cuenta del pagador |
SOCIAL_ENGINEERING | Estafa por manipulación (ej: falso funcionario de banco) |
OPERATIONAL_FAILURE | Error técnico que generó crédito indebido |
null | Causa no clasificada — consulte el campo description para más detalles |
El campo cause puede ser null cuando el origen de la solicitud no proporciona un código estructurado. En esos casos, el campo description contiene el texto descriptivo (ej: relato del pagador, notificación formal del banco). En su integración, trate cause como opcional y siempre muestre description como información complementaria.
La plataforma sincroniza los MEDs automáticamente con los proveedores PIX configurados en su cuenta. La frecuencia de sincronización puede variar. Use GET /api/med para verificar el estado actualizado en cualquier momento.
El rol de su empresa
Cuando se recibe un MED, su empresa es el banco contestado — es decir, el banco que recibió el PIX en nombre de su cliente (el beneficiario). Usted debe:
- Recibir la notificación — vía el webhook
MedCreated - Analizar la situación — verificar si la transacción es legítima
- Bloquear el saldo (si corresponde) — retener el monto para una posible devolución
- Responder al MED — aceptar (devolver) o rechazar (contestar) la solicitud
El bloqueo de saldo y la respuesta al MED son gestionados internamente por la plataforma. Su integración solo necesita monitorear los webhooks para acompañar el estado del MED y tomar acciones en su sistema (notificar al cliente, actualizar registros, etc.).
Ciclo de vida del MED
┌─────────────────────────────────────────────────────────────────┐
│ CICLO DE VIDA DEL MED │
│ │
│ ┌──────────┐ ┌──────────┐ ┌───────────┐ │
│ │ OPEN │───▶│ RECEIVED │───▶│ ANALYZED │ │
│ └──────────┘ └──────────┘ └─────┬─────┘ │
│ │ │ │
│ │ ┌─────┴─────┐ │
│ ▼ ▼ ▼ │
│ ┌───────────┐ ┌──────────┐ ┌──────────┐ │
│ │ CANCELLED │ │ APPROVED │ │ REJECTED │ │
│ └───────────┘ └──────────┘ └──────────┘ │
│ │ │ │
│ ▼ ▼ │
│ Monto es Saldo es │
│ devuelto desbloqueado │
│ al pagador al beneficiario │
└─────────────────────────────────────────────────────────────────┘Estados del MED
Estado (status) | Descripción | Webhook |
|---|---|---|
OPEN | MED creado por el banco solicitante | — |
RECEIVED | MED recibido y en análisis | MedCreated |
CANCELLED | MED cancelado por el banco solicitante (antes del análisis) | — |
ANALYZED | Análisis concluido con resultado | MedAccepted o MedRejected |
Resultado del análisis
Resultado (analysisResult) | Descripción | Webhook | Impacto financiero |
|---|---|---|---|
APPROVED | Devolución aceptada — monto devuelto al pagador | MedAccepted | Monto debitado de la cuenta del beneficiario |
REJECTED | Devolución negada — saldo permanece con el beneficiario | MedRejected | Saldo desbloqueado |
Plazos Regulatorios (BACEN)
El MED está regulado por el Banco Central de Brasil y posee plazos específicos para acusar recibo, analizar la solicitud y responder al banco solicitante. La falta de respuesta dentro del plazo puede resultar en aprobación automática de la devolución y en reporte regulatorio al BACEN.
Los plazos exactos siguen la regulación vigente del Banco Central (Resolución BCB aplicable al MED PIX) y pueden ser actualizados por el regulador. Consulte a su equipo legal / de compliance para los valores vinculantes más recientes antes de dimensionar los SLAs internos.
Recomendaciones operacionales:
- Configure alertas internas con margen antes del plazo regulatorio (ej.: T-24h antes del vencimiento) para evitar la aprobación automática por inacción.
- Monitoree el webhook
MedCreateden tiempo real — ese es el disparador para iniciar la cuenta regresiva del plazo de análisis. - Documente internamente la política de respuesta (quién analiza, quién aprueba, quién responde al MED) y pruebe el flujo de punta a punta antes de ir a producción.
- Mantenga evidencias (logs, documentos de defensa, historial de comunicación) para auditoría regulatoria.
Flujo de integración
Use POST /api/webhooks para configurar URLs de callback para los eventos med_created, med_accepted y med_rejected. Consulte la guía de configuración de webhooks.
Cuando se abre un MED contra una transacción de su cuenta, usted recibe un webhook con los detalles: causa, banco solicitante, transacción original y estado.
Use GET /api/med para consultar el estado de los MEDs en cualquier momento. Filtre por estado, fecha o conciliación.
Cuando el análisis concluye, usted recibe MedAccepted (devolución aprobada) o MedRejected (devolución negada). Actualice sus registros en consecuencia.