Troubleshooting

Lista dos problemas mais comuns e como resolver. Se nada aqui se encaixa, abra um chamado pelo suporte.

Banner não aparece na página de obrigado

Cheque, em ordem:

1. ID da Loja está preenchido em WooCommerce → Configurações → Integração → Ebit? Sem ele, nenhum banner é renderizado.
2. O pedido foi finalizado de verdade (status pago/processando)?
3. O tema chama wp_footer() no rodapé? Sem isso, o JS do Ebit não carrega no modo padrão (não-inline).
4. Outro plugin ou o tema removeu o hook woocommerce_thankyou? Teste com um tema padrão (Storefront) pra isolar.
5. Prioridade muito alta ou muito baixa? Tente 99 pra renderizar depois de outros elementos da página.

Se a div existe mas o JS não carrega, ative Script inline em Configuração e teste de novo.

Banner por e-mail não aparece

O banner por e-mail tem 4 condições — todas precisam ser verdadeiras:

1. ID da Loja preenchido.
2. Banner por e-mail com URL válida.
3. O e-mail não é pra admin.
4. O pedido tem menos de 24 horas.

Cheques específicos:

• O e-mail enviado é dos tipos suprimidos? (failed_order, customer_refunded_order, cancelled_order)
• A URL do banner é acessível publicamente? (Cole no navegador anônimo e veja se a imagem carrega.)
• Você está testando com um pedido antigo? Crie um pedido novo pra cair na janela de 24h.

Veja banner por e-mail pros detalhes.

Código EAN não aparece no banner

1. Campo para Código EAN em Configuração tem o nome correto do meta?
2. Os produtos têm o EAN preenchido nesse meta?
3. Pra debugar, use o filtro wc_ebit_eanCode e logue o valor:

add_filter( 'wc_ebit_eanCode', function( $ean, $product, $item ) {
    error_log( 'EAN do produto ' . $product->get_id() . ': ' . var_export( $ean, true ) );
    return $ean;
}, 10, 3 );

Tipo de pagamento errado (caiu em "Outros")

O gateway que você usa não está na lista de detecção automática. Cheque métodos de pagamento detectados — se o gateway não está lá, mapeie via filtro:

add_filter( 'wc_ebit_payment_type', function( $type, $order ) {
    if ( 'meu-gateway' === $order->get_payment_method() ) {
        return '08'; // Boleto
    }
    return $type;
}, 10, 2 );

Detalhes em adicionar suporte a outro gateway.

Medalha ([wc_ebit_medalha]) não renderiza

1. ID da Loja preenchido?
2. O shortcode está sendo processado? Em widgets clássicos antigos, ative o filtro widget_text → do_shortcode.
3. O JS do Ebit carregou? Se a página onde você usa o shortcode não chama wp_enqueue_scripts, ative Script inline em Configuração.

Banner aparece duas vezes

Geralmente é o tema ou outro plugin chamando o hook woocommerce_thankyou mais de uma vez (por exemplo, num shortcode de "obrigado" customizado).

Pra debugar, use um plugin como Query Monitor pra ver quantas vezes a action dispara.

Pedido HPOS — algo quebrou?

O plugin é compatível com High-Performance Order Storage desde a versão 1.5.1. Se você usa HPOS e algo está estranho, confirme que está na 1.5.1+ em Plugins → Plugins instalados.

Próximos passos

• Configuração — revisar todas as opções.
• Filtros disponíveis — pra customizações.