Guia de Chargeback

Confira o guia de chargeback para mais informações.

Este endpoint permite criar uma disputa para um chargeback já registrado no Asaas, enviando documentos e evidências que serão utilizados durante o processo de análise.

A disputa é o mecanismo utilizado para contestar formalmente um chargeback junto à adquirente ou instituição responsável pela transação.

Ao criar uma disputa, a documentação enviada passa a compor o processo de análise do caso e poderá ser utilizada para validar a legitimidade da cobrança contestada.

Quando utilizar

Este endpoint deve ser utilizado quando:

• Um chargeback foi aberto para uma cobrança.
• Existe documentação que comprove a legitimidade da transação.
• O estabelecimento deseja contestar a contestação realizada pelo portador do cartão.
• Há evidências que demonstrem a entrega do produto ou prestação do serviço.

A criação da disputa representa a oportunidade de apresentar evidências para reverter o chargeback.

Dependências para utilização

Antes de criar uma disputa, é necessário que:

1. O chargeback já exista.
2. O identificador do chargeback esteja disponível.
3. O chargeback permita abertura de disputa.
4. Os documentos comprobatórios estejam disponíveis para envio.

Sem essas condições, a disputa não poderá ser criada.

Parâmetros utilizados

📘

Importante

O parâmetro id corresponde ao identificador do chargeback e não ao identificador da cobrança original.

Arquivos aceitos

A disputa é criada através do envio de documentos comprobatórios.

Alguns exemplos de evidências frequentemente utilizadas são:

• Comprovantes de entrega.
• Comprovantes de prestação de serviço.
• Contratos assinados.
• Conversas ou comunicações autorizando a compra.
• Comprovantes de aceite.
• Documentos de identificação do comprador.

O endpoint permite o envio de até 11 arquivos por disputa.

🚧

Atenção

Quanto mais completas forem as evidências apresentadas, maiores as chances de uma análise adequada do caso.

Comportamento da operação

Ao criar uma disputa:

Chargeback aberto
↓
Envio das evidências
↓
Disputa criada
↓
Análise da documentação
↓
Resultado da disputa

A criação da disputa não garante a reversão do chargeback.

O resultado depende da análise realizada pelas instituições envolvidas no processo.

Exemplo de requisição

POST /v3/chargebacks/{id}/dispute

Exemplo:

POST /v3/chargebacks/cb_123456/dispute

Exemplo de envio multipart:

Content-Type: multipart/form-data

files=documento1.pdf
files=comprovante-entrega.jpg
files=contrato.pdf

Boas práticas

• Envie evidências claras e legíveis.
• Priorize documentos diretamente relacionados à transação contestada.
• Reúna toda a documentação necessária antes de criar a disputa.
• Evite o envio de arquivos duplicados.
• Mantenha cópia interna dos documentos enviados para auditoria futura.

📘

Importante

Após o envio da disputa, recomenda-se acompanhar a evolução do chargeback para verificar eventuais atualizações de status.

Erros comuns

Chargeback não encontrado

Ocorre quando o identificador informado não existe ou não pertence à conta autenticada.

Chargeback não elegível para disputa

Ocorre quando o chargeback não permite mais abertura de contestação.

Limite de arquivos excedido

Ocorre quando a quantidade máxima de arquivos permitidos é ultrapassada.

Arquivos inválidos

Ocorre quando um ou mais documentos enviados não podem ser processados.

Impactos operacionais

A disputa faz parte do fluxo oficial de contestação de chargebacks.

Caso nenhuma evidência seja enviada dentro dos prazos aplicáveis, a chance de reversão do chargeback pode ser reduzida.

Por esse motivo, recomenda-se automatizar o envio das evidências sempre que possível e manter processos internos para coleta rápida da documentação necessária.

Fluxo recomendado

Uma integração típica segue o fluxo abaixo:

Receber notificação de chargeback
↓
Consultar informações do chargeback
↓
Reunir evidências
↓
Criar disputa
↓
Acompanhar resultado da análise

Próximos passos

Dependendo da necessidade da integração, os conteúdos abaixo podem complementar a implementação:

• Consultar chargeback.
• Listar chargebacks.
• Consultar cobranças.
• Webhooks de cobrança.