Disputas

Gerencie disputas de cobranças. Merchants podem contestar disputas e enviar evidências.

Abrir disputa

POST

/v1/disputes

Auth

Abre uma disputa para uma cobrança paga.

Body (JSON)

Parâmetro	Tipo	Obrigatório	Descrição
`chargeId`	UUID	Sim	ID da cobrança
`reason`	string	Sim	Motivo da disputa
`description`	string	Não	Descrição detalhada

Valores aceitos para reason:

PRODUCT_NOT_RECEIVED — Produto não recebido
PRODUCT_NOT_AS_DESCRIBED — Produto diferente do anunciado
DUPLICATE_CHARGE — Cobrança duplicada
UNRECOGNIZED_CHARGE — Cobrança não reconhecida
OTHER — Outro motivo

Listar disputas

GET

/v1/disputes

Auth

Retorna lista paginada de disputas do merchant.

Query params

Parâmetro	Tipo	Obrigatório	Descrição
`status`	string	Não	Filtrar por status
`page`	integer	Não	Página (padrão: 1)
`limit`	integer	Não	Itens por página (padrão: 20)

Detalhar disputa

GET

/v1/disputes/{id}

Auth

Retorna detalhes de uma disputa incluindo evidências e resposta do merchant.

Aceitar disputa

POST

/v1/disputes/{id}/accept

Auth

Merchant aceita a disputa. O valor será estornado ao comprador.

Resposta 200JSON

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "REFUNDED"
  }
}

Contestar disputa

POST

/v1/disputes/{id}/contest

Auth

Merchant contesta a disputa com uma resposta e evidências.

Body (JSON)

Parâmetro	Tipo	Obrigatório	Descrição
`response`	string	Sim	Resposta detalhada do merchant
`evidences`	string[]	Não	URLs de arquivos de evidência

Exemplobash

curl -X POST https://api.pagniv.com/v1/disputes/{id}/contest \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "response": "Produto entregue em 10/01. Código de rastreio: AB123456BR",
    "evidences": [
      "https://storage.example.com/comprovante-entrega.pdf"
    ]
  }'

Status de disputa

Status	Descrição
`OPEN`	Disputa aberta, aguardando resposta do merchant
`MERCHANT_RESPONDED`	Merchant contestou com evidências
`UNDER_REVIEW`	Em análise pela equipe Pagniv
`RESOLVED_MERCHANT`	Resolvida a favor do merchant
`RESOLVED_BUYER`	Resolvida a favor do comprador
`REFUNDED`	Valor estornado ao comprador