Buscar MED de Saque

Utilize este endpoint para buscar um MED de saque específico pelo id.

Ambientes Disponíveis

Produção

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

Endpoint

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

Path Params

Nome	Tipo	Obrigatório	Descrição	Validações
id	string (UUID)	Sim	Identificador do MED de saque	Deve ser UUID válido

Exemplo de Requisição

cURL

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

JavaScript

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

Resposta de Sucesso

Campo	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador do MED
acquirer	string	Sim	Adquirente do MED
endToEnd	string	Sim	Identificador end-to-end do saque contestado
notificationId	string	Não	Identificador da notificação associada
withdrawalId	string (UUID)	Sim	Identificador do saque contestado
status	string (enum) - PENDING, APPEALED, APPROVED, REJECTED	Sim	Status do MED
origin	string (enum) - USER, ADMIN	Sim	Origem da abertura: USER quando aberto por você, ADMIN quando aberto pela operação
reason	string (enum) - SCAM, FRAUDULENT_ACCESS, OPERATIONAL_ERROR, OTHER	Sim	Motivo do MED
amount	number	Sim	Valor do MED (inteiro em centavos)
paymentMethod	string (enum) - PIX	Sim	Método de pagamento
payer	object	Não	Dados do pagador (ver Sub-Objeto AccountHolder)
receiver	object	Não	Dados do recebedor (ver Sub-Objeto AccountHolder)
message	string	Não	Mensagem informada na abertura
user	object	Sim	Dados do usuário (ver Sub-Objeto UserVo)
statusHistory	array	Sim	Histórico de status (ver Sub-Objeto StatusHistory)
medDate	string (ISO)	Sim	Data do MED
createdAt	string (ISO)	Sim	Data de criação
updatedAt	string (ISO)	Sim	Data da última atualização

Sub-Objetos

StatusHistory (item)

Campo	Tipo	Obrigatório	Descrição
status	string (enum) - PENDING, APPEALED, APPROVED, REJECTED	Sim	Status do MED no histórico
date	string (ISO)	Sim	Data do status
durationInMilliseconds	number	Sim	Duração do status em milissegundos

UserVo

Campo	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do usuário
email	string	Sim	E-mail do usuário
createdAt	string (ISO)	Sim	Data de criação do usuário

AccountHolder

Campo	Tipo	Obrigatório	Descrição
type	string (enum) - PF, PJ	Sim	Tipo do titular
name	string	Sim	Nome do titular
document	string	Sim	Documento do titular
bankAccount	object	Sim	Dados bancários (ver Sub-Objeto BankAccount)
pix	object	Sim	Chave PIX do titular (ver Sub-Objeto PixKeyVo)

BankAccount

Campo	Tipo	Obrigatório	Descrição
type	string	Sim	Tipo de conta
digit	string	Sim	Dígito da conta
ispb	string	Sim	ISPB do banco

PixKeyVo

Campo	Tipo	Obrigatório	Descrição
key	string	Sim	Chave PIX
type	string (enum) - CPF, CNPJ, EMAIL, PHONE, EVP	Sim	Tipo da chave PIX

Exemplo de Resposta

Dados mascarados

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

{
  "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": {
    "type": "PJ",
    "name": "Empresa Exemplo LTDA",
    "document": "12345678000199",
    "bankAccount": {
      "type": "CHECKING",
      "digit": "0",
      "ispb": "12345678"
    },
    "pix": {
      "key": "contato@exemplo.com",
      "type": "EMAIL"
    }
  },
  "receiver": {
    "type": "PF",
    "name": "Fulano de Tal",
    "document": "***456789**",
    "bankAccount": {
      "type": "CHECKING",
      "digit": "7",
      "ispb": "12345678"
    },
    "pix": {
      "key": "12345678910",
      "type": "CPF"
    }
  },
  "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
404	Registro não encontrado	Verifique o id informado
422	Dados inválidos ou faltando	Verifique o formato dos dados
422	Validações	Contate o suporte
500	Erro interno	Contate o suporte