> ## Documentation Index
> Fetch the complete documentation index at: https://help.autorizou.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks: receba notificações automáticas de eventos

> Configure uma URL para receber avisos em tempo real quando um pagamento for aprovado, um saque for realizado ou outro evento ocorrer.

<Note>
  **Disponível para: Empresa.** Somente contas do tipo Empresa podem cadastrar e gerenciar webhooks.
</Note>

Webhooks são notificações automáticas que a Autorizou envia para a URL que você cadastrar sempre que um evento importante acontecer, como um pagamento aprovado, um saque realizado ou uma assinatura cancelada. Em vez de o seu sistema ficar consultando a Autorizou o tempo todo, ele simplesmente aguarda e recebe o aviso na hora certa.

Com os webhooks você consegue:

* Cadastrar uma ou mais URLs para receber notificações
* Escolher exatamente quais eventos você quer monitorar
* Consultar o histórico de disparos para ver o que foi entregue e o que falhou

## Como cadastrar uma URL de webhook

<Steps>
  <Step title="Acesse a seção de webhooks">
    No menu lateral, vá em **Integrações → Webhooks**.
  </Step>

  <Step title="Adicione um novo webhook">
    Clique em **Novo webhook**.
  </Step>

  <Step title="Informe a URL">
    Digite a **URL do seu servidor** que vai receber as notificações. Ela precisa estar acessível publicamente e aceitar requisições do tipo POST.
  </Step>

  <Step title="Escolha os eventos">
    Selecione na lista os **eventos** que você quer monitorar. Você pode escolher um ou vários ao mesmo tempo. Veja a seção abaixo para conhecer os eventos disponíveis.
  </Step>

  <Step title="Salve o webhook">
    Clique em **Salvar**. A partir daí, toda vez que um dos eventos selecionados ocorrer, a Autorizou enviará uma notificação para a sua URL.
  </Step>
</Steps>

<Tip>
  Antes de usar em produção, teste a URL com um servidor local ou um serviço de inspeção de webhooks para garantir que ela responde corretamente.
</Tip>

## Eventos disponíveis

A lista completa e atualizada de eventos aparece no próprio painel, na tela de criação do webhook. Alguns exemplos do que pode ser monitorado:

| Evento                   | Quando é disparado                     |
| ------------------------ | -------------------------------------- |
| **Pagamento aprovado**   | Uma transação é confirmada com sucesso |
| **Pagamento recusado**   | Uma tentativa de pagamento é negada    |
| **Pagamento estornado**  | Um estorno é processado                |
| **Saque realizado**      | Um saque da carteira é concluído       |
| **Assinatura criada**    | Uma nova assinatura é ativada          |
| **Assinatura cancelada** | Uma assinatura é encerrada             |

<Note>
  A lista completa de eventos e o formato exato dos dados enviados estão na **documentação para desenvolvedores** da Autorizou.
</Note>

## Como consultar o histórico de disparos

O histórico mostra cada vez que a Autorizou tentou enviar uma notificação para a sua URL, com o resultado de cada tentativa.

<Steps>
  <Step title="Acesse a lista de webhooks">
    Vá em **Integrações → Webhooks** e clique no webhook que deseja consultar.
  </Step>

  <Step title="Abra o histórico">
    Clique em **Histórico de disparos**.
  </Step>

  <Step title="Analise os resultados">
    Cada linha mostra o evento, a data e hora do disparo e o status da entrega: **sucesso** (sua URL respondeu corretamente) ou **falha** (sua URL não respondeu ou retornou erro).
  </Step>
</Steps>

<Warning>
  Falhas repetidas em um webhook costumam indicar que a URL está fora do ar ou com configuração incorreta. Corrija o servidor e acompanhe o histórico para confirmar que as entregas voltaram ao normal.
</Warning>

## Boas práticas

* **Responda rápido:** sua URL deve retornar o código de sucesso o mais rápido possível. Se o processamento for demorado, confirme o recebimento primeiro e processe depois.
* **Confirme na fonte:** trate a notificação como um aviso, não como a verdade final. Antes de executar ações críticas no seu sistema, confirme a informação consultando o painel ou a sua integração.
* **Monitore o histórico:** consulte o histórico regularmente para identificar falhas e corrigir antes que virem problema.
* **Eventos específicos:** selecione apenas os eventos que o seu sistema realmente precisa. Isso reduz o volume de notificações desnecessárias.

## Dúvidas comuns

<AccordionGroup>
  <Accordion title="Posso cadastrar mais de uma URL de webhook?">
    Sim. Você pode ter múltiplos webhooks com URLs diferentes, cada um monitorando eventos distintos ou os mesmos eventos. Isso é útil quando sistemas diferentes precisam ser notificados.
  </Accordion>

  <Accordion title="O que acontece se minha URL estiver fora do ar?">
    A Autorizou tenta reenviar a notificação algumas vezes. Se todas as tentativas falharem, o disparo fica registrado como falha no histórico, com o detalhe do erro para você diagnosticar.
  </Accordion>

  <Accordion title="Quantas tentativas de reenvio automático são feitas?">
    A Autorizou realiza um número limitado de tentativas automáticas. Para o número exato e os intervalos entre tentativas, consulte a documentação para desenvolvedores.
  </Accordion>

  <Accordion title="Como sei se o webhook que recebi é legítimo?">
    Use a notificação apenas como um aviso de que algo aconteceu. Antes de executar ações críticas no seu sistema, confirme a informação na fonte, consultando o painel ou a sua integração. Assim, um aviso duplicado ou inesperado não gera efeito indevido.
  </Accordion>

  <Accordion title="Posso testar o webhook antes de ir para produção?">
    Sim. Você pode usar serviços de inspeção de webhook para ver as notificações em tempo real enquanto testa. Cadastre uma URL temporária de teste e troque pela URL de produção quando estiver tudo certo.
  </Accordion>
</AccordionGroup>

## Veja também

<CardGroup cols={2}>
  <Card title="Chaves de Integração" icon="key" href="/integracoes/chaves-de-integracao">
    Crie e gerencie as chaves que autenticam sua conta nas integrações.
  </Card>

  <Card title="Colaboradores" icon="users" href="/equipe/colaboradores">
    Controle quem da sua equipe pode acessar e configurar as integrações.
  </Card>
</CardGroup>