Abrir MED de Saque

Utilize este endpoint para abrir um MED referente a um saque, identificando-o pelo endToEnd.

Diferente dos MEDs de transação, que chegam pelo adquirente, este é aberto por você. Para consultar os MEDs de saque já abertos, use Listar MEDs de Saque.

Ambientes Disponíveis

Produção

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

Endpoint

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

Request Body

Nome	Tipo	Obrigatório	Descrição	Validações
endToEnd	string	Sim	Identificador end-to-end do saque contestado	Deve ter entre 8 e 255 caracteres
reasonStatus	string (enum) - SCAM, FRAUDULENT_ACCESS, OPERATIONAL_ERROR, OTHER	Sim	Motivo da abertura do MED	Deve ser um enum válido
message	string	Não	Mensagem descrevendo o caso	Deve ter entre 2 e 255 caracteres

Exemplo de Requisição

cURL

curl --request POST \
--url https://api.gateway.com.br/core/med/withdrawal \
--header 'Authorization: Bearer seu-token-jwt' \
--header 'Content-Type: application/json' \
--data '{
    "endToEnd": "E12345678202603061249abcdef0123",
    "reasonStatus": "OPERATIONAL_ERROR",
    "message": "Saque enviado para a chave errada"
}'

JavaScript

const response = await fetch('https://api.gateway.com.br/core/med/withdrawal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer seu-token-jwt',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    endToEnd: 'E12345678202603061249abcdef0123',
    reasonStatus: 'OPERATIONAL_ERROR',
    message: 'Saque enviado para a chave errada',
  })
});

Resposta de Sucesso

O endpoint responde 201 Created sem corpo. Use Listar MEDs de Saque para acompanhar o caso aberto.

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