Consultar MED

Utilice este endpoint para consultar los detalles de un MED específico por su id.

Entornos Disponibles

Producción

https://api.gateway.com.br/core

Endpoint

• Método: GET
• Endpoint: /med/{id}
• Autenticación: Bearer token

Path Params

Nombre	Tipo	Obligatorio	Descripción	Validaciones
id	string (UUID v4)	Sí	Identificador del MED	Debe ser un UUID v4 válido

Ejemplo de Solicitud

cURL

curl --request GET \
--url https://api.gateway.com.br/core/med/553e8400-e29b-41d4-a716-436251480000 \
--header 'Authorization: Bearer su-token-jwt'

JavaScript

const response = await fetch('https://api.gateway.com.br/core/med/553e8400-e29b-41d4-a716-436251480000', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer su-token-jwt'
  }
});

const data = await response.json();

Respuesta Exitosa

Campo	Tipo	Obligatorio	Descripción
id	string	Sí	Identificador del MED
acquirer	string	Sí	Adquirente del MED
transactionId	string	Sí	Identificador de la transacción
endToEnd	string	Sí	Identificador end-to-end
notificationId	string	No	Identificador de la notificación asociada
status	string (enum) - PENDING, APPEALED, APPROVED, REJECTED	Sí	Estado del MED
origin	string (enum) - ACQUIRER, ADMIN	Sí	Origen del MED
reason	string (enum) - SCAM, FRAUDULENT_ACCESS, OPERATIONAL_ERROR, OTHER	Sí	Motivo del MED
amount	number	Sí	Monto del MED (entero, en centavos)
paymentMethod	string (enum) - PIX	Sí	Método de pago
payer	object	No	Datos del pagador (ver Sub-Objeto AccountHolder)
customerMessage	string	No	Mensaje del cliente
user	object	Sí	Datos del usuario (UserVo)
decisionMessage	string	No	Mensaje de la decisión
refundStatus	string (enum) - FULL_REFUND, PARTIAL_REFUND, INSUFFICIENT_FUNDS	No	Estado del reembolso
appealContent	object	No	Contenido de la defensa (AppealContent)
refundAmount	number	No	Monto del reembolso (entero, en centavos)
statusHistory	array	Sí	Historial de estados (ver Sub-Objeto StatusHistory)
medDate	string (ISO)	Sí	Fecha del MED
createdAt	string (ISO)	Sí	Fecha de creación
updatedAt	string (ISO)	Sí	Fecha de la última actualización

Sub-Objetos

UserVo

Campo	Tipo	Obligatorio	Descripción
name	string	Sí	Nombre del usuario
email	string	Sí	Correo electrónico del usuario
createdAt	string (ISO)	Sí	Fecha de creación del usuario

AccountHolder

Campo	Tipo	Obligatorio	Descripción
type	string (enum) - PF, PJ	Sí	Tipo del titular
name	string	Sí	Nombre del titular
document	string	Sí	Documento del titular
bankAccount	object	Sí	Datos bancarios (ver Sub-Objeto BankAccount)
pix	object	Sí	Clave PIX del titular (ver Sub-Objeto PixKeyVo)

BankAccount

Campo	Tipo	Obligatorio	Descripción
type	string	Sí	Tipo de cuenta
digit	string	Sí	Dígito de la cuenta
ispb	string	Sí	ISPB del banco

PixKeyVo

Campo	Tipo	Obligatorio	Descripción
key	string	Sí	Clave PIX
type	string (enum) - CPF, CNPJ, EMAIL, PHONE, EVP	Sí	Tipo de la clave PIX

StatusHistory (elemento)

Campo	Tipo	Obligatorio	Descripción
status	string (enum) - PENDING, APPEALED, APPROVED, REJECTED	Sí	Estado del MED en el historial
date	string (ISO)	Sí	Fecha y hora del cambio de estado
durationInMilliseconds	number	No	Duración del estado en milisegundos

AppealContent

Campo	Tipo	Obligatorio	Descripción
message	string	No	Mensaje de la defensa
evidences	array	No	Evidencias de la defensa (ver Sub-Objeto FileVo)

FileVo (elemento de evidences)

Campo	Tipo	Obligatorio	Descripción
key	string	Sí	Clave del archivo
isPrivate	boolean	Sí	Indica si el archivo es privado
expirationDate	string (ISO)	No	Fecha de expiración del archivo
url	string	No	URL firmada del archivo

Ejemplo de Respuesta

{
  "id": "553e8400-e29b-41d4-a716-436251480000",
  "acquirer": "ACQUIRER_EXEMPLO",
  "transactionId": "553e8400-e29b-41d4-a716-446655440000",
  "endToEnd": "E2E12345678",
  "notificationId": null,
  "status": "APPEALED",
  "origin": "ACQUIRER",
  "reason": "FRAUDULENT_ACCESS",
  "amount": 1000,
  "paymentMethod": "PIX",
  "payer": {
    "type": "PF",
    "name": "Fulano de Tal",
    "document": "***456789**",
    "bankAccount": {
      "type": "CHECKING",
      "digit": "7",
      "ispb": "12345678"
    },
    "pix": {
      "key": "12345678910",
      "type": "CPF"
    }
  },
  "customerMessage": "Cliente informou não reconhecer a cobrança.",
  "user": {
    "name": "Loja Exemplo",
    "email": "contato@lojaexemplo.com",
    "createdAt": "2026-03-01T09:00:00.000Z"
  },
  "decisionMessage": "Defesa recebida e em análise.",
  "refundStatus": "FULL_REFUND",
  "appealContent": {
    "message": "Anexamos comprovante de entrega.",
    "evidences": [
      {
        "key": "med/evidence-1.pdf",
        "isPrivate": true,
        "expirationDate": "2026-03-25T10:00:00.000Z",
        "url": null
      }
    ]
  },
  "refundAmount": 1000,
  "statusHistory": [
    {
      "status": "PENDING",
      "date": "2026-03-24T10:00:00.000Z",
      "durationInMilliseconds": 3600000
    },
    {
      "status": "APPEALED",
      "date": "2026-03-24T11:00:00.000Z",
      "durationInMilliseconds": 1800000
    },
    {
      "status": "APPROVED",
      "date": "2026-03-24T11:30:00.000Z",
      "durationInMilliseconds": null
    }
  ],
  "medDate": "2026-03-24T10:00:00.000Z",
  "createdAt": "2026-03-24T10:00:00.000Z",
  "updatedAt": "2026-03-24T11:30:00.000Z"
}

Errores Posibles

Código	Descripción	Solución
401	Credenciales inválidas	Verifique sus credenciales
403	Sin permiso/autorización	Contacte al soporte
404	MED no encontrado	Verifique el id enviado
500	Error interno	Contacte al soporte