Pular para o conteúdo
Pagamentos

Buscar contestação por id

v1.0.0
GEThttps://api.growthaisystem.com/api/v1/disputes/{id}
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escopospayments.read

Lê uma contestação com a linha do tempo. Não traz o texto livre do processador nem o texto da defesa. Não altera nada nem consulta o processador.

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

  • idstringobrigatório
    • tamanho mín. 1

Respostas

6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

A contestação, com a linha do tempo informada pelo processador e a situação da defesa.

V1Dispute

  • idstring
  • typestring

    chargeback (cartão), pix_infraction (infração Pix, MED) ou unknown (tipo não informado).

    • um de"chargeback""pix_infraction""unknown"
  • statusstring

    open (aberta, aguardando resposta), under_review (em análise no processador) ou closed (concluída).

    • um de"open""under_review""closed"
  • outcomestring | null

    Resultado decidido pelo processador: upheld (valor devolvido ao pagador), dismissed (favorável ao vendedor) ou withdrawn (encerrada sem decisão).

    • um de"upheld""dismissed""withdrawn"
  • amountCentsinteger

    Valor contestado em centavos (BRL).

  • chargeIdstring | null

    Cobrança contestada; null quando o processador não a identifica.

  • deadlineAtstring (date-time) | null

    Prazo para responder; null quando o processador não informa.

    • regex "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579]…
  • createdAtstring (date-time)
    • regex "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579]…
  • concludedAtstring (date-time) | null
    • regex "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579]…

  • Linha do tempo informada pelo processador, da mais antiga para a mais nova. Só em GET /disputes/{id}; [] na lista.

    Cada item da lista

    • typestring
    • atstring (date-time)
      • regex "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579]…
  • responseStatusstring | null

    Situação da defesa enviada pelo painel: draft (rascunho), submitted (aguardando encaminhamento) ou forwarded (encaminhada ao processador).

    • um de"draft""submitted""forwarded"