Cancelamento

ℹ️

Consulte a Referência da API para ver o exemplo completo de requisição:

Cancelar transação de cartão de crédito.

O cancelamento é uma funcionalidade que permite ao lojista estornar um pedido de compra. Ele pode ocorrer por insuficiência de estoque, desistência da compra pelo consumidor ou outros motivos operacionais.

No Gateway de Pagamento é possível realizar a solicitação de cancelamento para cartões de débito e crédito.

⚠️

Atenção

As regras operacionais do cancelamento como prazos, quando o estorno aparece para o portador e como a reversão é efetivada podem variar conforme a adquirente que processa a transação.

Caso o lojista precise consultar requisitos específicos, deve verificar diretamente com a adquirente responsável.

Para detalhes específicos da adquirente Cielo, consulte a documentação de Cancelamento

Cancelamento parcial e total

O Gateway de Pagamento permite cancelar todo o valor autorizado e capturado ou somente parte dele, conforme a necessidade da loja.

Para enviar uma solicitação de cancelamento, o lojista deve preencher o campo Amount com o valor que deseja estornar.

O cancelamento parcial só está disponível quando a transação é criada com Payment.Capture = "true".

• Em cartão de crédito, o cancelamento parcial pode ser solicitado mais de uma vez, até que o valor total da venda seja estornado.
• Em cartão de débito, a disponibilidade de cancelamento parcial pode variar conforme a adquirente. Se o valor informado em Amount for "0" (zero) ou se esse parâmetro não for enviado, o Gateway considera o cancelamento como estorno total do valor capturado.

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

O cancelamento total deve ser solicitado informando o campo Amount com o valor integral autorizado ou capturado. Após o cancelamento total, não é possível realizar novas solicitações para essa mesma transação.

Para mais detalhes sobre cancelamento e estorno por adquirente no Gateway, consulte: Cancelamento e estorno de transações.

Cancelamento em lote

Além do cancelamento individual via API, o Gateway permite que o lojista realize cancelamentos em lote pelo Portal E‑commerce, respeitando os prazos da adquirente.

Saiba mais em:

• Cancelamento em lote: até 23h59 do dia da criação da transação;
• Estorno em lote: a partir do dia seguinte à criação da transação.