=== PagBank / PagSeguro Connect para WooCommerce ===
Contributors: martins56
Tags: pagseguro, pagbank, pix, woocommerce, brasil
Donate link: https://github.com/sponsors/r-martins
Requires at least: 4.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 4.47.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html
PagBank com PIX, Cartão de Crédito, Boleto, Recorrência + Envio Fácil e com Menos Taxas no PagSeguro.
Autenticação 3D: menos chargeback + aprovações.

== Description ==

**Aceite PagBank (PagSeguro) (Pix, Cartão de Crédito, Boleto) em sua loja WooCommerce.**

**🌟[Parceiro oficial](https://developer.pagbank.com.br/docs/ricardo-martins-woocommerce) PagBank/PagSeguro desde 2014.**

**Economize nas taxas PagBank.** Receba no crédito à vista **a partir de 3,05% + R$0,00** de taxa de intermediação e PIX na hora por 0,99%. [Veja tabela completa](https://pbintegracoes.com/compare/?utm_source=readme&utm_content=tabela-comparativa).

O **melhor plugin de pagamentos** do Brasil.

Com **recursos exclusivos**, de código aberto e gratuito. Integre seu WooCommerce com PagBank (PagSeguro) agora.

Receba Pix, Boleto e Cartão de Crédito no seu WooCommerce em minutos. 

Veja nosso [**passo a passo de instalação**](https://pbintegracoes.com/woocommerce/?utm_source=readme&utm_content=passoapasso#instrucoes) simplificado com vídeos.

**📈 Conecte, converta, cresça. 👏 Feito pra quem compara e toma as próprias decisões.**

🚀️Atualizações quase todas as semanas, suporte e [instalação gratuita](https://pbintegracoes.com/woocommerce/agenteinstala/?utm_source=readme&utm_content=agenteinstala), e taxas cada vez menores para lojas antigas e novas.

**🏆 TOP 1 em pagamentos WooCommerce no Brasil! 100% Gratuito!**

=== ⚡️Taxas menores pra você, mais lucro pra crescer===
Ao invés de pagar 3,99% + R$0,40 ou 4,99% + R$0,40 por transação aprovada no Cartão de Crédito, você pode optar por:
1. **Recebimento em 30 dias**: **3,05% + R$0,00** por transação aprovada no Cartão de Crédito (mais popular)
2. **Recebimento em 14 dias**: 3,97% + R$0,00 por transação aprovada no Cartão de Crédito
3. **PIX**: sempre 0,99% com recebimento na hora
4. **Boleto**: sempre 1,99% com recebimento em 2 dias

Se você tiver taxas negociadas ou condições negociadas melhores que estas, você também pode utilizá-las.

Consulte mais sobre elas e compare no [nosso site](https://pbintegracoes.com/compare/?utm_source=readme&utm_content=taxas).

== ⚡️ PRINCIPAIS RECURSOS ==
* Pagamentos sem sair da loja com **PIX**, **Cartão de Crédito**, **Boleto** ou **Checkout PagBank** (redirect/link).
* Venda clubes e assinaturas com [**pagamento recorrente**](https://ajuda.pbintegracoes.com/hc/pt-br/sections/20410120690829-Recorr%C3%AAncia-e-Clube-de-Assinatura-com-WooCommerce), sem depender de outros plugins 🤯
* **OnlyFans** - Restrição de conteúdo só para assinantes. Restrinja o acesso à páginas e categorias somente pra quem é assinante. [Veja como](https://www.magenteiro.com/blog/wp/restricao-conteudo-para-assinantes-wordpress/).
* Integração com [**Envio Fácil**](https://ajuda.pbintegracoes.com/hc/pt-br/articles/19944920673805-Envio-F%C3%A1cil-com-WooCommerce) (economize até 70% no frete com Correios e Jadlog) sem precisar de contrato
* Suporte nativo ao [**checkout em Blocos**](https://ajuda.pbintegracoes.com/hc/pt-br/articles/31097182009741-Suporte-ao-Checkout-em-Blocos) do WooCommerce (sem gambiarras com iframes), Checkout Legado, Fluid Checkout e muitos outros.
* 🔒 [**Autenticação 3D**](https://ajuda.pbintegracoes.com/hc/pt-br/articles/22375922278157-Autentica%C3%A7%C3%A3o-3DS-Sua-prote%C3%A7%C3%A3o-contra-Chargeback) para acabar com chargebacks e aumentar aprovação. Pode ser configurado somente para pagamentos negados na primeira tentativa.
* [**Reembolso** parcial ou total](https://ajuda.pbintegracoes.com/hc/pt-br/articles/30882664582541-Reembolso-total-ou-Parcial) direto do painel do WooCommerce
* Atualização de pedidos automática, inclusive com [confirmação de pagamento instantâneo PIX](https://ajuda.pbintegracoes.com/hc/pt-br/articles/31097176784653-Confirma%C3%A7%C3%A3o-Instant%C3%A2nea-de-Pagamento-PIX) com [comportamento configurável](https://ajuda.pbintegracoes.com/hc/pt-br/articles/34191612071437-Comportamento-ao-confirmar-pagamento).
* Infinitas [**opções de parcelamento**](https://ajuda.pbintegracoes.com/hc/pt-br/articles/19945359660173-Op%C3%A7%C3%B5es-de-Parcelamento) ∞
* 💳 [Salvar Cartão](https://ajuda.pbintegracoes.com/hc/pt-br/articles/38366350272397-Salvar-Cart%C3%A3o-de-Cr%C3%A9dito-no-WooCommerce) - Permite que seus clientes salvem o token do cartão de crédito para compras futuras, sem precisar digitar os dados novamente.
* ⑂ Divisão de Pagamentos entre contas (Split)

== ⚡️ RECURSOS ADICIONAIS ==
* Suporte a [**descontos** no boleto e pix](https://ajuda.pbintegracoes.com/hc/pt-br/articles/19945430928909-Oferecer-Desconto-Pix-e-Boleto) (percentual ou fixo)
* Permite definir [**validade** de boletos e código PIX](https://ajuda.pbintegracoes.com/hc/pt-br/articles/24770387325837-Cancelamento-autom%C3%A1tico-de-pedidos-PIX-expirados) (em dias ou minutos)
* Atualizações automáticas de **status de pedidos** mesmo que sua loja bloqueie as notificações automáticas do PagBank
* Opção de [forçar atualização](https://github.com/r-martins/PagBank-WooCommerce/releases/tag/4.31.0) de um pedido manualmente ou automaticamente
* Permite adicionar [código JavaScript ou redirecionar](https://ajuda.pbintegracoes.com/hc/pt-br/articles/34191612071437-Comportamento-ao-confirmar-pagamento) o cliente após a confirmação de pagamento.
* Configure como quer exibir o [nome da loja na fatura do cartão de crédito](https://ajuda.pbintegracoes.com/hc/pt-br/articles/19945038495629-Identificador-na-fatura)
* Diversas [opções de configuração de endereço](https://ajuda.pbintegracoes.com/hc/pt-br/articles/20835022998029-Configura%C3%A7%C3%B5es-de-Endere%C3%A7o-de-Entrega)
* Suporte nativo a [High-Performance Order Storage (**HPOS**)](https://woo.com/document/high-performance-order-storage/)
* Exibição de [informações de **parcelas na página de produto** em 3 formatos diferentes](https://ajuda.pbintegracoes.com/hc/pt-br/articles/26223028355597-Exibir-informa%C3%A7%C3%B5es-de-parcelamento-na-p%C3%A1gina-de-produto)
* **Hooks** disponíveis para facilitar integrações e modificações que você queira fazer sem sobrescrever o plugin. [Veja documentação](https://ajuda.pbintegracoes.com/hc/pt-br/articles/27339148022669-Hooks-Filtros-e-A%C3%A7%C3%B5es-Dispon%C3%ADveis).
* Maior taxa de aprovação e estabilidade nas chamadas das APIs PagBank com [retentativa transparente](https://ajuda.pbintegracoes.com/hc/pt-br/articles/4695328655245-Porque-as-transa%C3%A7%C3%B5es-pelo-modelo-de-aplica%C3%A7%C3%A3o-t%C3%AAm-mais-sucesso) em caso de falha.
* Use a mesma conta PagBank e a mesma Connect Key para integrar **várias lojas** WooCommerce, sem precisar de uma Connect Key para cada loja.
* Integração com Marketplace Dokan para divisão de pagamentos entre múltiplos vendedores (split, multivendor)

https://www.youtube.com/watch?v=a8rkT8IyIYo

Criado por Ricardo Martins (**Parceiro oficial PagBank/PagSeguro desde 2014**), esta é a 4ª geração das integrações PagSeguro, disponibilizadas desde 2014 no Magento, e desde 2019 no WooCommerce. Mais de 20 mil lojas atendidas e mais de 200 milhões de reais transacionados em nossas integrações.

Além disso, você também pode aceitar **pagamentos recorrentes** e criar clubes de assinatura sem depender de plugins de terceiros.

https://www.youtube.com/watch?v=FOPwBTRryNM


**Problemas com aprovação de pagamentos e chargebacks em transações com cartão de crédito?**

Nossa integração possui [autenticação 3D Secure](https://ajuda.pbintegracoes.com/hc/pt-br/articles/22375922278157-Autentica%C3%A7%C3%A3o-3DS-Sua-prote%C3%A7%C3%A3o-contra-Chargeback), que reduz drasticamente seus custos com chargebacks, e aumenta significativamente a **taxa de aprovação**.

Tudo pra você vender mais com PagBank(PagSeguro) sem sequer precisar se preocupar em contratar um serviço de antifraude.


* Termos de uso e softwares terceiros
Ao instalar o plugin PagBank Connect, você concorda com as [Regras de uso do PagBank](https://pagseguro.uol.com.br/sobre/contrato-de-servicos), seu [Contrato de Serviço](https://pagseguro.uol.com.br/sobre/contrato-de-servicos), [Termos de Segurança, Privacidade](https://pagseguro.uol.com.br/sobre/seguranca-e-privacidade) e [Compartilhamento](https://pagseguro.uol.com.br/sobre/regras-de-compartilhamento), bem como os [Termos de uso e Política de Privacidade](https://pbintegracoes.com/terms/?utm_source=readme&utm_content=termos) do desenvolvedor.


== Installation ==

=== Instalação automática via painel ===
* Navegue até Plugins > Adicionar Novo e procure por "PagBank Ricardo Martins"
* Clique no botão para instalar e ative o plugin
* Se você não estiver usando o [checkout em blocos](https://ajuda.pbintegracoes.com/hc/pt-br/articles/31097182009741-Suporte-ao-Checkout-em-Blocos) (nativo do Woo), repita o processo buscando e instalando o plugin [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) a fim de habilitar campos adicionais de endereço e CPF, que são obrigatórios no PagBank.

=== WP-CLI ===
Você pode instalar o plugin usando o [WP-CLI](https://wp-cli.org/). 

* Basta rodar o comando `wp plugin install pagbank-connect --activate`. Adicione `--allow-root` se estiver rodando o comando como root.
* Se você não estiver usando o [checkout em blocos](https://ajuda.pbintegracoes.com/hc/pt-br/articles/31097182009741-Suporte-ao-Checkout-em-Blocos) (nativo do Woo), repita o processo para instalar o plugin [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) com o comando `wp plugin install woocommerce-extra-checkout-fields-for-brazil --activate` caso ainda não tenha ele instalado.

=== Instalação manual ===
* Baixe o [arquivo zip](https://codeload.github.com/r-martins/PagBank-WooCommerce/zip/refs/heads/master) e descompacte ele em sua máquina
* Faça upload dos arquivos na pasta /wp-content/plugins/pagbank-connect, usando seu FTP
* Navegue até Plugins > Plugins instalados, e ative o plugin PagBank Connect
* Se você não estiver usando o [checkout em blocos](https://ajuda.pbintegracoes.com/hc/pt-br/articles/31097182009741-Suporte-ao-Checkout-em-Blocos) (nativo do Woo), instale o plugin [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) a fim de habilitar campos adicionais de endereço e CPF, que são obrigatórios no PagBank.
* No terminal, navegue até a pasta do plugin (wp-content/plugins/pagbank-connect) e rode `npm install` para instalar as dependências do plugin. Em seguida, rode `npm run build` para compilar os arquivos do plugin.

=== A gente instala pra você 🙀 ===
Se você preferir, podemos instalar e configurar o plugin para você sem nenhum custo.

[SOLICITAR INSTALAÇÃO GRATUITA](https://pbintegracoes.com/woocommerce/agenteinstala/?utm_source=readme&utm_content=agenteinstala). 

=== Configuração ===
* Ative o meio de pagamento navegando até WooCommerce > Configurações > Pagamentos, e ativando o PagBank Connect
* Clique no PagBank Connect para acessar as configurações do módulo
* Clique em "Obter Connect Key". Você será levado para nosso site, onde poderá escolher o modelo de recebimento (14 ou 30 dias) e então autorizar nossa aplicação sem nenhum custo ou mensalidade.
* No nosso site, selecione o modelo de recebimento desejado (14 ou 30 dias - ou suas condições negociadas) e preencha as informações do responsável técnico por sua loja.
* Você será levado para o site do PagBank, onde poderá se logar e autorizar nossa aplicação em sua conta.
* Em seguida, sua *Connect Key* será exibida e enviada para o e-mail informado no passo anterior. Use ela nas configurações da sua loja.
* Salve as configurações e sua loja está pronta para vender.
* Se desejar, configure [opções de parcelamento](https://ajuda.pbintegracoes.com/hc/pt-br/articles/19945359660173-Op%C3%A7%C3%B5es-de-Parcelamento), e validade do boleto e código pix de acordo com suas necessidades.
* Conheça os [recursos disponíveis na sua integração](https://ajuda.pbintegracoes.com/hc/pt-br/sections/26127218629133-Recursos) para aproveitar ao máximo dela e vender ainda mais.

== Frequently Asked Questions ==
= Quais os requisitos para usar esta integração? =

* Ter WooCommerce 4.0 ou superior
* PHP 7.4 ou superior
* Ter uma conta Vendedor ou Empresarial no PagSeguro/PagBank
* [Autorizar nossa integração](https://pbintegracoes.com/connect/autorizar/?utm_source=readme&utm_content=pre-requisitos) em sua conta PagBank.
* Usar o Checkout em Blocos (nativo) **ou** Ter instalado o plugin [Brazilian Market on WooCommerce](https://br.wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) a fim de habilitar campos adicionais de endereço e CPF, que são obrigatórios no PagBank.

= Como funcionam os descontos nas taxas? =

Ao usar nossas integrações no modelo de recebimento em 14 ou 30 dias, ao invés de pagar 4,99% ou 3,99%, você pagará 3,97% ou 3,05% respectivamente e estará isento da taxa de R$0,40 por transação. Sem mensalidades.

Taxas menores também são aplicadas para transações parceladas, PIX e Boleto. PIX e Boleto também possuem prazos menores de recebimento.

Por exemplo, com PIX a taxa é de apenas 0,99% e o valor estará disponível em sua conta PagBank na hora.

= Eu tenho uma taxa ou condição negociada menor que estas. O que faço? =

Ao usar nossa integração, nossas taxas e condições serão aplicadas ao invés das suas. Isto é, nas transações realizadas com nosso plugin.

É importante notar que taxas negociadas no mundo físico (moderninhas) não são aplicadas no mundo online.

Se mesmo assim você possuir uma taxa ou condição melhor, e se compromete a faturar mais de R$20 mil / mês (pedidos aprovados usando nossa integração), podemos incluir sua loja em uma aplicação especial.

Ao [autorizar sua conta](https://pbintegracoes.com/connect/autorizar/?utm_source=readme&utm_content=autorizar-sua-conta), escolha a opção "Suas condições e taxas".

Sua Connect key será gerada respeitando as taxas e condições negociadas que você tem com o PagSeguro/PagBank.

= Estou tendo muitas transações negadas. O que fazer? =

Consulte [este artigo](https://ajuda.pbintegracoes.com/hc/pt-br/articles/360027712431) e entre em contato conosco se o problema persistir.

= Tenho outra pergunta não listada aqui =

Consulte nossa [Central de ajuda](https://ajuda.pbintegracoes.com/hc/pt-br/) e [entre em contato](https://ajuda.pbintegracoes.com/hc/pt-br/requests/new) conosco se não encontrar sua dúvida respondida por lá.

A maioria das dúvidas estão respondidas lá. As outras são respondidas em até 2 dias após entrar em contato.

= O plugin atualiza os status automaticamente? =

Sim. 

E quando há uma transação no PagBank, um link para ela é exibida na página do pedido. Assim você pode confirmar o status do mesmo direto no site oficial.

Se estiver tendo problemas com atualizações dos pedidos, consulte [este artigo](https://ajuda.pbintegracoes.com/hc/pt-br/articles/209089326-PagBank-n%C3%A3o-atualiza-status-dos-pedidos). Ele contém várias soluções para identificar e corrigir qualquer problema desta natureza.

= Posso testar usando a Sandbox? =

Sim. Basta clicar no botão 'Obter Connect Key para Testes' localizado nas configurações do plugin, seguir as instruções, e informar sua Connect Key de testes no campo indicado.

Um link para mais detalhes sobre como utilizar a Sandbox está disponível na página de configurações do plugin.

Você também pode testar com dados reais e realizar o estorno. As tarifas e taxas são reembolsadas, não incidindo nenhum custo.

= Este é um plugin oficial? =

Não. Este é um plugin desenvolvido por Ricardo Martins (e colaboradores), parceiro PagBank desde 2014.

Apesar da parceria entre o desenvolvedor e o PagBank que concede descontos e benefícios, este NÃO é um produto oficial.

PagSeguro e PagBank são marcas do UOL.

= Qual diferença deste plugin pro oficial? =

Nosso plugin está em constante evolução, possui recursos exclusivos e é desenvolvido por um parceiro oficial PagBank desde 2014.

Além disso você conta com um suporte profissional e eficiente.

Por estas e outras razões, muitos lojistas e agências profissionais preferem nossa integração.

= O plugin é compatível com o WooCommerce Subscriptions? =

Você não precisa do plugin WooCommerce Subscriptions ou nenhum outro para aceitar [pagamentos recorrentes com nossa integração](https://ajuda.pbintegracoes.com/hc/pt-br/sections/20410120690829-Recorr%C3%AAncia-e-Clube-de-Assinatura-com-WooCommerce).


= Posso modificar e comercializar este plugin? =

O plugin é licenciado sob GPL v3. Você pode modificar e distribuir, contanto que suas melhorias e correções sejam contribuidas de volta com o projeto.

Você deve fazer isso através de Pull Requests ao [repositório oficial no github](https://github.com/r-martins/PagBank-WooCommerce).

= O plugin funciona com lojas físicas (POS)? =
Não, este plugin é exclusivo para vendas online (e-commerce) via WooCommerce.

= Posso aceitar pagamentos internacionais? =
O plugin aceita cartões internacionais, mas os pagamentos são processados em reais (BRL) através da conta PagBank brasileira e exige um CPF/CNPJ para finalização.

Ainda estamos analisando junto ao PagBank uma forma de contornar essa exigência.

= Como funciona o reembolso? =
Você pode fazer [reembolsos parciais ou totais](https://ajuda.pbintegracoes.com/hc/pt-br/articles/30882664582541-Reembolso-total-ou-Parcial) diretamente do painel do WooCommerce. O valor é estornado automaticamente na conta do cliente.

= O plugin funciona offline? =
Não. É necessário conexão com internet para processar pagamentos, pois a comunicação é feita em tempo real com as APIs do PagBank.

= Posso customizar a aparência do checkout? =
Sim! O plugin segue o estilo do seu tema e você pode [usar CSS customizado](https://ajuda.pbintegracoes.com/hc/pt-br/articles/18278019489677-Como-ajustar-ou-modificar-CSS-e-Layouts-do-plugin) para ajustes adicionais.

= Funciona com produtos digitais/virtuais? =
Sim! O plugin funciona perfeitamente com produtos físicos, digitais, agrupados, baixáveis e virtuais.

= Como funciona a confirmação automática de pagamento PIX? =
O plugin verifica automaticamente o status do pagamento PIX e atualiza o pedido em tempo real, sem necessidade de intervenção manual.

A confirmação é exibida ainda na tela de sucesso, e pode opcionalmente disparar eventos adicionais ou redirect.

= Posso oferecer descontos diferentes por método de pagamento? =
Sim! Você pode [configurar descontos percentuais ou fixos](https://ajuda.pbintegracoes.com/hc/pt-br/articles/19945430928909-Oferecer-Desconto-Pix-e-Boleto) para PIX e Boleto diretamente nas configurações do plugin.

== Changelog ==

= 4.47.0 =
* Adicionado suporte a divisão de pagamentos (split) nativa.
* Adicionado [suporte a Dokan Marketplace](https://ajuda.pbintegracoes.com/hc/pt-br/articles/40558023581965-Dokan-Split-Divis%C3%A3o-de-Pagamentos-para-Marketplace) para divisão de pagamentos entre múltiplos vendedores (split, multivendor).
* Adicionado opção para habilitar/desabilitar opção de salvar cartão de crédito para compras futuras. Desativado por padrão.

= 4.46.1 =
* Correção/melhoria: Mais assertibilidade no mapeamento de atributos de endereço, garantindo etiquetas corretas no Envio Facil
* Correção: "Cliente não identificado" aparecia no nome do cliente em toda assinatura na tela de relatorios se HPOS estivesse ativo
* Suporte ao WordPress 6.9 adicionado

= 4.46.0 =
* Melhoria: agora é possível definir uma rota alternativa para as notificações/atualizações do PagBank, caso seu provedor bloqueie asas requisições padrão.
* Correção: em alguns cenários, se o nome do produto contivesse caracteres ilegais como tags html, o pedido não era criado corretamente ocasionando erro no pagamento.

= 4.45.2 =
* Compatibilidade: Alguns métodos depreciados no Woo 10.3 poderiam exibir warnings no log. Corrigido.

= 4.45.1 =
* Correção: compatibilidade com PHP 8.1+ substituindo função depreciada de sanitização de caracteres especiais.
* Correção: em alguns cenários as mensagens de erro de validação da connect key não são exibidas prop
riamente no admin, nas configs do plugin.
* Correção: adicionada dependência jquery-blockui para corrigir erro de validação 3DS que impedia finalização de pedido de forma silenciosa em alguns cenários de customização/temas que removiam tal componente.


= Versões mais antigas =

Para versões mais antigas veja o [arquivo changelog.txt file](https://plugins.svn.wordpress.org/pagbank-connect/trunk/changelog.txt) entregue junto com o plugin.

Ou Veja [changelog completo](https://github.com/r-martins/PagBank-WooCommerce/tags).

Se precisar, faça um [rollback para uma versão anterior](https://ajuda.pbintegracoes.com/hc/pt-br/articles/26766244416269-Como-voltar-para-uma-vers%C3%A3o-anterior) e nos avise para corrigirmos.

== Upgrade Notice ==
Ao atualizar nosso plugin, você se protege contra falhas de funcionamento e segurança e aumenta suas chances de conversão no momento mais importante do ciclo de vendas.

Ao atualizar versões majoritárias (ex: 3.5 para 4.0), certifique-se de testar rigorosamente sua integração, pois mudanças deste tipo tendem a trazer incompatibilidades entre versões.

== Palavras-chave relacionadas ==
plugin pagbank woocommerce, gateway pagamento brasil, pagseguro woocommerce, pix woocommerce, boleto woocommerce, cartão crédito woocommerce, plugin pagamento gratuito, integração pagbank, checkout pagbank, recorrência woocommerce, assinatura woocommerce, envio fácil woocommerce

== Screenshots ==
1. Cartão de Crédito na visão do cliente
2. PIX - Tela de Sucesso com confirmação instantânea
3. Configurações de cartão de crédito
4. PIX e Boleto - Configurações
5. Admin - Tela do Pedido
6. Envio Fácil
7. Autenticação 3D Secure
8. Pedidos Recorrentes (assinaturas) com relatórios
9. Parcelamento na Página de Produto
10. Suporte a Checkout em Blocos do WooCommerce
11. Conteúdo para assinantes
