Cancelando transações

Cancelando a reserva de saldo de uma pré-autorização ou retornando um valor total ou parcial de uma cobrança para o saldo do cartão.

O cancelamento de transações pré-autorizadas ou bem sucedidas é o processo de devolução de saldo total ou parcial de uma transação na fatura do pagador, onde será lançado a primeira ou única parcela que ainda não foi fechada ou um reembolso caso tenha sido fechada.

Os cancelamentos devem surtir efeito no mesmo dia, reembolsos podem levar uma ou mais faturas para serem refletidos, dependendo do banco emissor do cartão.

📘

Importante

Se uma transação já tenha algum recebível liquidado, a Zoop permite cancelamento caso o cliente ainda tenha saldo disponível em conta gráfica.

Para realizar o cancelamento de vendas já liquidadas deve ser feita uma solicitação especial de liberação em nome do marketplace/estabelecimento comercial, não sendo possível realizar este tipo de cancelamento sem uma liberação prévia.

Não será possível cancelamento uma transação se ela estiver falhada, com uma captura pendente ou com um cancelamento pendente.

Tipos de Cancelamento

  • Cancelamento Total

O cancelamento total é quando você devolve o valor total da transação que será devolvida ao cartão de crédito.

  • Cancelamento Parcial

O cancelamento parcial é o ato de cancelar um valor menor que o valor total autorizado/capturado. Esse modelo de cancelamento pode ocorrer inúmeras vezes, até que o valor total da transação seja cancelado.

  • Cancelamento parcial disponível apenas para transações de crédito capturadas.

Ao cancelar parcialmente uma transação, o amount (valor em reais) cancelado é reduzido do valor atual da venda, ficando o valor original_amount (Valor original) preservado com o valor original da venda, sendo gerado novamente os recebíveis associados a esta venda, retornando erro caso uma regra de split ultrapasse o valor restante da venda após cancelamento.

No cancelamento parcial, o estado da venda permanece como succeeded (sucesso) enquanto restar valor amount a ser creditado ao EC. A venda passa para o estado de canceled (cancelado) quando o valor amount for zero.

No cancelamento parcial é também disparado o evento de transaction.canceled (transação cancelada), porém mantendo o objeto da venda no estado de succeeded.

Para cada operação de cancelamento é registrado um histórico que pode ser visualizado nas APIs de transactions (transações).

❗️

Cancelamento parcial.

Transações só poderão ser canceladas parcialmente no dia seguinte.

Carta de cancelamento.

Após o cancelamento da transação, a Zoop disponibiliza aos parceiros uma carta comprovando que o cancelamento da transação foi efetivada.

  • Via Dashboard

Na aba "vendas" do dashboard, clique na transação a ser cancelada

Ao lado direito da tela, clique no botão “Cancelar Venda”

Após o cancelamento ficará visível no dashboard o botão para a emissão da carta de cancelamento.

❗️

Importante

O cancelamento parcial via dashboard é possível apenas para transações digitais.

  • Via API

Para emitir o cancelamento via API está disponível um endpoint, que pode ser encontrado na "Referencia de API"

Regras de cancelamento

As regras de cancelamento (void rules) permite realizar o cancelamento parcial para transações splitadas.

O valor total do "amount" do seller principal da venda (on_behalf_of), deve ser a soma dos valores (amount) dividido entre o(s) recipents (recebedores).

Ex.: recipient 1 = R$300 + recipent 2 =R$500 = R$ 800 (on_behalf_of)

Abaixo o request aplicando as regras do exemplo em formato JSON.

{
    "on_behalf_of": "f342a002b03e4964874cbaf095a20274",
    "amount": 800,
     "void_rules": [
            {
                "recipient": "2342a002b03e4964874cbaf095a20123",
                "amount": 300
            }
           ,{
                 "recipient": "0184f9c9501c481eafcf414a2d7eec46",
                 "amount": 500
            }
       ]
}

Mais detalhes em nossa referência de API

❗️

Cancelamento de transação com split via dashboard

O valor a se cancelado de uma transação com split, o saldo é retirado do seller principal (on_behalf_of) da venda. Caso o mesmo tenha um valor na participação no split menor que o solicitado para o cancelamento, a plataforma (dashboard) não irá executar.


Did this page help you?