Pagou – Payments for WooCommerce

Pagou for WooCommerce connects your store to the Pagou payment gateway, so you can accept the two most used payment methods in Brazil: PIX (instant bank transfer) and boleto bancário (bank slip).

Main features

• PIX payments with automatic confirmation: the customer pays and the order is updated on its own, with no need to send a receipt.
• Boleto bancário with barcode, digitable line and PDF, including optional late fee and interest.
• Discount per payment method: offer, for example, 5% off for customers who pay with PIX (percentage or fixed amount). This is configured by the store owner and applied to the amount actually charged.
• Payment screen with the amount in focus, expiration countdown, one-click copy button and step-by-step instructions.
• PIX code and boleto digitable line included in the order emails, so the customer never loses the code.
• Automatic reconciliation every 15 minutes: if a payment notification fails to reach the store, the plugin queries Pagou and confirms the order anyway.
• Signed webhooks (HMAC-SHA256) with replay protection, amount verification and idempotency.
• Compatible with the classic checkout, the Cart and Checkout Blocks and HPOS (High-Performance Order Storage).

Requirements

A Pagou account and API key, plus the WooCommerce and Brazilian Market on WooCommerce plugins.

Em português

O plugin integra o WooCommerce ao gateway de pagamento Pagou, permitindo receber por PIX e Boleto Bancário, com confirmação automática do pagamento, desconto configurável por meio de pagamento e conciliação automática. Precisa de uma conta Pagou, do WooCommerce e do plugin Brazilian Market on WooCommerce.

Supported Languages

• English (en_US)
• Portuguese (Brazil) (pt_BR)

External services

Este plugin utiliza os seguintes serviços externos:

1. Pagou API

   • Uso: Processamento de pagamentos via PIX e boleto usando ambiente de homologação e produção.
   • Dados Enviados: Informações de transações financeiras, incluindo valores, produtos e dados do cliente.
   • Quando: Durante a criação, consulta e reembolso de pagamentos.
   • Termos de Uso: Link para os termos de uso da Pagou.
   • Política de Privacidade: Link para a política de privacidade da Pagou.
   • Dados enviados para: Homolog ou produção da Pagou.

2. ViaCEP

   • Uso: Busca de endereço a partir do CEP informado.
   • Dados Enviados: CEP digitado pelo usuário.
   • Quando: No momento do preenchimento do endereço no checkout.
   • Termos de Uso: Termos de Uso do ViaCEP.

Política de Privacidade e Termos de Uso

• Termos de Uso do Pagou
• Política de Privacidade do Pagou

Frequently Asked Questions (FAQ)

= Como configuro os pagamentos via PIX e Boleto?
Após ativar o plugin, vá até as configurações de pagamento do WooCommerce e habilite as opções de pagamento “Pagou” para PIX e Boleto.

Quais são os requisitos mínimos para usar o plugin?

Você precisa de pelo menos o WordPress 6.6 e PHP 7.4 para rodar o plugin.

Como ofereço desconto para quem pagar com PIX?

Vá em WooCommerce > Configurações > Pagamentos > PIX e preencha o “Valor do desconto” (por exemplo, 5) escolhendo o tipo “Percentual (%)” ou “Valor fixo (R$)”. O desconto incide sobre o subtotal dos produtos, aparece no checkout ao lado do nome do meio de pagamento e já é aplicado no valor cobrado. O mesmo vale para o Boleto.

E se a notificação de pagamento não chegar na minha loja?

O plugin consulta a Pagou automaticamente a cada 15 minutos e confirma os pedidos que já foram pagos, mesmo que a notificação tenha se perdido.

License

Este plugin está licenciado sob a GPLv2 ou posterior.

1. Faça o upload do plugin para o diretório /wp-content/plugins/.
2. Ative o plugin através do menu “Plugins” no WordPress.
3. Acesse as configurações de WooCommerce para configurar os métodos de pagamento Pagou (PIX e Boleto).

1.3.1

• Correção: pagamentos deixavam de ser gerados em lojas cujo checkout não preenche o campo “tipo de pessoa”, com a mensagem “Falha ao validar os dados enviados: Nome Completo e Documento (CPF/CNPJ)”. O documento do cliente agora é localizado em qualquer checkout e o tipo de pessoa é identificado pelo próprio CPF ou CNPJ.
• Correção: descontos em percentual terminados em zero apareciam errados no checkout (10% era exibido como 1%, 20% como 2%). O valor cobrado sempre esteve correto; o problema era apenas na exibição.
• Melhoria: se o CPF ou CNPJ estiver ausente ou inválido, o cliente recebe uma mensagem clara em vez do erro genérico devolvido pela API.

1.3.0

• Novo: desconto por meio de pagamento. Configure, por exemplo, 5% de desconto no PIX (percentual ou valor fixo) e aumente a conversão do checkout.
• Novo: o desconto aparece junto ao nome do meio de pagamento no checkout, como “PIX (5% de desconto)”.
• Novo: ícones do PIX e do boleto na lista de meios de pagamento, no checkout clássico e no checkout em blocos.
• Melhoria: os meios de pagamento passam a se chamar “Pix Instantâneo” e “Boleto Bancário” por padrão, com textos de checkout mais claros. Nome e descrição continuam totalmente editáveis nas configurações de cada meio de pagamento; lojas que já personalizaram esses campos não são afetadas.
• Novo: conciliação automática a cada 15 minutos, que confirma pagamentos caso alguma notificação (webhook) não chegue à loja.
• Novo: registro de log das chamadas à API e dos webhooks em WooCommerce > Status > Logs, ativado pelo “Modo Debug”.
• Novo: tela de pagamento redesenhada. O pagamento aparece antes dos detalhes do pedido, com valor em destaque, contagem de expiração do código, botão de copiar com confirmação e passo a passo.
• Novo: a tela identifica o pagamento sozinha e se atualiza, sem o cliente precisar recarregar nem enviar comprovante.
• Novo: o código Pix e a linha digitável do boleto passam a ir nos e-mails do pedido, com link para a tela de pagamento.
• Novo: boletos da Pagou aceitam Pix, e a tela agora oferece essa opção para quem quiser confirmação imediata.
• Melhoria: boleto pago em atraso, com multa e juros, passa a ser confirmado normalmente, registrando o valor efetivamente pago.
• Melhoria: textos do checkout deixam claro que falta pagar, em vez de sugerir que o pedido já está concluído.
• Correção: o endereço no checkout em blocos não exibe mais marcadores como {number} e {neighborhood} quando o plugin Brazilian Market on WooCommerce está ativo. Nos e-mails e no painel o endereço continua completo, com número e bairro.
• Correção: o QR Code do Pix mantém o tamanho correto mesmo se a folha de estilo do plugin não carregar (cache do navegador, plugins de otimização).
• Melhoria: a tela de pagamento ganhou estilos de impressão, com o código completo e sem os elementos que não fazem sentido no papel.

1.2.0

• Segurança: validação da assinatura HMAC (X-Pagou-Signature) em todos os webhooks, com proteção contra repetição (replay).
• Segurança: a chave de API deixou de ser gravada nos metadados do pedido.
• Correção: confirmação de pagamento passa a localizar o pedido de forma confiável (por id da cobrança/QRCode), corrigindo pedidos que ficavam presos em “aguardando”.
• Correção: conferência do valor pago antes de concluir o pedido.
• Correção: estorno via PIX não é mais disparado com valor incorreto; estorno via boleto passa a detectar erros da API corretamente.
• Correção: geração de boleto no checkout em blocos (Cart/Checkout Blocks), incluindo endereço do pagador.
• Correção: tipo de pessoa (Física/Jurídica) e documento no checkout em blocos.
• Correção: carregamento das traduções e do hook de ativação.
• Compatibilidade declarada com HPOS (High-Performance Order Storage) e com o checkout em blocos.
• Ajustes de tempo de expiração padrão do PIX e diversas correções menores.

1.1.2

• Ajustes nos logs de erros.

1.1.1

• Ajustes na geração dos boletos.

1.1.0

• Configuração manual de tempo de expiração do PIX.

1.0.6

• Remoção de bibliotecas sem uso.

1.0.5

• Atualizações de compatibilidades.

1.0.4

• Atualizações de bibliotecas.

1.0.3

• Ajustes de compatibilidade com checkout legacy, blocks e Elementor.

1.0.21

• Atualizações com WordPress.

1.0.2

• Atualização de bibliotecas e configurações de segurança.

1.0.1

• Corrigido o domínio de tradução para corresponder ao slug do plugin.
• Adicionada a documentação do uso de serviços externos no arquivo readme.
• Adicionada verificação de ABSPATH para evitar acesso direto aos arquivos PHP.

1.0.0

• Versão inicial do plugin, integração com métodos de pagamento PIX e Boleto via Pagou.