Skip to main content

​
Visão Geral

A Autorizou envia webhooks para diversos eventos relacionados a pagamentos e assinaturas. Você pode escolher quais eventos deseja receber ao configurar seu webhook na Dashboard.
Recomendação: Configure apenas os eventos que você realmente precisa processar para reduzir o volume de notificações.

​
Eventos de Pagamento

​
Criação e Autorização

Disparado quando um pagamento é criado no sistemaQuando usar:
  • Registrar início de uma transação
  • Criar registro de pagamento pendente no seu sistema
  • Analytics e tracking de conversão
Aplicável a: Todos os métodos de pagamento
Disparado quando um pagamento por cartão de crédito é autorizadoQuando usar:
  • Confirmar que o cartão tem saldo disponível
  • Liberar produtos/serviços (se configurado para captura automática)
  • Enviar confirmação ao cliente
  • Iniciar fulfillment
Aplicável a: Cartão de crédito
Para pagamentos com captura manual, este evento indica apenas autorização. O valor ainda não foi capturado.

​
Recusas e Expirações

Disparado quando um pagamento é recusadoQuando usar:
  • Notificar cliente sobre a recusa
  • Oferecer métodos de pagamento alternativos
  • Liberar estoque reservado
  • Analytics de taxa de recusa
Motivos comuns:
  • Saldo insuficiente
  • Cartão bloqueado ou vencido
  • Dados inválidos
  • Suspeita de fraude pelo emissor
Aplicável a: Cartão de crédito, PIX Recorrente (cobranças automáticas)
Para PIX Recorrente: Se a política de retry estiver ativa (retry_policy = true), o sistema tentará cobrar novamente automaticamente (até 3 tentativas).
Disparado quando um pagamento expira sem ser completadoQuando usar:
  • Liberar estoque reservado
  • Cancelar pedido automaticamente
  • Enviar email de reengajamento com novo link
Aplicável a:
  • Boleto bancário (após vencimento)
  • PIX (após prazo de validade)
  • PIX Recorrente (QR Code inicial não pago)

​
PIX Recorrente - Eventos Específicos

Disparado quando um pagamento recorrente é agendado para cobrança futuraQuando usar:
  • Notificar cliente sobre próxima cobrança
  • Atualizar dashboard com cobranças futuras
  • Preparar sistema para próximo ciclo
Aplicável a: PIX RecorrenteTiming: Ocorre 3 dias antes da data de cobrança
Este é o momento ideal para enviar lembretes ao cliente sobre a cobrança que ocorrerá em breve.
Disparado quando um pagamento recorrente está sendo processadoQuando usar:
  • Registrar que cobrança foi enviada para processadora
  • Atualizar status interno
  • Monitorar tempo de processamento
Aplicável a: PIX RecorrenteTiming: Ocorre 2 dias antes da data de cobrança (requisito Adyen)
Após este evento, aguarde payment.authorized (sucesso) ou payment.refused (falha).
Disparado quando aguarda o primeiro pagamento PIX para autorizar recorrênciaQuando usar:
  • Exibir QR Code ao cliente
  • Instruir cliente a realizar primeiro pagamento
  • Monitorar conversão de QR Code gerado → pago
  • Enviar lembretes se cliente não pagar
Aplicável a: PIX Recorrente (apenas primeiro pagamento)
O QR Code tem prazo de validade. Se o cliente não pagar a tempo, receberá payment.expired.
Disparado quando uma nova tentativa de cobrança recorrente é agendada após falhaQuando usar:
  • Notificar cliente sobre nova tentativa de cobrança
  • Registrar tentativa de retry no sistema
  • Atualizar dashboard com próxima tentativa
  • Enviar alerta ao cliente para garantir saldo disponível
Aplicável a: PIX Recorrente (com retry_policy = true)Timing: Até 3 tentativas automáticas, em até 7 dias da data original
Use este evento para dar ao cliente uma segunda chance de manter a assinatura ativa. Envie notificações proativas.

​
Estornos

Disparado quando um estorno é solicitado e está sendo processadoQuando usar:
  • Informar cliente que estorno está em andamento
  • Atualizar status interno do pedido
  • Registrar início do processo de estorno
Este evento ocorre antes da confirmação final do estorno.
Disparado quando um estorno é concluído e o valor foi devolvidoQuando usar:
  • Atualizar status do pedido para “estornado”
  • Notificar cliente sobre conclusão do estorno
  • Ajustar estoque (devolver produtos)
  • Registros contábeis
Este é o evento final confirmando que o dinheiro foi devolvido ao cliente.
Disparado quando uma solicitação de estorno é negadaQuando usar:
  • Notificar equipe responsável sobre a negativa
  • Registrar motivo da negativa
  • Verificar se há necessidade de ação manual
  • Contatar adquirente se necessário
Pode ocorrer quando não há mais prazo para estorno ou outros impedimentos técnicos.

​
Chargebacks e Disputas

Disparado quando o cliente abre uma disputa (chargeback) junto ao bancoQuando usar:
  • Alertar imediatamente a equipe responsável
  • Reunir documentação para defesa (comprovante de entrega, comunicações, etc)
  • Registrar ocorrência
  • Analytics de fraude e prevenção
Ação urgente requerida! Você tem prazo limitado (geralmente 7-10 dias) para contestar um chargeback. Configure alertas para este evento!
Disparado quando há uma atualização na disputa de chargebackQuando usar:
  • Acompanhar status da disputa
  • Registrar mudanças no processo
  • Notificar equipe sobre atualizações
  • Preparar documentação adicional se solicitado

​
Eventos de Assinatura

Disparado quando uma nova assinatura é criadaQuando usar:
  • Registrar nova assinatura no sistema
  • Liberar acesso inicial ao serviço/produto
  • Enviar email de boas-vindas
  • Configurar cobranças recorrentes
  • Ativar período de trial (se aplicável)
Disparado quando uma assinatura é atualizadaQuando usar:
  • Sincronizar mudanças de plano
  • Atualizar valor da próxima cobrança
  • Notificar cliente sobre mudanças
  • Ajustar nível de acesso ao serviço
Mudanças que podem disparar:
  • Alteração de plano (upgrade/downgrade)
  • Mudança de valor
  • Atualização de método de pagamento
  • Alteração de ciclo de cobrança
Disparado quando uma assinatura é inativadaQuando usar:
  • Bloquear acesso do cliente ao serviço
  • Enviar notificação de cancelamento
  • Oferecer opção de reativação com desconto
  • Analytics de churn (cancelamentos)
Motivos comuns:
  • Falha de pagamento recorrente
  • Cancelamento solicitado pelo cliente
  • Inativação manual por suporte
Disparado quando uma assinatura é excluída permanentementeQuando usar:
  • Remover acesso definitivamente
  • Limpar dados relacionados (se aplicável)
  • Registros de auditoria
  • Relatórios de cancelamento
Este é um evento final. A assinatura não pode ser recuperada após exclusão.

​
Configurando Eventos na Dashboard

Para selecionar os eventos que deseja receber:
1

Acesse a Dashboard

Faça login em artemis.autorizou.app
2

Vá até Webhooks

Menu lateral: Integrações → Webhooks
3

Criar ou Editar Webhook

Ao criar/editar, você verá todos os eventos organizados por categoria
4

Selecione Eventos

Marque apenas os eventos que você precisa processar
Os eventos aparecem na Dashboard com nomes traduzidos em português. O valor técnico enviado no webhook será sempre o formato em inglês (ex: payment.authorized).

​
Eventos Recomendados por Tipo de Negócio

​
E-commerce

Para lojas virtuais que vendem produtos físicos ou digitais:
  • payment.created - Registrar início da transação
  • payment.authorized - Liberar pedido para separação
  • payment.refused - Notificar cliente e liberar estoque
  • payment.expired - Cancelar pedido e liberar estoque
  • payment.refunded - Processar devolução
  • payment.chargeback_requested - Alertar equipe antifraude

​
Marketplace

Para plataformas que conectam compradores e vendedores:
  • payment.created - Notificar vendedor sobre nova venda
  • payment.authorized - Confirmar venda ao vendedor
  • payment.refused - Notificar ambas as partes
  • payment.refunded - Processar estorno e ajustar saldo do vendedor
  • payment.chargeback_requested - Alertar vendedor e plataforma

​
SaaS / Assinaturas

Para serviços de software ou conteúdo recorrente:
  • payment.authorized - Confirmar renovação
  • payment.refused - Tentar recuperação ou pausar acesso
  • subscription.created - Liberar acesso inicial
  • subscription.updated - Ajustar nível de acesso (upgrade/downgrade)
  • subscription.inactivated - Bloquear acesso ao serviço
Para PIX Recorrente adicione:
  • payment.waiting_payment - Exibir QR Code para primeiro pagamento
  • payment.scheduled - Notificar cliente sobre próxima cobrança (3 dias antes)
  • payment.processing - Registrar que cobrança foi enviada (2 dias antes)
  • payment.retry_scheduled - Notificar sobre nova tentativa após falha
  • payment.refused - Implementar recuperação de pagamento ou pausar assinatura

​
Serviços Digitais

Para serviços com entrega imediata (cursos, ebooks, etc):
  • payment.created - Preparar conteúdo para entrega
  • payment.authorized - Liberar acesso imediato
  • payment.refused - Notificar cliente
  • payment.refunded - Revogar acesso ao conteúdo

​
Frequência e Volume

Planejamento de CapacidadeA quantidade de webhooks que você receberá depende do seu volume de transações:
  • 1 evento payment.created por transação
  • 1 evento payment.authorized ou payment.refused por tentativa
  • Eventos adicionais conforme o ciclo de vida (estornos, chargebacks, etc)
Exemplo: 1.000 vendas/dia = ~2.000-3.000 webhooks/dia (considerando created + authorized/refused)

​
Próximos Passos

Ver Estrutura dos Payloads

Entenda o formato dos dados recebidos em cada evento