1. Disputas e MEDs
Dotfy - Documentação
  • Dotfy Module
    • Raiz
      • Conta (Dados do Seller)
        • Identificar a conta (dados do seller)
      • Cobranças PIX
        • Criar cobrança PIX
        • Listar cobranças
        • Consultar cobrança por correlationID
        • Histórico de webhooks de uma cobrança
      • Cartão (Checkout Transparente)
        • Criar pagamento com cartão (PAN via API)
      • Saldo
        • Consultar saldo
      • Saques e Chaves PIX
        • Listar chaves PIX cadastradas
        • Cadastrar chave PIX
        • Listar saques
        • Solicitar saque
        • Cancelar saque pendente
      • Clientes
        • Listar clientes
        • Detalhe de um cliente
      • Produtos e Links de Pagamento
        • Links de compra por comprador (Purchase Links)
          • Criar link de compra (por comprador)
          • Listar links de compra do produto
          • Detalhe/status do link de compra
          • Revogar link de compra
        • Listar produtos
        • Criar produto
        • Detalhe do produto
        • Carrinhos abandonados do produto
      • Splits
        • Analytics de splits enviados
        • Splits recebidos
      • Disputas e MEDs
        • Listar disputas
          GET
        • Listar MEDs com estatísticas
          GET
        • Evidências de uma disputa
          GET
        • Histórico de uma disputa
          GET
      • Subcontas White-Label (BaaS)
        • Criar subconta
        • Listar subcontas
        • Detalhe da subconta
        • Atualizar subconta
        • Excluir subconta (soft delete)
        • Enviar KYC da subconta (multipart)
        • Consultar status do KYC da subconta
        • Cadastrar chave PIX da subconta
        • Listar chaves PIX da subconta
        • Remover chave PIX da subconta
        • Criar cobrança da subconta
        • Listar cobranças da subconta
        • Detalhe de cobrança da subconta
        • Saldo da subconta
        • Extrato (transações) da subconta
        • Solicitar saque da subconta
        • Listar saques da subconta
        • Atualizar taxas da subconta
      • Webhooks (Gerenciar Endpoints)
        • Listar endpoints
        • Criar endpoint
        • Atualizar endpoint
        • Remover endpoint
      • Webhooks (Eventos Recebidos)
        • EVENT:CHARGE_CREATED — cobrança criada
        • EVENT:CHARGE_PAID — cobrança paga (atualização principal)
        • EVENT:CHARGE_EXPIRED — cobrança expirada
        • EVENT:SPLIT_RECEIVED — você recebeu um split
        • EVENT:DISPUTE_OPENED — MED/disputa aberta
        • EVENT:DISPUTE_WON — disputa ganha
        • EVENT:DISPUTE_LOST — disputa perdida
        • EVENT:DISPUTE_CANCELED — disputa cancelada
        • EVENT:WITHDRAWAL_COMPLETED — saque concluído
        • EVENT:WITHDRAWAL_FAILED — saque falhou
        • EVENT:SUBACCOUNT_KYC_APPROVED — KYC da subconta aprovado
        • EVENT:SUBACCOUNT_KYC_REJECTED — KYC da subconta recusado
        • EVENT:SUBACCOUNT_PIX_KEY_APPROVED — chave PIX da subconta aprovada
        • EVENT:SUBACCOUNT_PIX_KEY_REJECTED — chave PIX da subconta recusada
      • Notificações
        • Listar notificações
      • Dashboard / Analytics
        • Stats gerais
        • Atividade recente
        • Atividade (timeline)
        • Receita por período
        • Volume por período
        • Taxa de conversão
        • Métodos de pagamento
        • Transações (gráfico)
        • Analytics avançado
  1. Disputas e MEDs

Listar MEDs com estatísticas

GET
/api/meds

Autenticação#

Esta rota exige Bearer Token (sua API Key) no header. Envie EXATAMENTE assim:
Substitua o valor após Bearer pela sua API Key real (vk_live_* produção, vk_test_* sandbox). Crie a chave em https://app.dotfy.com.br/dashboard/chaves-api. Sem o header → 401. Com chave inválida/revogada → 401. Com chave sem o escopo necessário → 403 insufficient_scope.

Subset de disputas do tipo MED com métricas agregadas (total ativo, total resolvido, etc).

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header

Respostas

🟢200
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/meds' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
  "meds": [
    {
      "id": "MED-ABC12345",
      "internalId": "cldisp0001",
      "transactionId": "E1823612020260501s00abc",
      "correlationId": "dotfy-1714000000000-abc12345",
      "endToEndId": "E1823612020260501s00abc",
      "customer": "Maria Silva",
      "customerEmail": "maria@exemplo.com",
      "reason": "Compra não reconhecida pelo cliente",
      "amount": 500,
      "status": "aguardando_defesa",
      "defenseStatus": "NO_DEFENSE",
      "defenseStatusLabel": "Aguardando sua defesa",
      "createdAt": "2026-05-01T10:00:00.000Z",
      "deadline": "2026-05-04T23:59:59.000Z",
      "daysRemaining": 2,
      "hasEvidence": false,
      "evidenceCount": 0,
      "evidences": [],
      "origin": "woovi",
      "pixKey": "12345678000190",
      "canSubmitDefense": true,
      "defenseSubmittedAt": null,
      "payerName": "Maria Silva",
      "payerTaxId": "12345678901",
      "provider": "WOOVI"
    }
  ],
  "stats": {
    "pending": 3,
    "analyzing": 1,
    "won": 5,
    "lost": 1,
    "totalDisputed": 2000
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 9,
    "pages": 1
  }
}
Modificado em 2026-07-02 06:57:27
Página anterior
Listar disputas
Próxima página
Evidências de uma disputa
Built with