Cancela um link.
Cancelar Link
Esta rota oferece a capacidade de realizar o cancelamento de uma transação associada a um link, desde que a transação tenha ocorrido no mesmo dia da execução da rota.
Aviso Importante!
O cancelamento só será efetuado se a transação estiver ocorrida no mesmo dia do pedido de cancelamento.
Como implementar:
Primeiramente, é necessário passar o token API do estabelecimento no header "Authorization". Esse token é disponibilizado através do Suporte. Os contatos estão disponibilizados em nossa página Fix Pay.
Além disso, devem ser incluídos os seguintes parâmetros na requisição:
- Token do link: O token é formado pelos caracteres que aparecem após a última barra ("/") na URL gerada pela rota de criação de link.
- TID (ID da Transação): Identificador único associado à transação obtido na rota Consultar por Token.
Esses parâmetros são cruciais para o correto funcionamento da rota de cancelamento do link.
Exemplo:
Agora, veremos um exemplo da requisição feita em JavaScript e seu resultado.
curl --location --request PUT 'https://apis.fixpay.com.br/v1/link/refund/d24962ac81a8d19xxx4176c638940a11e/11132xxx7121137224520' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 125SEBXXXXXX20150821' \
--data-raw ''
O retorno da requisição é um JSON contendo contendo a mensagem que o Flashlink foi cancelado.
{
"Status": "Success", "Data": "Venda cancelada com sucesso."
}
Testar rota
Abaixo, você poderá testar a rota em produção, passando os valores nos parâmetros conforme sua descrição e tipo. Na lateral direita da tela, você poderá ver o código da requisição em várias linguagens diferentes e sua resposta. Além disso, na parte de resposta da requisição, você poderá ver todos os possíveis retornos gerados pela rota.