Skip to main content
Uma disputa ocorre quando um comprador contesta uma cobrança. Na Linka, existem dois mecanismos distintos dependendo do método de pagamento: MED (Mecanismo Especial de Devolução do BACEN) para PIX e chargeback para cartão de crédito.

​
Tipos de Disputa

TipoMétodoOrigemVoluntario?
MED (PIX)PIXBACEN / banco do compradorNão — regulatorio
ChargebackCartãoBandeira / banco emissorNão — decidido pelo banco
Disputa manualQualquerAdmin da LinkaNão — iniciada internamente

​
Impacto Financeiro

Ao receber um chargeback ou MED:
  1. O status da transação muda para CHARGEDBACK
  2. O netAmount da transação e debitado imediatamente da wallet do seller
  3. Um MedDispute e criado automaticamente para rastreamento
  4. O seller recebe o evento DISPUTE_OPENED via webhook
O débito e imediato e automático. Se a wallet não tiver saldo suficiente, o saldo ficara negativo. Mantenha uma reserva para cobrir eventuais chargebacks.

​
Fluxo Completo

​
Contestando uma Disputa

Se você acredita que a disputa e indevida, pode contestar enviando evidencias para análise.
1

Identifique a disputa

Você recebera o evento DISPUTE_OPENED no webhook com o disputeId. Guarde este ID.
Evento DISPUTE_OPENED
{
  "eventType": "DISPUTE_OPENED",
  "signature": "hmac-v1-sha256-...",
  "id": "dispute_uuid_aqui",
  "amount": 15000,
  "status": "OPENED",
  "reason": "Comprador não reconhece a compra",
  "createdAt": "2026-04-09T14:00:00.000Z"
}
2

Envie o appeal com evidencias

Envie as evidencias via multipart/form-data. Sao aceitos até 10 arquivos por disputa.
cURL
curl -X POST https://api.linka.com/disputes/appeal \
  -H "Authorization: Bearer {seu_token}" \
  -F "disputeId=dispute_uuid_aqui" \
  -F "appealReason=Compra realizada pelo próprio titular. Temos nota fiscal e log de entrega." \
  -F "files[][email protected]" \
  -F "files[][email protected]"
Resposta 200
{
  "dispute": {
    "id": "dispute_uuid_aqui",
    "status": "APPEALED",
    "appealReason": "Compra realizada pelo próprio titular...",
    "updatedAt": "2026-04-09T15:00:00.000Z"
  },
  "uploadedFiles": 2
}
3

Aguarde a decisão

Após a análise, você recebera um dos seguintes eventos:
  • DISPUTE_RESOLVED — seller ganhou, saldo restaurado
  • DISPUTE_REJECTED — comprador ganhou, valor debitado permanentemente

​
Gerando URLs para Evidencias

Para visualizar os arquivos enviados, gere URLs temporarias (validas por 1 hora): 
curl -X POST https://api.linka.com/disputes/{id}/generate-file-urls \
  -H "Authorization: Bearer {seu_token}"
Resposta
{
  "files": [
    {
      "name": "nota-fiscal.pdf",
      "url": "https://s3.amazonaws.com/bucket/disputes/nota-fiscal.pdf?...",
      "expiresIn": 3600
    }
  ]
}

​
MED PIX — Detalhe

O MED (Mecanismo Especial de Devolução) e um mecanismo regulatorio do BACEN para devolver valores transferidos por engano ou fraude via PIX. Quando um evento de MED é recebido, a Linka:
  1. Marca a transação como CHARGEDBACK
  2. Cria um registro de disputa MED vinculado ao infractionReportId (quando disponível)
  3. Envia o evento MED_DISPUTE_CREATED para o seller
Evento MED_DISPUTE_CREATED
{
  "eventType": "MED_DISPUTE_CREATED",
  "signature": "hmac-v1-sha256-...",
  "id": "med_dispute_uuid",
  "status": "OPEN",
  "amount": 15000,
  "transactionId": "txn_uuid_aqui",
  "deadline": "2026-04-16T23:59:59.000Z",
  "end2EndId": "E12345678202604091200...",
  "createdAt": "2026-04-09T14:30:00.000Z"
}
O campo deadline indica o prazo regulatorio para resposta ao BACEN. Em casos com infractionReportId (MTBank), a Linka pode responder ao BACEN de forma bidirecional.

​
Status de Disputa

StatusDescrição
OPENDisputa criada, aguardando análise
UNDER_REVIEWEm análise pelo time da Linka
APPEALEDSeller enviou contestacao
RESOLVEDSeller ganhou — saldo restaurado
REJECTEDComprador ganhou — valor debitado

​
Eventos de Webhook

EventoQuando ocorre
DISPUTE_OPENEDDisputa aberta (chargeback recebido)
DISPUTE_RESOLVEDDecisão a favor do seller
DISPUTE_REJECTEDDecisão a favor do comprador
MED_DISPUTE_CREATEDMED PIX criado automaticamente
MED_REFUND_REQUESTEDSolicitacao de reembolso MED em andamento

​
Boas Práticas para Redução de Chargebacks

  • Mantenha descrições claras na transação que o comprador reconheca no extrato bancario
  • Salve logs de entrega, aceitacao de termos e confirmações de compra
  • Configure notificações por email para o comprador após o pagamento
  • Para valores altos, considere solicitar confirmação adicional do comprador
  • Responda disputas rapidamente — quanto antes o appeal chegar, mais dados você tem disponíveis