Skip to main content
Esta página detalha todos os eventos disponíveis na API Quantum Pay 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 Status: queued - Transferência em fila para processamento

transfer_updated

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

transfer_completed

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

transfer_canceled

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

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