Configuração de Webhook

Cada chave Pix receptora pode ter um webhook associado.

A configuração da URL de callback é realizada conforme o exemplo abaixo:

Parâmetros

partner_pix_key
Chave Pix para a qual a cobrança foi criada.
Essa chave pode ser gerada no portal Infopago Finance.

partner_callback_url
URL de callback fornecida pelo parceiro, responsável por receber requisições POST contendo:

Dados de cobranças liquidadas

Dados de reembolso de cobranças

Os webhooks são notificações enviadas em tempo real para informar eventos específicos.

O período de retenção das notificações é de até 15 dias

Após esse período, os webhooks não serão reenviados

Para consultar informações além do período de retenção:

👉 Utilize o endpoint de Consultar Pix recebidos.

Essa abordagem garante:

Acesso contínuo aos dados

Independência do histórico de webhooks

Maior confiabilidade na integração

Sempre persistir os eventos recebidos via webhook

Implementar retry em caso de falha no recebimento

Garantir que a URL de callback seja HTTPS

Validar a autenticidade das requisições recebidas

Webhooks notificam eventos em tempo real

Retenção de dados: 15 dias

Após esse prazo, utilize consultas diretas na API

Persistência local é recomendada para rastreabilidade