Pagou - Payments for WooCommerce
| 开发者 |
pagoupagamentos
alissonic |
|---|---|
| 更新时间 | 2026年10月25日 05:15 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Pagou for WooCommerce connects your store to the Pagou payment gateway and adds the most used payment methods in Brazil: Pix (instant bank transfer), boleto bancário (bank slip) and credit card.
Payment methods
- Pix with automatic confirmation: the customer pays and the order is updated on its own.
- Boleto bancário with barcode, digitable line, PDF and an embedded Pix code, including optional late fee and interest.
- Credit card with installments. The store owner sets the maximum number of installments, the minimum installment amount, how many installments are interest free and the monthly interest rate (Price table). Interest is shown on the order as a separate fee.
- Saved cards: returning customers can pay with a card saved in My Account. Only a token issued by Pagou is stored; card data never reaches your server.
- Split each sale between your Pagou account and other Pagou accounts (sellers, partners, affiliates).
- Global rules for the whole store, plus a rule per product (use the global rule, a specific rule or no split).
- Percentage or fixed amount, calculated over the products or over the whole order.
- If Pagou rejects the split (for example, a recipient was not authorized), the sale is not lost: the charge is created without split and the store owner is warned in the dashboard and on the order.
- Compatible with the classic checkout, the Cart and Checkout Blocks and HPOS (High-Performance Order Storage).
- Brazilian checkout fields (CPF/CNPJ, number and neighborhood) are added automatically when no other plugin provides them. Brazilian Market on WooCommerce is optional.
- Discount per payment method (percentage or fixed amount), for example 5% off with Pix.
- Payment screen with the amount in focus, expiration countdown, one-click copy and automatic update when the payment is confirmed.
- Pix code and boleto digitable line included in the order emails.
- Signed webhooks (HMAC-SHA256) with replay protection, amount verification and idempotency, received by a REST API route.
- Automatic reconciliation every 15 minutes: if a notification does not reach the store, the plugin queries Pagou and updates the order anyway.
- Card protections: idempotent charges, limit of declined attempts per order and per IP, and chargeback monitoring.
- Full refunds from the order screen (Pix and card).
安装:
- Install the plugin from Plugins > Add New, or upload it to
/wp-content/plugins/. - Activate it in the Plugins menu.
- Go to WooCommerce > Settings > Pagou, choose the environment and paste your API key. Click "Test connection".
- Enable Pix, boleto and credit card in WooCommerce > Settings > Payments.
- Optional: configure the split in WooCommerce > Settings > Pagou and, per product, in the "Split Pagou" tab.
常见问题:
Where do I get the API key?
In your Pagou dashboard. The same key is used for Pix, boleto and credit card. You can also define it with the PAGOU_API_KEY constant in wp-config.php to keep it out of the database.
Do I need Brazilian Market on WooCommerce?
No. Since 2.0.0 the plugin adds the CPF/CNPJ, number and neighborhood fields itself when they are missing. If Brazilian Market is active, the classic checkout uses its fields.
How are card installments with interest calculated?
You choose up to how many installments are interest free and the monthly rate charged above that. The plugin uses the Price table and adds the interest to the order as a fee, so the amount charged matches what the customer saw.
Is card data stored in my store?
No. The card is encrypted in the browser by the Pagou script and only a token reaches the store. Saved cards keep only the token, brand, last four digits and expiration date.
How do I set up the payment split?
Ask Pagou to enable split on your account and authorize each recipient in the Pagou dashboard. Then add the recipients (Pagou account ID) and their share in WooCommerce > Settings > Pagou. Each product can follow the global rule, have its own rule or have no split.
What happens if Pagou rejects the split?
The charge is created without split, so the customer can pay normally, and the store owner sees a warning in the dashboard and a note on the order.
Can I make partial refunds?
Card refunds must be full refunds, as required by the Pagou card API.
What if the payment notification does not reach my store?
The plugin checks pending orders with Pagou every 15 minutes and confirms the ones already paid.
Is there a sandbox?
Yes. Choose "Sandbox" in WooCommerce > Settings > Pagou and use the API key of your Pagou sandbox account.
更新日志:
2.0.1
- Correção: o QR Code do Pix não aparecia na tela de pagamento em parte das lojas; o código copia e cola funcionava normalmente. O script da tela carregava antes da biblioteca do QR Code. O mesmo afetava o código de barras do boleto.
- Melhoria: o QR Code e o código de barras passam a ser desenhados mesmo com plugins de cache ou otimização que adiam, juntam ou reordenam os scripts da página.
- Novo: cartão de crédito, no checkout clássico e no checkout em blocos. O cartão é criptografado no navegador pela Pagou e só um token chega à loja.
- Novo: parcelamento configurável pelo lojista: número máximo de parcelas, valor mínimo da parcela, parcelas sem juros e juros ao mês (tabela Price). Os juros aparecem no pedido como "Juros do parcelamento".
- Novo: cartão salvo em Minha conta > Métodos de pagamento, para o cliente comprar de novo sem digitar o cartão.
- Novo: estorno integral do cartão pelo pedido e monitoramento de chargebacks, com o status do pedido configurável.
- Novo: proteções do cartão: cobrança idempotente, limite de tentativas recusadas por pedido e por IP, captura automática de cartões só autorizados e conciliação de cobranças com resposta incerta.
- Novo: split de pagamento entre contas Pagou, com regras globais e por produto, em percentual ou valor fixo, sobre os produtos ou sobre o pedido inteiro. Se a Pagou recusar o split, a venda segue sem ele e o lojista é avisado no painel e no pedido.
- Novo: aba WooCommerce > Configurações > Pagou, com uma única chave de API para todos os meios, escolha do ambiente e botão "Testar conexão". A chave pode ficar na constante PAGOU_API_KEY.
- Novo: campos de CPF/CNPJ, número e bairro próprios, no checkout em blocos e no clássico. O Brazilian Market on WooCommerce deixou de ser obrigatório.
- Novo: webhook recebido por rota da API REST do WordPress, que funciona mesmo sem permalinks amigáveis. A URL antiga continua aceita.
- Melhoria: o QR Code do Pix é desenhado no navegador, reduzindo de cerca de 29 KB para menos de 1 KB o que fica salvo em cada pedido.
- Melhoria: os templates da tela de pagamento podem ser sobrescritos pelo tema em
woocommerce/pagou/. - Correção: o sandbox aponta para o novo endereço da Pagou (api.pagou.cloud).
- Atualização: as configurações da 1.x são migradas automaticamente. Pedidos Pix e boleto pendentes criados na versão anterior continuam funcionando.
- 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.
- 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.
- 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.
- Ajustes nos logs de erros.
- Ajustes na geração dos boletos.
- Configuração manual de tempo de expiração do PIX.
- Remoção de bibliotecas sem uso.
- Atualizações de compatibilidades.
- Atualizações de bibliotecas.
- Ajustes de compatibilidade com checkout legacy, blocks e Elementor.
- Atualizações com Wordpress.
- Atualização de bibliotecas e configurações de segurança.
- 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
ABSPATHpara evitar acesso direto aos arquivos PHP.
- Versão inicial do plugin, integração com métodos de pagamento PIX e Boleto via Pagou.