PApagar
Disputas

Consulta uma disputa específica

get/v1/disputes/{dispute_id}

Request

  • Base URL
    https://api.stone.com.br
  • URL
    https://api.stone.com.br/v1/disputes/{dispute_id}
  • Auth
    none declared

Path parameters

dispute_idstring required

ID único da disputa.

Response

Detalhes da disputa encontrados.

disputeIdstring

ID único da disputa.

transactionIdstring

ID da transação associada à disputa.

chargeIdstring

ID da cobrança associada à disputa.

createdAtstring date-time

Data da criação da disputa.

updatedAtstring date-time

Data da última atualização da disputa.

responseDeadlinestring date-time

Data limite para o envio de evidências por parte do lojista.

status'WAITING_MERCHANT_EVIDENCES' | 'WAITING_ACQUIRER_ANALYSIS' | 'MERCHANT_EVIDENCE_DEADLINE_EXPIRED' | 'WAITING_ISSUER' | 'LOST' | 'WON' | 'DEADLINE_EXPIRED' | 'REVERSED'

Status atual da disputa.

Valores possíveis:

StatusCodeSignificado
REVERSED93Chargeback revertido — o valor contestado foi estornado ao lojista.
stagestring

Estágio do ciclo de chargeback.

cycle'FIRST' | 'SECOND'

Ciclo de chargeback em que a disputa está. O campo é omitido da resposta para disputas coletadas antes de o ciclo passar a ser registrado — não é retornado como null.

cycleStatus'RECEIVED' | 'GUARANTEE_ANALYZED' | 'EVIDENCE_RECEIVED' | 'REPRESENTED' | 'REVERSED' | 'WON' | 'LOST' | 'EXPIRED'

Status da disputa dentro do ciclo atual. É independente de status, que acompanha o ciclo de vida da disputa como um todo. O campo é omitido da resposta para disputas coletadas antes de o ciclo passar a ser registrado — não é retornado como null.

networkstring

Bandeira do cartão.

institution'STONE' | 'PAGAR.ME'

Instituição onde a transação foi processado.

Example response

{
  "chargebackAmount": {
    "amount": "150.47",
    "currencyCode": "BRL"
  },
  "debitedAmount": {
    "amount": "150.47",
    "currencyCode": "BRL"
  },
  "cycle": "FIRST",
  "cycleStatus": "RECEIVED",
  "guarantee": {
    "status": "NOT_GUARANTEED",
    "reason": "deadline_expired",
    "updatedAt": "2026-04-22T10:00:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.