Listar MED de Retiro

Utilice este endpoint para listar los MED de retiro, con filtros por período, estado y datos del retiro en disputa.

Entornos Disponibles

Producción

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

Endpoint

• Método: GET
• Endpoint: /med/withdrawal
• Autenticación: Bearer token

Query Params

ℹ️ Fechas en ISO

Los campos startDate y endDate deben enviarse como ISO date string con hora.

Ejemplo:

• 2026-03-06T12:00:00.000Z

Nombre	Tipo	Obligatorio	Descripción	Validaciones
startDate	string	No	Fecha inicial del filtro	Debe ser una ISO date string con hora
endDate	string	No	Fecha final del filtro	Debe ser una ISO date string con hora
status	string[] (enum) - PENDING, APPEALED, APPROVED, REJECTED	No	Lista de estados para filtrar	Debe ser un arreglo no vacío y sin duplicados
id	string (UUID)	No	Identificador del MED	Debe ser un UUID válido
withdrawalId	string (UUID)	No	Identificador del retiro en disputa	Debe ser un UUID válido
userId	string (UUID v4)	No	Identificador del usuario dueño del retiro	Debe ser UUID v4 válido
endToEnd	string	No	Identificador end-to-end del retiro	Debe tener entre 8 y 255 caracteres
amount	number	No	Monto del MED (entero, en centavos)	Debe ser entero en centavos; mínimo 1 (BRL 0.01) y máximo 10000000 (BRL 100,000.00)
paymentMethod	string (enum) - PIX	No	Método de pago	Debe ser un enum válido

Ejemplo de Solicitud

cURL

curl --request GET \
--url "https://api.gateway.com.br/core/med/withdrawal?startDate=2026-03-01T00:00:00.000Z&endDate=2026-03-24T23:59:59.999Z&status=PENDING" \
--header 'Authorization: Bearer su-token-jwt'

JavaScript

const params = new URLSearchParams({
  startDate: '2026-03-01T00:00:00.000Z',
  endDate: '2026-03-24T23:59:59.999Z'
});
params.append('status', 'PENDING');

const response = await fetch(`https://api.gateway.com.br/core/med/withdrawal?${params}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer su-token-jwt'
  }
});
const data = await response.json();

Respuesta Exitosa

Campo	Tipo	Obligatorio	Descripción
totalPages	number	Sí	Total de páginas
currentPage	number	Sí	Página actual
perPage	number	Sí	Elementos por página
data	array	Sí	Lista de MED de retiro

Campos del elemento en data

Cada elemento tiene el mismo formato que Consultar MED de Retiro, incluidos los sub-objetos AccountHolder, UserVo y StatusHistory.

Ejemplo de Respuesta

Datos enmascarados

Los valores sensibles pueden estar enmascarados con ***.

{
  "totalPages": 1,
  "currentPage": 1,
  "perPage": 20,
  "data": [
    {
      "id": "553e8400-e29b-41d4-a716-436251480000",
      "acquirer": "ACQUIRER_EXEMPLO",
      "endToEnd": "E12345678202603061249abcdef0123",
      "notificationId": null,
      "withdrawalId": "553e8400-e29b-41d4-a716-436251480001",
      "status": "PENDING",
      "origin": "USER",
      "reason": "OPERATIONAL_ERROR",
      "amount": 10000,
      "paymentMethod": "PIX",
      "payer": null,
      "receiver": null,
      "message": "Saque enviado para a chave errada",
      "user": {
        "name": "Usuário Exemplo",
        "email": "usuario@exemplo.com",
        "createdAt": "2026-01-15T10:00:00.000Z"
      },
      "statusHistory": [
        {
          "status": "PENDING",
          "date": "2026-03-06T12:49:04.681Z",
          "durationInMilliseconds": 1000
        }
      ],
      "medDate": "2026-03-06T12:49:04.681Z",
      "createdAt": "2026-03-06T12:49:04.681Z",
      "updatedAt": "2026-03-06T12:49:04.681Z"
    }
  ]
}

Errores Posibles

Código	Descripción	Solución
401	Credenciales inválidas	Verifique sus credenciales
403	Sin permiso/autorización	Contacte al soporte
422	Datos inválidos o faltantes	Verifique el formato de los datos
422	Validaciones	Contacte al soporte
500	Error interno	Contacte al soporte