> ## Documentation Index
> Fetch the complete documentation index at: https://docs.z2pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Buscar chargeback por ID

> Retorna uma contestação específica pelo seu ID, com a etapa atual, o prazo de defesa e o desfecho.

`GET /chargebacks/:id`

Faz parte do recurso [Chargebacks](/pt-BR/chargebacks) — as etapas do caso, o efeito no seu saldo e
a janela de defesa estão lá.

<Note>
  **Os documentos não vêm aqui.** A resposta traz o caso, não o material de contestação já enviado —
  para isso há [`GET /chargebacks/:id/documents`](/pt-BR/chargebacks/documents). O campo que interessa
  nesta resposta é o `deadlineAt`: é ele que diz até quando ainda dá para enviar prova.
</Note>


## OpenAPI

````yaml openapi/psp.json GET /chargebacks/{id}
openapi: 3.0.3
info:
  title: Z2Pay PSP API
  version: 1.0.0
  description: API pública do PSP — autenticação via API Key (Credential)
servers:
  - url: https://api.sandbox.z2pay.com/v1
    description: Sandbox
  - url: https://api.z2pay.com/v1
    description: Produção
security: []
tags:
  - name: Cards
    description: Cartões salvos de um cliente
  - name: Chargebacks
    description: Gerenciamento de chargebacks
  - name: Customers
    description: Gerenciamento de clientes (compradores)
  - name: Fees
    description: Tabela de taxas da conta (pix, boleto, cartão, saque, refund, chargeback)
  - name: Recipients
    description: Gerenciamento de recebedores (sellers/merchants que recebem repasses)
  - name: Refunds
    description: Gerenciamento de reembolsos e estornos
  - name: Splits
    description: Regras de divisão do valor de uma venda entre recebedores
  - name: Transactions
    description: Gerenciamento de transações e payments
  - name: Wallets
    description: Saldo, extrato e resumo da carteira de um recebedor, agrupados por moeda
  - name: Webhooks
    description: Configuração, gerenciamento e histórico de entregas de webhooks
  - name: Withdrawals
    description: Solicitação e acompanhamento de saques (payouts) por recipient
paths:
  /chargebacks/{id}:
    get:
      tags:
        - Chargebacks
      summary: Buscar chargeback por ID
      description: Retorna os dados de um chargeback específico.
      operationId: ChargebackController_getById
      parameters:
        - name: id
          in: path
          required: true
          description: ID do chargeback
          schema:
            type: string
      responses:
        '200':
          description: Dados do chargeback
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Identificador único do registro.
                  transactionId:
                    type: string
                    description: ID da transação relacionada ao registro.
                  paymentId:
                    type: string
                    description: ID do pagamento relacionado ao registro.
                  externalId:
                    type: string
                    nullable: true
                    description: Identificador do chargeback no sistema do adquirente/PSP.
                  amount:
                    type: integer
                    description: Valor em centavos.
                  currency:
                    type: string
                    description: 'Moeda no padrão ISO 4217 (ex.: BRL).'
                  status:
                    type: string
                    description: >-
                      Situação da contestação. Valores: `opened`,
                      `under_review`, `submitted`, `won`, `lost`.
                  reasonCode:
                    type: string
                    nullable: true
                    description: Código do motivo do chargeback informado pela bandeira.
                  reason:
                    type: string
                    nullable: true
                    description: Motivo informado para a operação.
                  deadlineAt:
                    type: string
                    format: date-time
                    nullable: true
                    description: >-
                      Data e hora limite para envio da defesa do chargeback (ISO
                      8601).
                  openedAt:
                    type: string
                    format: date-time
                    nullable: true
                    description: Data e hora em que o chargeback foi aberto (ISO 8601).
                  resolvedAt:
                    type: string
                    format: date-time
                    nullable: true
                    description: Data e hora em que o chargeback foi resolvido (ISO 8601).
                  createdAt:
                    type: string
                    format: date-time
                    description: Data e hora de criação do registro (ISO 8601).
                  updatedAt:
                    type: string
                    format: date-time
                    description: Data e hora da última atualização do registro (ISO 8601).
              example:
                id: cbk_v5wylkgvv2rls5tihmuybrz9v
                transactionId: txn_aqbcw2lky42xfidw5pcdss8h1
                paymentId: pay_jxt9b5qv1x0h0h8ustleqjgr8
                externalId: ch_mw198ybczrn8y2fd6y7dnznft
                amount: 14990
                currency: BRL
                status: under_review
                reasonCode: '4853'
                reason: Produto ou serviço não recebido
                deadlineAt: '2025-07-06T23:59:59.000Z'
                openedAt: '2025-06-29T10:00:00.000Z'
                resolvedAt: null
                createdAt: '2025-06-29T10:00:05.000Z'
                updatedAt: '2025-06-29T10:00:10.000Z'
        '401':
          description: Chave de API ausente, malformada ou inválida
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: >-
                          Identificador estável do erro. É por ele que você deve
                          ramificar, não pela mensagem.
                      message:
                        type: string
                        description: >-
                          Descrição legível. Pode mudar sem aviso e não deve ser
                          usada em condicional.
              example:
                error:
                  code: UNAUTHORIZED
                  message: Invalid API key
        '404':
          description: Chargeback não encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: >-
                          Identificador estável do erro. É por ele que você deve
                          ramificar, não pela mensagem.
                      message:
                        type: string
                        description: >-
                          Descrição legível. Pode mudar sem aviso e não deve ser
                          usada em condicional.
              example:
                error:
                  code: NOT_FOUND
                  message: Chargeback not found
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key da Credential (gerada no Backoffice)

````