Cancelamento

ℹ️

Consulte a Referência da API para acessar os exemplos completos de requisição e resposta.

O cancelamento é uma funcionalidade que permite ao lojista estornar um pedido de compra. Ele pode ser solicitado em casos como indisponibilidade de estoque, desistência do comprador ou outras necessidades operacionais.

Na API Cielo E-commerce é possível realizar a requisição de cancelamento para cartões de débito e crédito.

Quando é possível cancelar uma transação

A disponibilidade do cancelamento depende do status da transação:

• Transações autorizadas e não capturadas (status 1 – Authorized)

O cancelamento pode ser solicitado antes de ocorrer o desfazimento automático da transação.

• Transações capturadas (status 2 – PaymentConfirmed)

O cancelamento pode ser solicitado a partir de D+1 da captura e em até 360 dias após a autorização da venda.

A aprovação do cancelamento depende do saldo disponível na agenda financeira do lojista e da aprovação do banco emissor do cartão.

Como o cancelamento é processado

Para cancelar a mesma transação mais de uma vez, é necessário aguardar 5 segundos entre cada solicitação, permitindo a atualização de saldo e a sensibilização da agenda financeira.

Essa regra vale para cancelamentos totais e parciais.

Para identificar operações aplicadas à mesma transação, são avaliados o número do EC, número da autorização, data da venda, valor da venda e NSU.

⚠️

Atenção

Para realizar qualquer solicitação de cancelamento, o estabelecimento deve possuir saldo suficiente na transação e na agenda financeira.

Cancelamento parcial e total

O cancelamento parcial permite estornar apenas uma parte do valor autorizado e capturado. Esse tipo de cancelamento só está disponível quando a transação é criada com Payment.Capture = "true".

• Para cartões de crédito, o cancelamento parcial pode ser solicitado mais de uma vez, até que o valor total da venda seja cancelado.
• Para cartões de débito, o cancelamento parcial é permitido uma única vez.

Para solicitar o cancelamento parcial, envie o campo Amount com o valor que deseja estornar.

Para o cancelamento total, envie o campo Amount com o valor integral autorizado ou capturado.

Após o cancelamento total, não é possível solicitar novos cancelamentos para a mesma transação.