Pular para o conteúdo principal
POST
https://api.owem.com.br
/
v4
/
i
/
meds
/
{medId}
/
defense
Enviar Defesa de MED
curl --request POST \
  --url https://api.owem.com.br/v4/i/meds/{medId}/defense \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "files": [
    {}
  ]
}
'
{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "data": {
    "endToEndId": "E123456789202512240000000000001",
    "medId": "med_12345678-abcd-efgh-ijkl-123456789abc",
    "createdInfractionAt": 1766523042000,
    "pspCreatorName": "OUTRA INSTITUICAO DE PAGAMENTO LTDA.",
    "payer": {
      "ispb": "12345678",
      "personType": "person",
      "cpfCnpj": "XXX123456XX",
      "name": "JOAO DA SILVA",
      "agency": "0001",
      "accountType": "savings",
      "accountNumber": "123456"
    },
    "details": "Transação contestada pelo usuário pagador",
    "feeAmount": 0,
    "netAmount": 0,
    "grossAmount": 150.0,
    "transactionCreatedAt": 1766436642000,
    "receiver": {
      "ispb": "87654321",
      "personType": "company",
      "agency": "0001",
      "accountType": "checking",
      "name": "MINHA EMPRESA LTDA",
      "cpfCnpj": "XX123456000XXX",
      "accountNumber": "987654321012"
    },
    "userId": "usr_abc123def",
    "status": "under_analysis",
    "defense": {
      "description": "Segue anexo todos os comprovantes da negociação com o cliente",
      "createdAt": 1766609442000,
      "files": ["https://storage.owem.com.br/files/defense-001.pdf"]
    },
    "deadlines": {
      "defenseDeadLine": 1766782086000
    }
  }
}

​
Finalidade

Envia a defesa para um MED recebido. A defesa deve incluir uma descrição e pode conter arquivos de comprovação.
A defesa deve ser enviada antes do prazo indicado em deadlines.defenseDeadLine. Após o prazo, a defesa não será aceita.

​
Autenticação

​
Authorization
string
obrigatório
Basic Auth obrigatório no formato: Basic {Base64(API_KEY:API_SECRET)}

​
Path Parameters

​
medId
string
obrigatório
Identificador único do MED

​
Request Body

​
description
string
obrigatório
Descrição da defesa, explicando o contexto da transação
​
files
array
Array de URLs de arquivos de comprovação (notas fiscais, comprovantes de entrega, conversas, etc.)

​
Resposta

​
requestId
string
UUID para rastreio
​
success
boolean
Status da operação
​
size
number
Quantidade de itens retornados
​
data
object
MED atualizado com a defesa
{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "data": {
    "endToEndId": "E123456789202512240000000000001",
    "medId": "med_12345678-abcd-efgh-ijkl-123456789abc",
    "createdInfractionAt": 1766523042000,
    "pspCreatorName": "OUTRA INSTITUICAO DE PAGAMENTO LTDA.",
    "payer": {
      "ispb": "12345678",
      "personType": "person",
      "cpfCnpj": "XXX123456XX",
      "name": "JOAO DA SILVA",
      "agency": "0001",
      "accountType": "savings",
      "accountNumber": "123456"
    },
    "details": "Transação contestada pelo usuário pagador",
    "feeAmount": 0,
    "netAmount": 0,
    "grossAmount": 150.0,
    "transactionCreatedAt": 1766436642000,
    "receiver": {
      "ispb": "87654321",
      "personType": "company",
      "agency": "0001",
      "accountType": "checking",
      "name": "MINHA EMPRESA LTDA",
      "cpfCnpj": "XX123456000XXX",
      "accountNumber": "987654321012"
    },
    "userId": "usr_abc123def",
    "status": "under_analysis",
    "defense": {
      "description": "Segue anexo todos os comprovantes da negociação com o cliente",
      "createdAt": 1766609442000,
      "files": ["https://storage.owem.com.br/files/defense-001.pdf"]
    },
    "deadlines": {
      "defenseDeadLine": 1766782086000
    }
  }
}

​
Códigos de Status

HTTPDescrição
200Defesa enviada com sucesso
400Payload inválido
401Credenciais inválidas
403IP não allowlisted
404MED não encontrado
409Defesa já enviada
422Prazo de defesa expirado
429Rate limit excedido
500Erro interno

​
Exemplo de Request

{
  "description": "Segue anexo todos os comprovantes da negociação com o cliente. A entrega foi realizada em 20/12/2025 conforme protocolo #12345.",
  "files": [
    "https://storage.exemplo.com/nota-fiscal.pdf",
    "https://storage.exemplo.com/comprovante-entrega.pdf",
    "https://storage.exemplo.com/conversa-cliente.pdf"
  ]
}
Inclua o máximo de comprovações possíveis: notas fiscais, comprovantes de entrega, conversas com o cliente, rastramento de entregas, etc.
Após enviar a defesa, o status do MED permanece under_analysis até que a análise seja concluída pela instituição que criou o MED.