Chargeback

A API de Chargeback do PagBank oferece aos estabelecimentos uma solução completa para a visualização e gerenciamento de chargebacks, permitindo maior controle sobre disputas de pagamentos. Compatível com um serviço omnichannel, a API pode ser utilizada para chargebacks originados tanto de transações online quanto presenciais.

Como funciona o Chargeback?

O chargeback ocorre quando um titular de cartão contesta uma transação junto ao emissor do cartão. As razões para a contestação podem incluir compras não reconhecidas, desacordos comerciais ou suspeitas de fraude. Quando um chargeback é iniciado, o PagBank notifica o estabelecimento e permite que ele acompanhe a disputa, forneça evidências e tome as ações necessárias dentro do prazo estipulado.

A API de Chargeback do PagBank disponibiliza dois principais serviços:

Notificações de recebimento de Chargeback

A API permite que o estabelecimento receba notificações automáticas sempre que um chargeback for registrado. Isso facilita a tomada de decisões rápidas e informadas.

Para receber notificações, a configuração da preferência CHARGEBACK deve estar ser habilitada através API de Notificações.

Após a configuração, o sistema enviará uma nova notificação automaticamente sempre que um chargeback for criado.

Notificações de alteração e conclusão de Chargeback

A API permite que o estabelecimento receba notificações automáticas sempre que houver uma alteração de status em um chargeback, incluindo sua conclusão. Isso proporciona maior visibilidade sobre a evolução do processo e permite acompanhar o ciclo de vida da contestação.

Para receber essas notificações, a preferência CHARGEBACK deve ser habilitada por meio da API de Notificações.

Após a configuração, o sistema enviará automaticamente uma nova notificação sempre que ocorrer uma atualização no chargeback, como mudança de status, definição de resultado ou encerramento do caso.

Consulta de Chargebacks

Esse serviço permite que o estabelecimento consulte os detalhes de um chargeback específico, garantindo acesso a informações como:

• Data do chargeback.
• Valor contestado.
• Motivo da disputa.
• Status atual da contestação.
• Detalhes da transação original.

Essa funcionalidade é disponibilizada através do endpoint Consultar Chargeback. Para utilizar o endpoint, você deve informar o id do chargeback desejado para receber as informações.

Disputa de Chargebacks

Esse serviço permite que o estabelecimento envie uma disputa para um chargeback em aberto, apresentando evidências e informações que possam comprovar a legitimidade da transação e apoiar a reversão da contestação.

Por meio desse processo, é possível encaminhar um documento, de acordo com as regras e prazos definidos.

Essa funcionalidade é disponibilizada através do endpoint Disputar Chargeback. Para utilizá-lo, você deve informar o id do chargeback e os dados necessários para a contestação. Após o envio, a disputa será registrada e o chargeback terá seu status atualizado para refletir o andamento da análise.

O resultado da disputa poderá ser acompanhado por meio dos serviços de consulta e das notificações de atualização de chargeback.

Pré-requisitos

Para utilizar a API de Chargeback, é necessário:

• Ter uma conta ativa no PagBank.
• Ter realizado transações válidas que possam passar pelo processo de chargeback.
• Configurar a API de Notificações com a preferência CHARGEBACK,caso deseje receber alertas automáticos.

Teste a API

O PagBank disponibiliza um ambiente de teste para facilitar o desenvolvimento e a integração da API. Esse ambiente permite simular chargebacks e testar a resposta da API antes do uso em produção. Para realizar esses testes, siga os passos abaixo:

1. Ative as notificações utilizando a API de Notificação. Para ativar, cadastre a preferência CHARGEBACK para receber notificações sempre que um chargeback for criado ou atualizado.
2. Crie uma transação de teste utilizando o endpoint Criar pedido utilizando os dados de um cartão específico de destes.
   1. Acesse e siga os passos do tutorial Criar e pagar um pedido com cartão.
   2. Ao realizar a requisição para o endpoint Criar pedido , utilize os seguintes dados de cartão de teste:
      • Número do cartão: 5293786598661295
      • Data de validade: 06/2030
      • Código de segurança: 432
      • Bandeira: Mastercard
3. Aguarde a notificação de chargeback, que será enviada automaticamente após a criação do pedido. O sistema do PagBank reconhecerá o cartão de teste específico e gerará o chargeback automaticamente para a transação criada.