Pagamentos de reembolso

O processo de reembolso de pagamento é o procedimento pelo qual você reembolsará um cliente por um pagamento anterior. Neste guia, você encontrará instruções sobre como reembolsar um pagamento criado anteriormente no Yuno.

Requisitos

Para reembolsar 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 Payment e os dados de captura, a operação de captura foi executada usando o Captura 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. Você usará uma fonte diferente para essas informações, dependendo de como capturou o pagamento.
    • Se você criou e capturou o pagamento usando apenas uma operação, obterá o transaction_id do parâmetro transaction.id depois de criar o pagamento com o Criar Payment endpoint.
    • Se você executou a autorização e, em seguida, a captura de pagamento, usará o transaction_id do parâmetro id recebido após capturar o pagamento usando o Captura de pagamento endpoint.

📘

Explore as coleções de Yuno Postman

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

Reembolsar um pagamento

Se você iniciar um reembolso, ele reembolsará uma cobrança criada anteriormente, mas ainda não reembolsada. O valor será creditado de volta ao método de pagamento original que foi cobrado.

Use o endpoint de pagamento de reembolso com transação para realizar o reembolso. Para identificar o pagamento a ser reembolsado, você precisa fornecer seu id e o transaction_id. Caso você não precise retornar uma transação específica, use o endpoint de pagamento de reembolso para realizar o reembolso com base no pagamento. Além disso, você precisa informar o valor a ser reembolsado usando o objeto amount na solicitação do corpo:

• Reembolso total: Deixar o amount vazio.
• Reembolso parcial: Forneça o valor do reembolso usando o parâmetro amount.

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

• status = REFUNDED
• sub_status = REFUNDED
• transaction.type = REFUND
• transaction.status = SUCCEEDED

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

📘

Tempo de processamento do reembolso

O tempo de processamento dos reembolsos varia de acordo com o tipo de pagamento. No modo de teste, os reembolsos são processados instantaneamente no ambiente Sandbox.

Verificar o status do pagamento

Se, por algum motivo, você precisar confirmar o reembolso 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.