Para receber notificações automáticas dos eventos do seu canal, você precisa de uma configuração de webhook: o registro que diz ao Pinbank pra onde enviar os eventos de seu interesse, com quais regras de entrega.A configuração é feita pelo suporte Pinbank — não é uma operação de autoatendimento.Como solicitar#
Entre em contato com o suporte Pinbank e informe:URL do seu endpoint receptor — para onde as entregas serão enviadas.
Eventos desejados — quais tipos de evento (e versões) você deve receber. Veja Eventos disponíveis. Token do seu serviço — se o seu endpoint exige autenticação própria, informe o valor para que a Pinbank o envie como header em toda entrega.Se algum dos eventos desejados ainda não estiver habilitado para os seus produtos contratados com o Pinbank, o suporte confirma a habilitação antes de concluir a configuração.Opcionalmente, você também pode solicitar:
Nome descritivo para a configuração, útil em consultas e suporte.
Personalização da política de retentativas e de timeout — veja a seção abaixo.Ao concluir, o suporte Pinbank confirma a configuração criada e ativa, pronta para receber entregas.
Roteamento por cliente e produto#
A Pinbank entrega o evento para o seu webhook quando o produto e o cliente da ocorrência coincidem com a configuração cadastrada — ou quando a configuração foi feita como global, recebendo eventos de qualquer cliente vinculado à sua integração.Se você tiver duas configurações para o mesmo produto — uma específica para um cliente e outra global — a específica tem prioridade para aquele cliente.
Configurações de retentativa (opcional)#
Ao configurar seu webhook, você pode personalizar como o Pinbank deve se comportar diante de falhas temporárias na entrega. É possível ajustar:Quantidade de tentativas — quantas vezes a Pinbank tenta reentregar um evento antes de desistir e marcar a entrega como falha definitiva.
Atraso antes da primeira retentativa — quanto tempo esperar após a 1ª falha antes de tentar novamente.
Fator de crescimento do atraso — o quanto o atraso aumenta a cada nova tentativa (backoff exponencial).
Atraso máximo entre tentativas — um teto para o atraso, mesmo com o crescimento exponencial.
Timeout da requisição HTTP — quanto tempo a Pinbank aguarda resposta do seu endpoint antes de considerar a chamada como falha.Se você não especificar nada, a Pinbank aplica uma configuração padrão — veja Política de reenvio para os valores padrão e como eles se comportam na prática.
Atualizando, desativando ou removendo a configuração#
Entre em contato com o suporte Pinbank para atualizar sua configuração de webhook (URL, eventos, retentativas, mascaramento), desativá-la temporariamente sem perder a configuração, ou removê-la definitivamente. Modificado em 2026-08-12 21:04:50
