Listar MEDs de Saque

Utilize este endpoint para listar os MEDs de saque, com filtros por período, status e dados do saque contestado.

Ambientes Disponíveis

Produção

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

Endpoint

• Método: GET
• Endpoint: /med/withdrawal
• Autenticação: Bearer token

Query Params

ℹ️ Datas em ISO

Os campos startDate e endDate devem ser enviados em ISO date string com horário.

Exemplo:

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

Nome	Tipo	Obrigatório	Descrição	Validações
startDate	string	Não	Data inicial do filtro	Deve ser ISO date string com horário
endDate	string	Não	Data final do filtro	Deve ser ISO date string com horário
status	string[] (enum) - PENDING, APPEALED, APPROVED, REJECTED	Não	Lista de status para filtrar	Deve ser um array não vazio e sem duplicados
id	string (UUID)	Não	Identificador do MED	Deve ser UUID válido
withdrawalId	string (UUID)	Não	Identificador do saque contestado	Deve ser UUID válido
userId	string (UUID v4)	Não	Identificador do usuário dono do saque	Deve ser UUID v4 válido
endToEnd	string	Não	Identificador end-to-end do saque	Deve ter entre 8 e 255 caracteres
amount	number	Não	Valor do MED (inteiro em centavos)	Deve ser inteiro em centavos; mínimo 1 (R$ 0,01) e máximo 10000000 (R$ 100.000,00)
paymentMethod	string (enum) - PIX	Não	Método de pagamento	Deve ser um enum válido

Exemplo de Requisição

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 seu-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 seu-token-jwt'
  }
});
const data = await response.json();

Resposta de Sucesso

Campo	Tipo	Obrigatório	Descrição
totalPages	number	Sim	Total de páginas
currentPage	number	Sim	Página atual
perPage	number	Sim	Itens por página
data	array	Sim	Lista de MEDs de saque

Campos do item em data

Cada item tem o mesmo formato de Buscar MED de Saque, incluindo os sub-objetos AccountHolder, UserVo e StatusHistory.

Exemplo de Resposta

Dados mascarados

Valores sensíveis podem estar mascarados com ***.

{
  "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"
    }
  ]
}

Possíveis Erros

Código	Descrição	Solução
401	Credenciais inválidas	Verifique suas credenciais
403	Sem permissão/autorização	Contate o suporte
422	Dados inválidos ou faltando	Verifique o formato dos dados
422	Validações	Contate o suporte
500	Erro interno	Contate o suporte