Realizar um estorno/cancelamento no Link de Pagamento

Para realizar um estorno/cancelamento de uma transação feita com o link de pagamento é somente possível através da API, ou seja, não tem como realizar o procedimento de estorno/cancelamento da transação através do portal BackOffice.

Uma transação do Link de Pagamento é semelhante a uma transação do Checkout, sendo assim, o procedimento de estorno/cancelamento é igual para os dois.

Podemos nos basear no manual da Cielo: https://developercielo.github.io/manual/controletransacional4#cancelar-transa%C3%A7%C3%A3o 

Gerando Access Token:

Primeiramente temos que realizar o procedimento de autenticação(OAUTH) para gerar o Access Token, só assim podemos realizar o estorno/cancelamento.

Utilizando o Postman utilizaremos o endpoint com o método POST:  

https://cieloecommerce.cielo.com.br/api/public/v2/token 

Colocamos no header o campo "Authorization" com valor "Basic" seguido do "ClientId:ClientSecret" em base64, e colocamos o campo "Content-Type" com o valor "application/x-www-form-urlencoded", como mostrado na imagem abaixo:

Após o preenchimento do header é preciso preecher o body com o campo "grant-type" com o valor "client_credentials", como mostrado na imagem abaixo:

Só enviar a requisição e você terá o "Access Token" para realizar o estorno/cancelamento, a resposta da requisição será pareceida com a imagem abaixo:

Realizando o Estorno/Cancelamento:

Para realizar o Cancelamento ou estorno total de uma transação do Link de Pagamento, é preciso utilizar o seguinte endpoint com o método PUT:  https://cieloecommerce.cielo.com.br/api/public/v2/orders/`{checkout_cielo_order_number}`/void

Substituindo o "{checkout_cielo_order_number}" pelo numero de pedido na cielo, colocando no header o campo "Authorization" com o "Bearer" seguido do"Access Token" gerado anteriormente.

Para realizar o estorno parcial de uma transação do Link de Pagamento, é preciso utilizar o seguinte endpoint com o método PUT:    https://cieloecommerce.cielo.com.br/api/public/v2/orders/`{checkout_cielo_order_number}`/void?amount={valor}

Substituindo o "{checkout_cielo_order_number}" pelo numero de pedido na cielo e o "{Valor}" pelo valor que você deseja estornar, colocando no header o campo "Authorization" com o "Bearer" seguido do"Access Token" gerado anteriormente. Lembrando que o cancelamento parcial pode ser realizado apenas após a captura. O cancelamento parcial pode ser realizado inumeras vezes até que o valor total seja cancelado.

Para as duas requisições acima teremos a seguinte resposta :

OBS: Os procedimentos realizados nesse artigo são validos tanto para transações Checkout quanto para transações de Link de Pagamento.