---
title: "Dispute"
url: "https://devcenter.stone.com.br/apis/chargeback-api-v2026-02-01/versions/277b2a7a-855b-475c-a343-f67650befb83/schemas/Dispute"
---

> Full API specification: https://devcenter.stone.com.br/apis/chargeback-api-v2026-02-01/versions/277b2a7a-855b-475c-a343-f67650befb83.md

# Dispute

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Disputas
  version: v2026-02-01
servers:
  - url: https://api.stone.com.br
    description: production
  - url: https://sandbox.api.stone.com.br
    description: sandbox
components:
  schemas:
    Amount:
      type: object
      properties:
        amount:
          type: string
          example: "150.47"
        currencyCode:
          type: string
          example: BRL
    Event:
      type: object
      properties:
        type:
          type: string
          enum:
            - FIRST_CHARGEBACK
            - FIRST_CHARGEBACK_REVERSED
            - DISPUTE_NOTIFIED
            - MERCHANT_EVIDENCE_RECEIVED
            - EVIDENCE_ANALYSIS_ACCEPTED
            - EVIDENCE_ANALYSIS_DENIED
            - LOST_DISPUTE
          description: Tipo do evento relacionado à disputa.
        createdAt:
          type: string
          format: date-time
          description: Data da criação do evento.
    Dispute:
      type: object
      properties:
        disputeId:
          type: string
          description: ID único da disputa.
        transactionId:
          type: string
          description: ID da transação associada à disputa.
        chargeId:
          type: string
          description: ID da cobrança associada à disputa.
        createdAt:
          type: string
          format: date-time
          description: Data da criação da disputa.
        updatedAt:
          type: string
          format: date-time
          description: Data da última atualização da disputa.
        responseDeadline:
          type: string
          format: date-time
          description: Data limite para o envio de evidências por parte do lojista.
        chargebackAmount:
          allOf:
            - $ref: "#/components/schemas/Amount"
            - description: Valor do chargeback.
        debitedAmount:
          allOf:
            - $ref: "#/components/schemas/Amount"
            - description: Valor debitado do lojista.
        status:
          type: string
          enum:
            - WAITING_MERCHANT_EVIDENCES
            - WAITING_ACQUIRER_ANALYSIS
            - MERCHANT_EVIDENCE_DEADLINE_EXPIRED
            - WAITING_ISSUER
            - LOST
            - WON
            - DEADLINE_EXPIRED
            - REVERSED
          description: >
            Status atual da disputa.


            **Valores possíveis:**


            | Status | Code | Significado |

            |---|---|---|

            | `REVERSED` | 93 | Chargeback revertido — o valor contestado foi
            estornado ao lojista. |
        reason:
          type: object
          properties:
            code:
              type: string
              description: Código do motivo do chargeback.
            description:
              type: string
              enum:
                - FRAUD
                - PROCESSING_ERROR
                - COMMERCIAL_DISPUTE
                - AUTHORIZATION
              description: Descrição do motivo do chargeback.
          description: Motivo do pedido de chargeback.
        stage:
          type: string
          description: Estágio do ciclo de chargeback.
        cycle:
          type: string
          enum:
            - FIRST
            - SECOND
          description: >
            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`.
          example: FIRST
        cycleStatus:
          type: string
          enum:
            - RECEIVED
            - GUARANTEE_ANALYZED
            - EVIDENCE_RECEIVED
            - REPRESENTED
            - REVERSED
            - WON
            - LOST
            - EXPIRED
          description: >
            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`.
          example: RECEIVED
        network:
          type: string
          description: Bandeira do cartão.
        institution:
          type: string
          enum:
            - STONE
            - PAGAR.ME
          description: Instituição onde a transação foi processado.
        events:
          type: array
          items:
            $ref: "#/components/schemas/Event"
          description: Lista de eventos relacionados à disputa.
        guarantee:
          type: object
          description: >
            Resultado da análise de garantia da disputa. O campo é **omitido**
            da resposta

            quando a disputa não possui garantia — não é retornado como `null`.
          properties:
            status:
              type: string
              description: "Situação da garantia (ex.: `GUARANTEED`, `NOT_GUARANTEED`)."
              example: NOT_GUARANTEED
            reason:
              type:
                - string
                - "null"
              description: Motivo pelo qual a garantia foi negada. É `null` quando a disputa
                está garantida.
              example: deadline_expired
            updatedAt:
              type: string
              format: date-time
              description: Data da última atualização da análise de garantia. Omitido quando
                não informado.
              example: 2026-04-22T10:00:00Z
```