Cancelar pagamentos

Neste guia, você encontrará instruções passo a passo sobre como cancelar manualmente um pagamento criado anteriormente no Yuno.

📘

Cancelamento automático atrasado

Se você preferir que o Yuno cancele automaticamente as autorizações após um atraso especificado, é possível configurar delayed_cancel_settings ao criar o pagamento. Isso ajuda a melhorar a experiência do cliente, liberando automaticamente os fundos retidos. Saiba mais em Cancelar e capturar fluxo guia.

🚧

Pagamentos canceláveis

Somente pagamentos com PENDING podem ser cancelados. Consulte a página Status do pagamento para obter mais detalhes sobre os possíveis status de pagamento.

Requisitos

Para cancelar um pagamento, você precisa:

• Acesse seu Credenciais da API no Painel de Controle da Yuno, que consistem em:
  • public-api-key
  • private-secrete-key
• Os dados de identificação do pagamento foram recebidos após a criação do pagamento usando a função Criar endpoint de pagamento:
  • id: O identificador exclusivo do pagamento, obtido do parâmetro id depois de criar o pagamento.
  • transaction_id: O identificador exclusivo da transação obtido do parâmetro transaction.id depois de criar o pagamento.

📘

Explore as coleções de Yuno Postman

A Yuno fornece Postman Collections que você pode usar para replicar os casos de uso localmente.

Cancelar um pagamento

Você pode cancelar um pagamento somente se ele tiver o status PENDING . Use o botão endpoint Cancelar pagamento para cancelar o pagamento. Para identificar o pagamento a ser cancelado, você precisa fornecer id e o transaction_id.

Para confirmar que você cancelou o pagamento com êxito, verifique se os parâmetros da resposta endpoint Cancel Payment contêm os seguintes valores:

• type = CANCEL
• status = SUCCEEDED
• payment.status = CANCELED
• payment.sub_status = CANCELED

Se a resposta contiver os valores acima, o cancelamento foi bem-sucedido.

Verificar o status do pagamento

Se, por algum motivo, você precisar confirmar o cancelamento do pagamento:

• Use a opção Retrieve Payment by ID ou Retrieve Payment by merchant_order_id para obter informações detalhadas sobre o pagamento.
• Como alternativa, configure webhooks para receber notificações para cada evento. Consulte o guia Webhooks para saber como configurar webhooks no Yuno.