Constantes e webhook customizado

O plugin expõe duas constantes pra cenários onde a configuração padrão de webhook não atende — multi-loja com proxy compartilhado, ambiente de staging que não deve registrar webhooks, ou redirecionamento pra um endpoint customizado.

Defina ambas no wp-config.php, antes da linha require ABSPATH . 'wp-settings.php';.

`BANCO_INTER_DISABLE_WEBHOOKS`

Quando true, o plugin não registra webhook no banco ao salvar as configurações dos gateways. Pagamentos continuam confirmando via cron horário, só não em tempo real.

define( 'BANCO_INTER_DISABLE_WEBHOOKS', true );

Quando usar:

Staging / homologação: evita que o ambiente de teste sobrescreva o webhook do site de produção (no banco, só pode haver uma URL ativa por aplicação).
Multi-loja com webhook centralizado: se você tem um servidor único recebendo webhooks de várias lojas e distribuindo, o plugin não precisa gerenciar o registro.

Lembre de remover ao mover pra produção

É comum esquecer essa constante ativa quando o site sobe pro ar. Sem webhook registrado, pagamentos só confirmam de hora em hora — uma latência ruim pro cliente. Cheque o wp-config.php antes do go-live.

`BANCOINTER_CUSTOM_WEBHOOK_URL`

Quando definida, o plugin registra essas URLs no banco no lugar das URLs nativas (/wc-api/interboleto e /wc-api/interpix).

define( 'BANCOINTER_CUSTOM_WEBHOOK_URL', [
    'interpix'    => 'https://gateway.minhaloja.com/inter/pix',
    'interboleto' => 'https://gateway.minhaloja.com/inter/boleto',
] );

A constante precisa ser um array com as duas chaves (interpix e interboleto). Cada valor é a URL pública completa.

Cenários típicos:

Proxy reverso entre o banco e o site: você quer logar todas as chamadas, fazer rate limiting ou enriquecer o payload antes de chegar no WooCommerce.
Multi-loja com endpoint compartilhado: um único servidor recebe e roteia pra cada site de origem com base no payload.
Domínio diferente do site: loja em loja.com.br mas webhooks chegam em api.empresa.com.br por questão de infra.

O endpoint custom precisa repassar o payload pro WooCommerce

O plugin espera que a request chegue eventualmente no formato nativo (corpo da request preservado, headers de auth do banco mantidos). Se você configura um proxy, ele só roteia — não tente reformatar o payload.

Combinando as duas

BANCO_INTER_DISABLE_WEBHOOKS=true com BANCOINTER_CUSTOM_WEBHOOK_URL definida não faz sentido — a primeira tem prioridade e a custom URL é ignorada. Use uma ou outra.