Pra ativar Pix e Boleto na sua loja, você passa por três etapas: criar o app no Banco Inter, subir os certificados pro servidor e configurar os dois gateways no WooCommerce.
O plugin não funciona com MEI. Precisa ser conta PJ regular do Banco Inter. Sem isso, a API não libera as autorizações de cobrança.
1. Criar o app no Banco Inter
No internet banking PJ do banco, vá em Conta digital → Aplicações → Gestão de aplicações e crie uma nova aplicação seguindo o tutorial oficial.
Nas autorizações:
- Nada de banking. Não precisa.
- Tudo de Cobrança e Pix. Marque todas as opções dessas duas categorias.
Depois de criar, a aplicação fica em Em análise. Pode levar uma hora ou mais — depende só do banco. Enquanto isso, baixe os dois certificados que aparecem na tela e guarde em local seguro. Você não vai conseguir baixar de novo depois.
2. Subir os certificados pro servidor
O download do banco vem como ZIP. Dentro tem dois arquivos com nomes parecidos com:
Inter API_Chave.keyInter API_Certificado.crt
Renomeie removendo os espaços. Algo como key.key e crt.crt funciona bem.
Os arquivos precisam ficar fora do diretório público (raiz do servidor, num nível acima do public_html / htdocs / www). É exigência do banco e questão real de segurança — certificado exposto na web é credencial vazada.
Se a hospedagem não permitir isso, veja Segurança dos certificados.
Use SFTP, painel da hospedagem ou o que tiver disponível. Anote o caminho absoluto dos dois arquivos — você vai precisar nas configurações.
3. Configurar os gateways
Vá em WooCommerce → Configurações → Pagamentos. Você vai encontrar dois métodos novos:
- Boleto Banco Inter (id
interboleto) - Pix Banco Inter (id
interpix)
Eles são configurados separadamente. Os campos comuns aos dois:
| Campo | O que faz |
|---|---|
| Ativo/Inativo | Liga ou desliga o método no checkout |
| Title | Nome exibido no checkout (ex: "Boleto", "Pix - Banco Inter") |
| Descrição | Texto curto abaixo do título no checkout |
| Instruções por e-mail | Conteúdo extra nos e-mails de confirmação |
| ID do cliente | Client ID da aplicação no banco |
| Chave secreta | Client Secret da aplicação no banco |
| Chave do certificado (.key) | Caminho absoluto do .key no servidor |
| CRT do certificado (.crt) | Caminho absoluto do .crt no servidor |
| Ativar debug | Salva logs de requisições em WooCommerce → Status → Logs |
| Webhooks e configurações | Status do webhook, com botão pra reconfigurar |
Específicos do Boleto
| Campo | O que faz | Padrão |
|---|---|---|
| Prazo do boleto | Dias até o vencimento | 3 |
| Mensagens | Até 4 linhas livres impressas no boleto | "Não receber após o vencimento" |
| Posição dos dados do boleto na página de pagamento | Onde a linha digitável aparece na thank-you page | Antes de tudo |
Específicos do Pix
| Campo | O que faz | Padrão |
|---|---|---|
| Chave Pix | Sua chave (CPF, CNPJ, e-mail, celular ou aleatória) | — |
| Prazo do pix | Minutos até o QR code expirar | 60 |
| Posição dos dados do Pix na página de pagamento | Onde o QR code aparece na thank-you page | Antes de tudo |
4. Caminho do certificado no campo
Os campos .key e .crt esperam caminho absoluto, começando da raiz real do servidor. Sua hospedagem provavelmente diz algo como "começa com /public_html/site.com.br/" — então o caminho que você informa é o do arquivo final, por exemplo:
/public_html/site.com.br/key.key
Ou melhor (se conseguiu colocar fora do public_html):
/home/usuario/certificados/key.key
5. Salvar e checar webhook
Quando você salva as configurações, o plugin cria o webhook automaticamente no banco. Se aparecer erro vermelho na tela depois de salvar, a configuração de credenciais ou caminhos provavelmente está errada — confira logs em WooCommerce → Status → Logs (arquivos interboleto-*.log e interpix-*.log).
Pra usar a integração em mais de um site da mesma conta PJ, cada loja precisa de uma chave Pix distinta. Se duas lojas compartilham a mesma chave, as notificações de pagamento se confundem.
Com gateways ativados e webhook configurado, a loja já está aceitando Pix e Boleto com aprovação automática. Para entender o fluxo completo, veja Verificação automática e webhooks.