Pular para o conteúdo principal
A seção Webhook configura notificações de saída para eventos de transferência. Quando habilitado, o plugin envia atualizações sobre transferências para um endpoint HTTPS controlado por você, permitindo que sistemas posteriores reajam em tempo quase real, sem precisar fazer polling no Console. O cabeçalho da seção exibe um selo Habilitado ou Desabilitado com base no alternador abaixo.

​
Acessando a seção

1

Abra Configurações

Na barra lateral do Bank Transfer, clique em Configurações.
2

Expanda Webhook

Clique no cabeçalho da seção para expandi-la.

​
Campos

​
Webhook Habilitado

Alternador que liga ou desliga a entrega do webhook. Quando desabilitado, os campos URL do Endpoint e Chave de Assinatura continuam editáveis, mas ficam inativos — o plugin não enviará nenhuma requisição até que o alternador esteja ligado.

​
URL do Endpoint

A URL HTTPS que receberá as requisições do webhook (por exemplo, https://example.com/webhook). Editável apenas quando o webhook estiver habilitado.

​
Chave de Assinatura

Uma chave secreta compartilhada usada para assinar payloads do webhook, para que o seu endpoint possa verificar a autenticidade. Armazenada como segredo: uma vez salva, o campo mostra pontos de placeholder em vez do valor. Deixe-o vazio ao salvar para manter o segredo existente inalterado. Editável apenas quando o webhook estiver habilitado.
Payloads de webhook podem carregar informações sobre transferências, valores e contrapartes. Sempre termine o endpoint com HTTPS, valide a assinatura em cada requisição e rejeite payloads que não correspondam à assinatura esperada.

​
Salvando alterações

Clique em Salvar na barra de ferramentas no topo da página. Cada alteração é registrada na aba Histórico de Configurações. A Chave de Assinatura é armazenada, mas exibida como •••• no histórico, para que o fato da alteração seja auditável sem expor o segredo em si.

​
Dicas

  • Ao habilitar o webhook pela primeira vez, aponte-o para um endpoint de teste (por exemplo, um request bin) para validar o formato do payload antes de conectá-lo a sistemas de produção.
  • Rotacione a chave de assinatura periodicamente. Ao fazer a rotação, atualize tanto o plugin quanto o seu serviço receptor na mesma janela para evitar eventos descartados.
  • Se o seu receptor ficar indisponível, considere desabilitar o webhook temporariamente em vez de deixar um endpoint quebrado — isso evita falhas ruidosas e mantém o Histórico de Configurações mais limpo.