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.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.
Atualizando, desativando ou removendo a configuração#
Entre em contato com o suporte Pinbank caso seja necessário modificar sua configuração de webhook (URL, eventos, retentativas), desativá-la temporariamente sem perder a configuração ou removê-la definitivamente. Modificado em 2026-08-17 17:00:46
