Skip to main content
Esta página detalha todos os eventos disponíveis na API Avantti Finance que podem disparar webhooks, incluindo estrutura de dados e quando cada evento é enviado.

🔹 Eventos de Transação (PIX IN)

transaction_created

Quando é enviado: QR Code PIX criado com sucesso
Uso típico: Confirmar que QR Code foi gerado, iniciar timer de expiração

transaction_paid

Quando é enviado: PIX recebido e confirmado pelo sistema
Uso típico: Liberar produto/serviço, enviar email de confirmação, atualizar estoque

transaction_refunded

Quando é enviado: Estorno processado com sucesso
Uso típico: Cancelar entrega, notificar cliente, restaurar estoque

transaction_infraction

Quando é enviado: Problemas ou infrações detectadas pelo Banco Central
Uso típico: Pausar entrega, revisar transação, contatar suporte

🔹 Eventos de Transferência (PIX OUT)

transfer_created

Quando é enviado: Transferência PIX iniciada
Uso típico: Registrar tentativa de transferência, notificar solicitante

transfer_completed

Quando é enviado: Transferência PIX concluída com sucesso
Uso típico: Confirmar pagamento, atualizar sistema financeiro, notificar destinatário

transfer_canceled

Quando é enviado: Transferência PIX cancelada
Uso típico: Reverter operação, notificar erro, tentar novamente se apropriado

transfer_updated

Quando é enviado: Status da transferência foi atualizado
Uso típico: Atualizar status em tempo real, mostrar progresso ao usuário

🔄 Implementação por Evento

Processamento de Pagamentos Recebidos

Processamento de Transferências

Tratamento de Estornos

📊 Implementação Robusta

Processador de Eventos Centralizado

🛡️ Boas Práticas

1. Idempotência

2. Retry e Recuperação

3. Monitoramento


🎯 Próximos Passos

➕ Criar Webhook

Configure webhooks para receber estes eventos

🔒 Verificar Assinatura

Implemente validação de assinatura

📋 Listar Webhooks

Gerencie seus webhooks existentes

💰 PIX IN

Comece a receber pagamentos PIX