Visão geral dos webhooks

O que é um webhook

Os webhooks permitem que os aplicativos forneçam informações em tempo real sempre que ocorrer um evento, sem a necessidade de solicitações constantes. Eles são um método passivo para receber dados entre dois sistemas por meio de um HTTP POST. Depois de configurar os webhooks do Yuno, você receberá notificações de eventos sempre que uma atividade ou uma função for gerada no fluxo do Yuno.

Por que recomendamos que você use webhooks?

Os webhooks são a melhor maneira de garantir que seu sistema esteja atualizado com o progresso e o status do pagamento. Como as notificações de eventos são acionadas automaticamente, seu sistema não precisará fazer solicitações recorrentes à Yuno. Você processará as informações de pagamento sob demanda.

O que você precisa saber antes de começar a usar webhooks?

Para começar a usar os webhooks do Yuno, você precisa criar uma API REST pública para receber notificações de eventos (solicitação POST). Isso significa que a API REST que você criará não deve exigir nenhuma autenticação ou restrição de acesso por meio de um cabeçalho. Apesar de usar uma API pública, o sistema de comunicação é muito seguro, pois as notificações de eventos do Yuno não estarão disponíveis para o público e usarão um URL exclusivo para se comunicar apenas com sua API REST.

Requisitos de entrega e resposta de webhooks

Os webhooks da Yuno esperam receber um status HTTP 200 OK como resposta para confirmar que o webhook foi recebido com sucesso. O sistema do comerciante não precisa incluir nenhuma informação no corpo da resposta. Apenas o status HTTP 200 é necessário.

Se nenhuma resposta for recebida dentro do tempo especificado, o Yuno tentará enviar novamente a notificação de evento até sete vezes para garantir que nenhuma informação seja perdida. Consulte a seção Processo de confirmação de recebimento para obter detalhes sobre o cronograma de notificação e os tempos de espera de confirmação para cada nova tentativa.