Artigos nessa seção

Exibir mais

Como Instalar o Plugin API PIX Banco Inter para Woocommerce?

Bruno Alencar
  • Atualizado
Seguir

⚠ Atenção

1 — Para obter o plugin, baixar ou obter atualizações, acesse sua conta > downloads em www.loja5.com.br.
2 — Para atualizações, o processo é o mesmo de instalação (guia abaixo). Lembre-se de fazer backup antes e reconfigurar o módulo após atualizar os arquivos.

Instalando e Configurando o Plugin Banco Inter API — Pix

🔧 Requisitos

⚡ Método de Pagamento Suportado

  • Pix — pagamento instantâneo direto na conta Banco Inter, com QR Code e código Copia e Cola

📦 Como Instalar

Passo 1 — Baixar o plugin

Acesse sua conta em Loja5 > Downloads, baixe o arquivo do módulo e copie seu serial de registro. Mantenha o serial salvo em seu HD ou nuvem (só guardamos downloads por 6 meses). Após baixado, descompacte o arquivo (use WinRAR).

Passo 2 — Enviar os arquivos

A instalação pode ser feita por FTP ou painel WordPress:

Via FTP: acesse o servidor, vá até wp-content/plugins e envie a pasta loja5-woo-inter-pix.
Via painel: acesse Plugins > Adicionar Novo > Enviar Plugin, selecione o arquivo loja5-woo-inter-pix.zip (o .ZIP original, não descompactado) e clique em instalar.

Passo 3 — Ativar o plugin

Acesse Plugins > Plugins Instalados, localize o plugin e clique em Ativar.

Passo 4 — Configurar o plugin

Acesse WooCommerce > Configurações > Pagamentos e clique em API Pix Banco Inter. Informe o serial de licença (copiado da sua conta Loja5) e salve. Se a tela de configuração não aparecer, clique aqui.

Passo 5 — Preencher os dados de integração

Preencha todos os campos conforme as instruções de cada um: dados da API (client_id, client_secret), certificados, chave Pix, regras de negócio, status dos pedidos e prazo de expiração.
Realize um teste de compra após finalizar.

🔒 Certificados Digitais (mTLS)

O Banco Inter exige certificado digital para autenticação. Eles são gerados ao criar a aplicação API na sua conta PJ. Baixe os arquivos para seu PC.
Link: ajuda.bancointer.com.br — como cadastrar uma API

⚠ Importante:
• Envie os arquivos via FTP ou Gestor de Arquivos da hospedagem para o diretório do plugin.
• Renomeie o arquivo .CRT para certificado.crt e o .KEY para chave.key.
• O plugin avisa no painel admin quando o certificado estiver próximo de expirar.

📡 Webhook (Notificação Instantânea)

O plugin suporta webhook para receber notificações automáticas do Banco Inter quando um Pix é pago ou devolvido. Na tela de configuração, use os links Instalar Webhook / Consultar / Remover. Seu site precisa estar em HTTPS (SSL) para usar webhook.

💻 Checkout Blocks (WooCommerce)

Compatível com o Checkout Blocks nativo do WooCommerce. O campo de CPF/CNPJ aparece integrado ao formulário de pagamento. Suporte a CNPJ alfanumérico (novo formato da Receita Federal com letras).

🔍 Consultando Pix Emitidos

No menu Pedidos Pix — Banco Inter você encontra todos os Pix emitidos com filtros por status e opção de devolução dos pedidos pagos.

 

🔄 Devolução de Pix

Para pedidos já pagos, é possível fazer a devolução total ou parcial diretamente pela lista de pedidos. Clique no botão Devolver Pix e confirme a operação.

⏰ Cron — Atualização Automática de Status

Para atualização automática dos status, configure o cron (URL abaixo) para executar a cada 1 hora ou a cada 10 minutos. Se usa webhook, a atualização é instantânea.

/wp-admin/admin-ajax.php?action=loja5_woo_inter_pix_cron

🐞 Modo Debug

Em caso de erros, ative o Modo Debug na configuração do plugin. Os logs ficam em WooCommerce > Status > Logs — selecione o log loja5_woo_inter_pix.

Principais erros da API: developers.bancointer.com.br/docs/principais-erros

⚠ Cuidado: Não configure o status "Aguardando Pagamento" com o status "Pagamento Pendente" do WooCommerce. Isso pode causar cancelamentos indevidos por tempo de estoque e impedir o envio de e-mails ao cliente.

❓ Dúvidas Frequentes

Problema ao ativar o módulo?
Clique aqui para ver as instruções

Trocar o domínio da licença?
Clique aqui para ver as instruções

Gostou do módulo? Acesse www.loja5.com.br e avalie ⭐

Artigos relacionados

Comentários

0 comentário

Artigo fechado para comentários.