Contestações
Acompanhe pela API as contestações (chargebacks) abertas contra as suas vendas no cartão e responda a cada uma, aceitando ou enviando a sua defesa.
Como responder
Leia o valor, o motivo, o prazo e a fatura contestada, ou liste as que esperam resposta.
Aceitar uma contestaçãoEncerre a disputa sem defesa.
Defender uma contestaçãoEnvie a justificativa e um comprovante da venda.
Responda assim que receber o evento chargeback.received.
O prazo para responder vem em defense_deadline. Depois dele, o aceite e a defesa são recusados.
Origem e motivo
A contestação é o pedido do portador do cartão, feito pela bandeira, para desfazer uma compra. Ela chega da adquirente e só existe em pagamento no cartão. Um pagamento pode ter mais de uma. O motivo informado pela bandeira vem em dispute.
Ciclo de vida
Uma contestação aceita uma resposta só, aceite ou defesa, e só enquanto está received.
| Status | O que aconteceu | response |
|---|---|---|
received | A contestação chegou e aceita resposta. | null |
accepted | Foi aceita pela API. | action igual a accept |
accepted | Foi aceita fora da API ou encerrada por prazo vencido. | null |
defended | A defesa foi enviada. | action igual a defend, com a justificativa em note e o nome do arquivo em file_name |
accepted e defended não aceitam outra resposta. O resultado da defesa na bandeira não aparece na API.
Prazos
Quando defense_deadline passa sem resposta, a contestação pode passar a accepted com response: null. Essa mudança não dispara chargeback.responded: confira o status pela consulta.
Efeito na fatura e na assinatura
- Fatura: passa a
chargedbackquando a contestação chega no pagamento que a quitou, com a data embilling.chargedback_at, e não pode mais ser estornada. - Bloco
chargebackda fatura: traz oide ostatusda contestação mais recente. - Assinatura: se a fatura é de uma assinatura, a assinatura ativa é cancelada sempre, qualquer que seja a configuração da conta para estornos.
- Saldo: aceitar a contestação encerra a disputa a favor do portador, e o valor do pagamento é debitado do saldo da sua conta.
A assinatura cancelada passa a canceled, com cancellation.reason igual a invoice_chargeback, e as faturas em aberto dela são canceladas.
A assinatura cancelada por contestação não pode ser reativada.
Para voltar a cobrar o cliente, crie uma nova assinatura, como explica Reativar uma assinatura.
Eventos
- Contestação nova: sai
chargeback.received, com a contestação emdata.chargeback. Quando a contestação leva a fatura achargedback, sai juntoinvoice.chargedback, com a fatura já contestada. - Resposta registrada: sai
chargeback.responded, com a contestação emdata.chargeback. - Assinatura cancelada: sai
subscription.canceled, com a assinatura cancelada.
A lista de eventos está em Webhooks.