FernandoAcosta.Netdocs

Como funciona

2 min de leituraAtualizado há 5 dias

O Pix e Boleto Banco Inter integra a sua loja WooCommerce diretamente com a API do Banco Inter. Cliente paga, plugin recebe a confirmação, pedido entra em processando automaticamente. Sem você abrir o internet banking pra dar baixa.

O que o plugin oferece

  • Boleto com linha digitável, código de barras e PDF gerado a cada checkout (API v3 do banco).
  • Pix com QR code e código "Copia e Cola", expirando no prazo que você definir.
  • Webhook configurado automaticamente — quando o cliente paga, a notificação chega em segundos.
  • Cron horário como rede de segurança: se o webhook falhar, o plugin consulta cada pedido pendente.
  • Bloco de checkout WooCommerce nativo (Storefront, FSE, etc.).
  • HPOS (High-Performance Order Storage) suportado.

Como o pagamento aprova sozinho

Cliente paga (Pix ou Boleto)
        ↓
Banco Inter envia webhook
        ↓
Plugin marca o pedido como "processando"
        ↓
Cliente recebe e-mail de confirmação
        ↓
Estoque atualizado, fluxo seguindo

Se o webhook não chega (queda de rede, instabilidade do banco), o cron horário roda automaticamente e consulta o status de cada Pix e cada boleto pendente. Veja Verificação automática e webhooks.

Componentes principais

Componente O que faz
Gateway Boleto Banco Inter Gera boleto, atende /wc-api/interboleto, exibe linha digitável e link do PDF
Gateway Pix Banco Inter Gera Pix, atende /wc-api/interpix, exibe QR code e Copia e Cola
Cron horário Re-consulta pedidos pendentes (fallback de webhook)
Bloco de checkout Renderiza Pix e Boleto no checkout block do WooCommerce
Print_Bank_Slip Serve o PDF do boleto em /boleto/{order_key}

Requisitos

Conta PJ é obrigatória

A API do Banco Inter usada pelo plugin não funciona com MEI. Precisa ser conta PJ regular. E você precisa conseguir enviar arquivos pro servidor (os certificados do banco).

  • WooCommerce 8.0+ e WordPress 5.9+
  • PHP 8.0+
  • Extensão cURL (obrigatória)
  • Extensão GD (pra gerar QR code do Pix)
  • Acesso de escrita em /boletos-pdf/ (cache de PDFs)
  • Certificados .key e .crt baixados do Banco Inter

Próximos passos

  1. Configuração inicial — criar app no banco, subir certificados, ativar gateways.
  2. Segurança dos certificados — manter os arquivos fora do public_html.
  3. Verificação automática e webhooks — entender o fluxo de aprovação.

Para devs, há uma seção dedicada com hooks e filters, meta dados do pedido e constantes do plugin.

Foi útil?