Cancelando transações cartão

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 deverão 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 ocorre 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 (estabelecimento comercial). A venda passa para o estado de canceled (cancelado) quando o valor amount for zero, sendo disparado um evento de webhook transaction.canceled (transação cancelada) caso o recebimento destes estejam configurados, mantendo o objeto da venda no estado de succeeded.

Para cada operação de cancelamento será 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 após ser realizada.

Carta de cancelamento.

Após o cancelamento de uma 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 só será possível apenas para transações digitais (online).

  • 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 (estabelecimento comercial) 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
            }
       ]
}

❗️

Cancelamento de transação com split via dashboard

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