PayZu GatewayEstornos e contestações

Contestações


Nesta páginaComo responderOrigem e motivoCiclo de vidaPrazosEfeito na fatura e na assinaturaEventos

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.

Fluxo da contestação: o portador contesta pela bandeira, a fatura passa a chargedback e a contestação chega received, quando aceita uma resposta só; ela termina accepted, por aceite ou prazo vencido, ou defended, com a defesa enviada

Como responder

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.

StatusO que aconteceuresponse
receivedA contestação chegou e aceita resposta.null
acceptedFoi aceita pela API.action igual a accept
acceptedFoi aceita fora da API ou encerrada por prazo vencido.null
defendedA 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 chargedback quando a contestação chega no pagamento que a quitou, com a data em billing.chargedback_at, e não pode mais ser estornada.
  • Bloco chargeback da fatura: traz o id e o status da 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 em data.chargeback. Quando a contestação leva a fatura a chargedback, sai junto invoice.chargedback, com a fatura já contestada.
  • Resposta registrada: sai chargeback.responded, com a contestação em data.chargeback.
  • Assinatura cancelada: sai subscription.canceled, com a assinatura cancelada.

A lista de eventos está em Webhooks.