HomeGuiaAPI ReferenceNovidadesComunidade
API Reference

Objeto Chargeback

Esse objeto apresenta todos os dados disponíveis ao receber a notificação de atualização ou consultar um chargeback.

id String (41 caracteres)
Identificador único do chargeback.
Exemplo: CBKS_3EA3FC40-192C-A6BB-ACA0-B3DAFA537DF6

created_at Datetime
Data e hora de criação do chargeback.
Exemplo: 2024-02-14T15:58:09

updated_at Datetime
Data e hora da última atualização do chargeback.
Exemplo: 2024-05-20T00:00:00

due_date Datetime
Data de vencimento do chargeback.
Exemplo: 2024-02-21T00:00:00

amount Object

Contém informações sobre o valor contestado.

value Int (9 caracteres)
Valor contestado (valor do chargeback).
Exemplo: 500

currency String (3 caracteres)
Moeda do valor contestado.
Exemplo: BRL

classification String (50 caracteres)
Classificação do tipo de disputa.
Exemplos:

  • NOT_RECOGNIZED: Não reconhece a transação. Ocorre quando o titular do cartão identifica um lançamento desconhecido em sua fatura e entra em contato com o emissor para questioná-lo.
  • DISAGREEMENT: Desacordo comercial. Refere-se a disputas decorrentes do não cumprimento dos termos acordados na transação, como a não entrega do produto ou serviço, divergências entre o que foi recebido e o que foi prometido, cobranças indevidas ou ausência de reembolso após um cancelamento.
  • REPORT: Reporte de fraude. Indica suspeita de fraude ou atividades potencialmente fraudulentas, como transações não autorizadas pelo titular do cartão ou alertas de segurança relacionados ao uso indevido dos dados de pagamento.

reason_code String (10 caracteres)
Código de motivo da disputa.
Exemplo: 4850

issuer_comment String (200 caracteres)
Comentário do emissor relacionado à disputa.
Exemplo: Portador Francisco Matos

cycle String (10 caracteres)
Ciclo relacionado ao chargeback.
Exemplo: 1

status String (50 caracteres)
Estado atual da disputa.
Exemplos:

  • AWAITING_EVIDENCE: Chargeback em processo de resolução pelo vendedor.
  • REVIEW_WITH_PAGBANK: Chargeback respondido pelo vendedor, aguardando avaliação do PagBank.
  • SUBMITTED_ISSUER: Defesa enviada ao emissor do cartão.
  • APPROVED: Comprovantes aceitos.
  • DENIED: Comprovantes não aceitos.
  • EXPIRED: Resposta não enviada dentro do prazo.
  • CLOSED: Débito da contestação aceito.
  • WON: Emissor acatou a representação.
  • LOST: Emissor recusou a representação.

transaction Object

Contém informações detalhadas da transação relacionada ao chargeback.

date Datetime
Data e hora da transação.
Exemplo: 2024-02-14T14:52:28

customer_name String (200 caracteres)
Nome do cliente da transação.
Exemplo: Roberto Freitas

customer_email String (200 caracteres)
Email do cliente da transação.
Exemplo: [email protected]

amount Int (9 caracteres)
Valor bruto da transação.
Exemplo: 500

installments Int (2 caracteres)
Número de parcelas da transação.
Exemplo: 1

installment_amount Int (9 caracteres)
Valor de cada parcela da transação.
Exemplo: 500

soft_descriptor String (22 caracteres)
Descrição da transação.
Exemplo: Loja 2

masked_card_number String (20 caracteres)
Número do cartão mascarado utilizado na transação.
Exemplo: 523284******3220

brand String (20 caracteres)
Bandeira do cartão utilizado na transação.
Exemplo: MASTERCARD

arn String (50 caracteres)
Número de referência de autorização.
Exemplo: 05494804060293880489132

tid String (50 caracteres)
ID de transação.
Exemplo: FCDB004101A4448B9C497A3795E4ADB9

nsu String (20 caracteres)
Número de controle de rede (NSU) da transação.
Exemplo: 021437924648

authorization_code String (20 caracteres)
Código de autorização da transação.
Exemplo: 018441

reference_id String (64 caracteres)
ID de referência da transação (ex: Pedido 123).
Exemplo: Referência da cobrança

links Object

Contém as informações de links relacionados ao recurso.

rel ENUM
Indica o tipo de relacionamento ao recurso.
Exemplo: SELF

href String (2048 caracteres)
Endereço HTTP do recurso.
Exemplo: https://sandbox.api.pagseguro.com/chargebacks/CBKS_418EFEA9-A957-4949-92E3-13588AB4B496/disputes"

media String (64 caracteres)
Tipo de mídia ao qual o link responde ou aceita.
Exemplo: application/json

type ENUM
Define o método que deve ser utilizado ao fazer uma consulta ao link definido por href
Valores de ENUM:

  • GET
  • POST
  • DELETE
  • PUT

© 1996- Todos os direitos reservados.

PAGSEGURO INTERNET INSTITUIÇÃO DE PAGAMENTO S/A - CNPJ/MF 08.561.701/0001-01

Av. Brigadeiro Faria Lima, 1.384, São Paulo - SP - CEP 01451-001