Captura de pagamentos

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

📘

Captura automática atrasada

Se você preferir que o Yuno capture automaticamente os pagamentos após um atraso especificado, é possível configurar delayed_capture_settings ao criar o pagamento. Saiba mais em Cancelar e capturar fluxo guia.

🚧

Quais pagamentos você pode capturar

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

Requisitos

Para capturar 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.

💡

Opções de captura

Este guia aborda a captura manual usando o endpoint da API. Para outras opções de captura, incluindo:

• Captura em tempo real (compra imediata)
• Captura atrasada (captura automática após um atraso)

Consulte o guia Fluxo de cancelamento e captura.

Capturar um pagamento

Você pode capturar um pagamento somente se ele tiver o status PENDING . Use o botão Captura endpoint de pagamento para capturar o pagamento. Para identificar o pagamento a ser capturado, você precisa fornecer seu id e o transaction_id. Além disso, você precisa informar o valor a ser capturado usando o objeto amount na solicitação do corpo:

• Reembolso completo: Deixe o valor em branco.
• Reembolso parcial: Forneça o valor do reembolso usando o parâmetro amount.

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

• type = CAPTURE
• status = SUCCEEDED
• payment.status = SUCCEEDED
• payment.sub_status = CAPTURED/PARTIALLY_CAPTURED

Se a resposta contiver os valores acima, a captura foi bem-sucedida.

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.