A Autra utiliza webhooks para notificar o seu sistema sobre mudanças no status de transações Pix Checkout.

🚧
Em desenvolvimento
A integração de webhooks de saída (Autra → seu sistema) está em desenvolvimento.
Atualmente, os eventos são processados internamente pela Autra para atualização de status.

Como funciona

Dock → [POST /incoming-events] → SQS → processor Lambda → atualiza status

Dock envia eventos de webhook para a Autra
A Autra processa o evento e atualiza o status do Pix Checkout correspondente
Você pode consultar o status atualizado via polling na sua integração

Eventos processados

FINANCIAL_TRANSACTION

Disparado quando o status de uma transação Pix muda.

Status Dock	Resultado no Pix Checkout	Significado
`AUTHORIZED`	`PIX_CHECKOUT_PAID`	Pagamento confirmado pelo Pix
`EXPIRED`	`PIX_CHECKOUT_EXPIRED`	QR Code expirado sem pagamento
`PENDING`	—	Aguardando confirmação (ignorado)

PAYOUT

Disparado quando a liquidação financeira é concluída.

Status Dock	Resultado	Significado
`SETTLED`	Liquidação registrada	Valor creditado na conta

Status do Pix Checkout

Status	Descrição
`PIX_CHECKOUT_CREATED`	QR Code gerado, aguardando pagamento
`PIX_CHECKOUT_PAID`	Pix recebido e confirmado
`PIX_CHECKOUT_EXPIRED`	QR Code expirou sem pagamento

Idempotência

O processamento de eventos é idempotente: se o mesmo evento for recebido múltiplas vezes (retry da Dock), o status do Pix Checkout não será alterado novamente.

Próximos passos

Quando os webhooks de saída estiverem disponíveis, sua aplicação poderá receber notificações em tempo real quando:

Um pagamento Pix for confirmado (PIX_CHECKOUT_PAID)
Um QR Code expirar sem pagamento (PIX_CHECKOUT_EXPIRED)

Em caso de dúvidas: atendimento@autrapay.com.br