Hooks e filters

Lista de actions e filters expostos pelo plugin pra customizações em PHP. Coloque os snippets no seu tema (functions.php) ou em um plugin custom — não edite arquivos do plugin diretamente.

Actions

wc_banco_inter_payments_new_bank_slip_order

Disparado quando um novo boleto é gerado com sucesso na API do banco.

Argumentos: $order (WC_Order), $result (resposta da API).

add_action( 'wc_banco_inter_payments_new_bank_slip_order', function ( $order, $result ) {
    // $result['codigoSolicitacao'], $result['nossoNumero'], etc.
    error_log( 'Novo boleto pro pedido #' . $order->get_id() );
}, 10, 2 );

wc_banco_inter_payments_new_pix_order

Disparado quando um novo Pix é gerado com sucesso.

Argumentos: $order (WC_Order), $result (resposta da API com txid, pixCopiaECola, etc.).

add_action( 'wc_banco_inter_payments_new_pix_order', function ( $order, $result ) {
    error_log( 'Novo Pix pro pedido #' . $order->get_id() );
}, 10, 2 );

wc_banco_inter_check_interboletov2

Disparado pelo cron horário antes de varrer boletos pendentes.

add_action( 'wc_banco_inter_check_interboletov2', function () {
    // Hook de início do batch de boletos
} );

wc_banco_inter_check_interpix

Mesma ideia, pra Pix pendentes.

wc_banco_inter_check_interboletov2_order

Disparado pra cada boleto individualmente, dentro do cron. Recebe $order_id (int).

add_action( 'wc_banco_inter_check_interboletov2_order', function ( $order_id ) {
    // Verificar status de um boleto específico
}, 10, 1 );

wc_banco_inter_check_interpix_order

Mesma ideia, pra Pix individual.

wc_banco_inter_retry

Disparado quando o handler do webhook precisa reprocessar (5 minutos depois) por causa de erro durante a primeira tentativa.

Argumentos: $method ('interpix' ou 'interboleto'), $payload (JSON do webhook), $order_id.

add_action( 'wc_banco_inter_retry', function ( $method, $payload, $order_id ) {
    // Você pode logar, alertar ou intervir aqui
}, 100, 3 );

wc_ajax_banco_inter_order_is_paid

AJAX action usada pelo plugin pra checar status de pedido (Pix) na thank-you page. Geralmente você não precisa adicionar — está aqui só pra documentar a existência.

Filters

banco_inter_ticket_icon

Substitui o ícone do boleto exibido no checkout.

add_filter( 'banco_inter_ticket_icon', function ( $icon_url ) {
    return 'https://meusite.com/icones/boleto.svg';
} );

banco_inter_pix_icon

Substitui o ícone do Pix exibido no checkout.

{gateway_id}_setting_fields

Modifica os campos de configuração do gateway. {gateway_id} é interboleto ou interpix.

add_filter( 'interboleto_setting_fields', function ( $fields ) {
    // Remover, adicionar ou alterar campos do form de configuração
    return $fields;
} );

add_filter( 'interpix_setting_fields', function ( $fields ) {
    return $fields;
} );

{gateway_id}_request_args

Modifica o payload enviado à API do Banco Inter na hora de criar boleto/Pix.

Argumentos: $data (array da requisição), $order (WC_Order), $api (instância da classe de API).

add_filter( 'interboleto_request_args', function ( $data, $order, $api ) {
    // Ajustar campos da requisição (ex: forçar tipo de pessoa, mudar data de vencimento)
    return $data;
}, 10, 3 );

add_filter( 'interpix_request_args', function ( $data, $order, $api ) {
    return $data;
}, 10, 3 );

wc_banco_inter_allow_external_files

Permite que o plugin aceite certificados em qualquer caminho do servidor (por padrão, restrito ao diretório pai de ABSPATH).

add_filter( 'wc_banco_inter_allow_external_files', '__return_true' );

wc_banco_inter_bank_slip_preview_suffix

Modifica o sufixo da URL pública do boleto. Útil em servidores que não aceitam URLs sem extensão. Veja Modificar a URL do boleto.

add_filter( 'wc_banco_inter_bank_slip_preview_suffix', function ( $suffix ) {
    return '.pdf'; // padrão
} );

wc_banco_inter_bank_slip_url

Modifica a URL completa do PDF do boleto (override total).

Argumentos: $url (URL gerada), $order_key (chave do pedido).

add_filter( 'wc_banco_inter_bank_slip_url', function ( $url, $order_key ) {
    return $url;
}, 10, 2 );