Listar MEDs

curl --request GET \
  --url https://api.owem.com.br/v4/i/meds \
  --header 'Authorization: <authorization>'

{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "pagination": {
    "page": 1,
    "limit": 50,
    "orderBy": "desc",
    "total": 1,
    "totalPages": 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
      },
      "legalAnalysis": {
        "createdAt": 1766695686000,
        "createdBy": "[email protected]",
        "considerations": "Cliente comprovou que entregou o produto"
      }
    }
  ]
}

GET

https://api.owem.com.br

meds

Listar MEDs

curl --request GET \
  --url https://api.owem.com.br/v4/i/meds \
  --header 'Authorization: <authorization>'

{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "pagination": {
    "page": 1,
    "limit": 50,
    "orderBy": "desc",
    "total": 1,
    "totalPages": 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
      },
      "legalAnalysis": {
        "createdAt": 1766695686000,
        "createdBy": "[email protected]",
        "considerations": "Cliente comprovou que entregou o produto"
      }
    }
  ]
}

Finalidade

Retorna a lista de MEDs (Mecanismo Especial de Devolução) recebidos pela conta, com suporte a filtros e paginação. O MED é um mecanismo do Banco Central que permite a devolução de valores em casos de fraude ou falha operacional.

Autenticação

Authorization

string

obrigatório

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

Query Parameters

status

string

Filtrar por status do MED (under_analysis, accepted, rejected, etc.)

startDate

string

Data inicial (timestamp ms)

endDate

string

Data final (timestamp ms)

page

number

padrão:"1"

Página de resultados

limit

number

padrão:"50"

Quantidade de itens por página (máx. 100)

Resposta

requestId

string

UUID para rastreio

success

boolean

Status da operação

size

number

Quantidade de itens retornados

pagination

object

Mostrar pagination

page

number

Página atual

limit

number

Itens por página

orderBy

string

Ordenação (desc ou asc)

total

number

Total de registros

totalPages

number

Total de páginas

data

array

Array de MEDs

Mostrar item

endToEndId

string

Identificador E2E da transação PIX original

medId

string

Identificador único do MED

createdInfractionAt

number

Timestamp de criação da infração (ms)

pspCreatorName

string

Nome da instituição que criou o MED

payer

object

Dados do pagador (quem contestou)

receiver

object

Dados do recebedor (sua conta)

details

string

Descrição do motivo da contestação

grossAmount

number

Valor bruto contestado

feeAmount

number

Tarifa aplicada

netAmount

number

Valor líquido

transactionCreatedAt

number

Timestamp da transação original (ms)

userId

string

ID do usuário afetado

status

string

Status do MED (under_analysis, accepted, rejected)

defense

object

Dados da defesa enviada (se houver)

deadlines

object

Prazos importantes

legalAnalysis

object

Análise jurídica (se houver)

{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "pagination": {
    "page": 1,
    "limit": 50,
    "orderBy": "desc",
    "total": 1,
    "totalPages": 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
      },
      "legalAnalysis": {
        "createdAt": 1766695686000,
        "createdBy": "[email protected]",
        "considerations": "Cliente comprovou que entregou o produto"
      }
    }
  ]
}

Códigos de Status

HTTP	Descrição
200	Listagem retornada
400	Parâmetro inválido
401	Credenciais inválidas
403	IP não allowlisted
429	Rate limit excedido
500	Erro interno

Status do MED

Status	Descrição
`under_analysis`	MED em análise
`accepted`	MED aceito (valor devolvido)
`rejected`	MED rejeitado (valor mantido)

MEDs têm prazo de defesa. Verifique o campo deadlines.defenseDeadLine e envie sua defesa antes do prazo expirar.

Configure um webhook para med:received para ser notificado imediatamente quando um novo MED for recebido.

Excluir Webhook

Enviar Defesa de MED

⌘I

Visão Geral

Autenticação

Conta Bancária

Ledger

PIX IN

PIX OUT

Webhooks

MEDs

Listar MEDs

Finalidade

Autenticação

Query Parameters

Resposta

Códigos de Status

Status do MED

Visão Geral

Autenticação

Conta Bancária

Ledger

PIX IN

PIX OUT

Webhooks

MEDs

​Finalidade

​Autenticação

​Query Parameters

​Resposta

​Códigos de Status

​Status do MED

Finalidade

Autenticação

Query Parameters

Resposta

Códigos de Status

Status do MED