Skip to main content
Ao criar uma cobrança (PIX, cartão ou boleto), informe o campo postbackUrl. A Avantti Finance enviará uma requisição POST para essa URL sempre que o status da transação mudar (por exemplo, quando um PIX for pago).

Como funciona

1

Informe a postbackUrl

Envie postbackUrl no corpo da cobrança. Use uma URL pública e acessível pela internet (HTTPS).
2

Receba a notificação

Quando o status mudar, sua URL receberá um POST com os dados da transação (incluindo o id).
3

Confirme o estado

Trate a notificação de forma idempotente e, em caso de dúvida, confirme o estado atual da transação pelo seu próprio registro do id retornado na criação.
Responda com um status HTTP 2xx o mais rápido possível. Processos demorados devem ser feitos de forma assíncrona, após confirmar o recebimento.
Trate cada webhook de forma idempotente: a mesma notificação pode, eventualmente, chegar mais de uma vez. Use o id da transação como chave para evitar processamento duplicado.