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

# Eventos Disponíveis

> Lista completa de eventos que podem ser recebidos via webhook

## Visão Geral

A Autorizou envia webhooks para eventos do ciclo de vida de pagamentos e assinaturas. Você escolhe quais eventos deseja receber ao configurar seu webhook na Dashboard.

Esta página lista **apenas os eventos que a plataforma realmente emite**. O valor técnico enviado no campo `event` do payload é sempre o formato em inglês (ex.: `payment.authorized`).

<Warning>
  **Autenticidade da origem:** hoje o webhook **não é enviado com assinatura**. Trate cada notificação
  como um **gatilho** e confirme o estado real com uma consulta a `GET /payments/{id}` antes de agir
  sobre dinheiro. Use também idempotência por ID de evento — a ordem de entrega não é garantida e
  duplicatas são possíveis.
</Warning>

<Tip>
  Configure apenas os eventos que você realmente precisa processar, para reduzir o volume de
  notificações.
</Tip>

***

## Eventos de Pagamento

### Criação, autorização e captura

<AccordionGroup>
  <Accordion title="payment.created" icon="plus">
    **Disparado quando um pagamento é criado no sistema.**

    **Quando usar:** registrar o início de um pagamento, criar um registro pendente no seu sistema, analytics de conversão.

    **Aplicável a:** todos os métodos de pagamento.
  </Accordion>

  <Accordion title="payment.pre_authorized" icon="lock">
    **Disparado quando um pagamento com captura manual é pré-autorizado** — o valor foi **reservado** no cartão, mas ainda **não capturado**.

    **Quando usar:** confirmar que há saldo/limite reservado, iniciar a validação do pedido antes de capturar.

    **Aplicável a:** cartão de crédito (captura manual).
  </Accordion>

  <Accordion title="payment.authorized" icon="circle-check">
    **Disparado quando um pagamento é autorizado.**

    **Quando usar:** confirmar a aprovação, liberar produto/serviço (em captura automática), enviar confirmação ao cliente, iniciar fulfillment.

    **Aplicável a:** cartão de crédito, PIX Recorrente (mandato criado).

    <Warning>
      Em **captura manual**, este evento indica apenas autorização — o valor ainda não foi capturado
      (aguarde `payment.capture_confirmed`).
    </Warning>
  </Accordion>

  <Accordion title="payment.capture_confirmed" icon="circle-check">
    **Disparado quando a captura é confirmada** — o valor pré-autorizado foi efetivamente capturado.

    **Quando usar:** liberar o pedido após captura, marcar a venda como concluída, registros contábeis.

    **Aplicável a:** cartão de crédito (captura manual e cobranças recorrentes).
  </Accordion>

  <Accordion title="payment.capture_failed" icon="circle-xmark">
    **Disparado quando a captura de um valor pré-autorizado falha.**

    **Quando usar:** alertar a equipe, tentar nova captura dentro do prazo, ou cancelar o pedido.

    **Aplicável a:** cartão de crédito (captura manual).
  </Accordion>
</AccordionGroup>

### Recusa, expiração e fraude

<AccordionGroup>
  <Accordion title="payment.refused" icon="circle-xmark">
    **Disparado quando um pagamento é recusado.**

    **Quando usar:** notificar o cliente, oferecer método alternativo, liberar estoque reservado, analytics de recusa.

    **Motivos comuns:** saldo insuficiente, cartão bloqueado/vencido, dados inválidos, suspeita de fraude pelo emissor.

    **Aplicável a:** cartão de crédito, PIX Recorrente (cobranças automáticas).

    <Note>
      **PIX Recorrente:** com `retry_policy = true`, o sistema tenta cobrar novamente (até 3 tentativas).
    </Note>
  </Accordion>

  <Accordion title="payment.expired" icon="clock">
    **Disparado quando um pagamento expira sem ser completado.**

    **Quando usar:** liberar estoque reservado, cancelar o pedido, reengajar com novo link.

    **Aplicável a:** boleto (após vencimento), PIX (após validade), PIX Recorrente (QR inicial não pago).
  </Accordion>

  <Accordion title="payment.fraud_detected" icon="triangle-exclamation">
    **Disparado quando uma suspeita de fraude é identificada no pagamento.**

    **Quando usar:** bloquear o fulfillment, acionar revisão antifraude, registrar a ocorrência.

    **Aplicável a:** cartão de crédito.
  </Accordion>
</AccordionGroup>

### Cancelamento e atualização

<AccordionGroup>
  <Accordion title="payment.canceled" icon="ban">
    **Disparado quando um pagamento é cancelado** (ex.: cancelamento de uma pré-autorização ou de um pagamento ainda não capturado).

    **Quando usar:** liberar o pedido/estoque, registrar o cancelamento.

    **Aplicável a:** cartão de crédito.
  </Accordion>

  <Accordion title="payment.cancel_confirmed" icon="circle-check">
    **Disparado quando o cancelamento é confirmado pelo adquirente.**

    **Quando usar:** dar o cancelamento como concluído com segurança (é o evento final do cancelamento).

    **Aplicável a:** cartão de crédito.
  </Accordion>

  <Accordion title="payment.updated" icon="pen">
    **Disparado quando um pagamento é atualizado** (mudança de status ou de dados relevantes ao longo do ciclo).

    **Quando usar:** sincronizar o estado do pagamento no seu sistema. Como a ordem de entrega não é garantida, ao receber este evento **reconsulte** `GET /payments/{id}` para o estado atual.

    **Aplicável a:** todos os métodos.
  </Accordion>
</AccordionGroup>

### Estornos

<AccordionGroup>
  <Accordion title="payment.refund_in_progress" icon="rotate">
    **Disparado quando um estorno é solicitado e está em processamento.** Ocorre antes da confirmação final.

    **Quando usar:** informar que o estorno está em andamento, atualizar o status interno.
  </Accordion>

  <Accordion title="payment.refunded" icon="arrow-rotate-left">
    **Disparado quando um estorno é concluído e o valor foi devolvido.** É o evento final do estorno.

    **Quando usar:** marcar o pedido como estornado, notificar o cliente, ajustar estoque, registros contábeis.
  </Accordion>

  <Accordion title="payment.refund_denied" icon="ban">
    **Disparado quando uma solicitação de estorno é negada.**

    **Quando usar:** notificar a equipe, registrar o motivo, avaliar ação manual (ex.: prazo de estorno esgotado).
  </Accordion>
</AccordionGroup>

### Chargebacks e disputas

<AccordionGroup>
  <Accordion title="payment.chargeback_requested" icon="triangle-exclamation">
    **Disparado quando o cliente abre uma disputa (chargeback) junto ao banco.**

    **Quando usar:** alertar a equipe imediatamente, reunir documentação de defesa, registrar a ocorrência.

    <Warning>
      **Ação urgente.** O prazo para contestar costuma ser curto (7–10 dias). Configure alertas para
      este evento.
    </Warning>
  </Accordion>

  <Accordion title="payment.chargeback_dispute" icon="scale-balanced">
    **Disparado quando há uma atualização na disputa de chargeback.**

    **Quando usar:** acompanhar o status da disputa, preparar documentação adicional se solicitado.
  </Accordion>
</AccordionGroup>

***

## Eventos de Assinatura

<AccordionGroup>
  <Accordion title="subscription.created" icon="plus">
    **Disparado quando uma nova assinatura é criada.**

    **Quando usar:** registrar a assinatura, liberar acesso inicial, enviar boas-vindas, ativar o trial (se aplicável).
  </Accordion>

  <Accordion title="subscription.updated" icon="pen">
    **Disparado quando uma assinatura é atualizada** (plano, valor da próxima cobrança, método, ciclo).

    **Quando usar:** sincronizar a mudança, ajustar o nível de acesso, notificar o cliente.
  </Accordion>

  <Accordion title="subscription.inactivated" icon="pause">
    **Disparado quando uma assinatura é cancelada/inativada.**

    **Quando usar:** **bloquear o acesso** do cliente ao serviço, notificar o cancelamento, oferecer reativação, analytics de churn.

    **Motivos comuns:** cancelamento solicitado pelo cliente, cancelamento por suporte.
  </Accordion>
</AccordionGroup>

<Note>
  A **consulta** de uma assinatura por API está disponível em `GET /subscriptions/{uuid}` — use-a para
  auditar status, ciclo atual e data da próxima cobrança a qualquer momento.
</Note>

***

## PIX Recorrente — quais eventos chegam

O ciclo interno do PIX Recorrente tem etapas de agendamento e envio, mas **para o seu webhook chegam apenas os eventos de resultado**:

* **Primeira cobrança:** `payment.authorized` (mandato criado / cobrança aprovada) ou `payment.refused`.
* **Cobranças seguintes:** `payment.capture_confirmed` (sucesso) ou `payment.capture_failed` / `payment.refused` (falha).
* **Expiração do QR inicial:** `payment.expired`.

<Note>
  Os passos internos de agendamento/envio (dias antes da cobrança) **não geram webhook**. Se precisa
  acompanhar a agenda, use a consulta da assinatura (`GET /subscriptions/{uuid}`).
</Note>

***

## Configurando eventos na Dashboard

<Steps>
  <Step title="Acesse a Dashboard">
    Faça login em [dash.autorizou.com.br](https://dash.autorizou.com.br)
  </Step>

  <Step title="Vá até Webhooks">Menu lateral: **Integrações → Webhooks**</Step>

  <Step title="Criar ou editar webhook">
    Ao criar/editar, você verá os eventos organizados por categoria
  </Step>

  <Step title="Selecione os eventos">
    Marque apenas os eventos que você precisa processar
  </Step>
</Steps>

<Tip>
  Os eventos aparecem na Dashboard com nomes em português; o valor técnico enviado no webhook é sempre
  o formato em inglês (ex.: `payment.authorized`).
</Tip>

***

## Eventos recomendados por tipo de negócio

### E-commerce

* `payment.created` — registrar início do pagamento
* `payment.authorized` — liberar o pedido para separação
* `payment.refused` — notificar o cliente e liberar estoque
* `payment.expired` — cancelar o pedido e liberar estoque
* `payment.refunded` — processar devolução
* `payment.chargeback_requested` — alertar a equipe antifraude

### Marketplace

* `payment.created` — notificar o vendedor
* `payment.authorized` — confirmar a venda
* `payment.refused` — notificar as partes
* `payment.refunded` — estornar e ajustar o saldo do vendedor
* `payment.chargeback_requested` — alertar vendedor e plataforma

### SaaS / Assinaturas

* `payment.authorized` — confirmar a renovação
* `payment.capture_confirmed` — confirmar a cobrança recorrente (PIX Recorrente)
* `payment.refused` — tentar recuperação ou pausar o acesso
* `subscription.created` — liberar acesso inicial
* `subscription.updated` — ajustar o nível de acesso (upgrade/downgrade)
* `subscription.inactivated` — bloquear o acesso ao serviço

### Serviços digitais (entrega imediata)

* `payment.created` — preparar o conteúdo
* `payment.authorized` — liberar o acesso
* `payment.refused` — notificar o cliente
* `payment.refunded` — revogar o acesso

***

## Frequência e volume

<Info>
  A quantidade de webhooks depende do seu volume:

  * 1 `payment.created` por pagamento
  * 1 `payment.authorized` ou `payment.refused` por tentativa
  * eventos adicionais conforme o ciclo (captura, estorno, chargeback)

  **Exemplo:** 1.000 vendas/dia ≈ 2.000–3.000 webhooks/dia.
</Info>

***

## Próximos passos

<Card title="Ver estrutura dos payloads" icon="code" href="/api-reference/webhooks/payload-structure">
  Entenda o formato dos dados recebidos em cada evento
</Card>