Skip to content
This repository has been archived by the owner on Oct 29, 2023. It is now read-only.

claudiosanches/woocommerce-pagarme

Repository files navigation

Pagar.me for WooCommerce

Contributors: pagarme, claudiosanches, murilohns
Tags: woocommerce, pagarme, payment
Requires at least: 4.0
Tested up to: 5.6
Stable tag: 2.5.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Receba pagamentos por cartão de crédito e boleto bancário utilizando o Pagar.me

Description

O Pagar.me é a melhor forma de receber pagamentos online por cartão de crédito e boleto bancário, sendo possível o cliente fazer todo o pagamento sem sair da sua loja WooCommerce.

Saiba mais como o Pagar.me funciona:

[vimeo http://vimeo.com/74335951]

Compatibilidade

Compatível com desde a versão 2.2.x do WooCommerce.

Este plugin funciona integrado com o WooCommerce Extra Checkout Fields for Brazil, desta forma é possível enviar documentos do cliente como "CPF" ou "CNPJ", além dos campos "número" e "bairro" do endereço. Caso você queira remover todos os campos adicionais de endereço para vender Digital Goods, é possível utilizar o plugin WooCommerce Digital Goods Checkout.

Instalação

Confira o nosso guia de instalação e configuração do Pagar.me na aba Installation.

Dúvidas?

Você pode esclarecer suas dúvidas usando:

Colaborar

Você pode contribuir com código-fonte em nossa página no GitHub.

Installation

Instalação do plugin:

  • Envie os arquivos do plugin para a pasta wp-content/plugins, ou instale usando o instalador de plugins do WordPress.
  • Ative o plugin.

Requerimentos:

É necessário possuir uma conta no Pagar.me e ter instalado o WooCommerce.

Configurações do Plugin:

Com o plugin instalado acesse o admin do WordPress e entre em "WooCommerce" > "Configurações" > "Finalizar compra" e configure as opção "Pagar.me - Boleto bancário" e "Pagar.me - Cartão de crédito".

Habilite a opção que você deseja, preencha as opções de Chave de API e Chave de Criptografia que você pode encontrar dentro da sua conta no Pagar.me em API Keys.

Também será necessário utilizar o plugin WooCommerce Extra Checkout Fields for Brazil para poder enviar campos de CPF e CNPJ.

Pronto, sua loja já pode receber pagamentos pelo Pagar.me.

Mais informações sobre as configurações do plugin em: https://docs.pagar.me/v2/docs/configurando-o-plugin-pagarme-woocommerce.

Frequently Asked Questions

Qual é a licença do plugin?

Este plugin esta licenciado como GPL.

O que eu preciso para utilizar este plugin?

  • Ter instalado o plugin WooCommerce 2.2 ou superior.
  • Possuir uma conta no Pagar.me.
  • Pegar sua Chave de API e Chave de Criptografia no Pagar.me.
  • Desativar a opção Manter Estoque (minutos) do WooCommerce.

Quanto custa o Pagar.me?

Confira os preços em "Pagar.me - Preços".

Funciona com o Checkout Pagar.me?

Sim, funciona desde a versão 2.0.0 para pagamentos com cartão de crédito.

É possível utilizar a opção de pagamento recorrente?

No momento ainda não é possível, entretanto iremos fazer esta integração em breve.

O pedido foi pago e ficou com o status de "processando" e não como "concluído", isto esta certo ?

Sim, esta certo e significa que o plugin esta trabalhando como deveria.

Todo gateway de pagamentos no WooCommerce deve mudar o status do pedido para "processando" no momento que é confirmado o pagamento e nunca deve ser alterado sozinho para "concluído", pois o pedido deve ir apenas para o status "concluído" após ele ter sido entregue.

Para produtos baixáveis a configuração padrão do WooCommerce é permitir o acesso apenas quando o pedido tem o status "concluído", entretanto nas configurações do WooCommerce na aba Produtos é possível ativar a opção "Conceder acesso para download do produto após o pagamento" e assim liberar o download quando o status do pedido esta como "processando".

É obrigatório enviar todos os campos para processar o pagamento?

Não é obrigatório caso você não utilize antifraude, no caso para digital goods.

É possível remover os campos de endereço, empresa e telefone, mantendo apenas nome, sobrenome e e-mail utilizando o plugin WooCommerce Digital Goods Checkout.

Problemas com a integração?

Primeiro de tudo ative a opção Log de depuração e tente realizar o pagamento novamente. Feito isso copie o conteúdo do log e salve usando o pastebin.com ou o gist.github.com, depois basta abrir um tópico de suporte aqui.

Mais dúvidas relacionadas ao funcionamento do plugin?

Entre em contato clicando aqui.

Screenshots

1. Exemplo de checkout com cartão de crédito e boleto bancário do Pagar.me no tema Storefront.

Exemplo de checkout com cartão de crédito e boleto bancário do Pagar.me no tema Storefront.

2. Exemplo do Checkout Pagar.me para cartão de crédito.

Exemplo do Checkout Pagar.me para cartão de crédito.

3. Configurações para boleto bancário.

Configurações para boleto bancário.

4. Configurações para cartão de crédito.

Configurações para cartão de crédito.

Changelog

2.5.0 - 2020-01-07

  • Exibe mensagem após instalação/ativação do plugin, recomendando a instalação do plugin Brazilian Market on WooCommerce
  • Exibe mensagem após instalação/ativação do plugin, com um link para a documentação da Pagar.me

2.4.1 - 2020-12-17

  • Fix: Reverte a alteração que tornava o plugin Brazilian Market on WooCommerce obrigatório

2.4.0 - 2020-12-16

  • Torna o plugin Brazilian Market on WooCommerce obrigatório

2.3.0 - 2020-11-05

  • Torna o campo bairro obrigatório

2.2.0 - 2020-09-10

  • Adicionado header X-PagarMe-Version, dessa forma não será necessário alterar a versão de API na Dashboard.
  • Adicionado User Agent para coletar informações úteis para melhor suporte.

2.1.0 - 2020-06-24

  • Adicionado estorno para pagamentos via cartão de crédito.

2.0.18 - 2020-05-19

  • Corrige exibição da bandeira do cartão no formulário de checkout

2.0.17 - 2019-10-07

  • Alterado nome do plugin de "Woocommerce Pagar.me" para "Pagar.me for Woocommerce"

2.0.16 - 2019-09-23

  • Corrigido erro "número de parcelas inválido" para compras utlizando o checkout pagar.me, onde o valor da compra era inferior ao valor da menor parcela.

2.0.15 - 2019-07-01

  • Adicionado o novo status analyzing do Pagar.me

2.0.14 - 2018/05/02

  • Corrigido problema de resetar para 1 parcela ao recarregar o formulário de dados de cartão.

2.0.13 - 2018/05/29

  • Permitido resgistro de pedido para transação recusada no checkout Pagar.me.
  • Corrige o timeout na captura no checkout Pagar.me.

2.0.12 - 2018/07/31

  • Adicionado cidade e estado nos dados enviados para o Checkout Pagar.me.
  • Adicionado suporte para "pending_review", melhorando a integração com boleto bancário.

2.0.11 - 2017/09/08

  • Adicionada opção para suportar boletos assíncronos.

2.0.10 - 2016/09/29

  • Adicionado order_number (número do pedido) como meta dado para transações com o Checkout Pagar.me.

2.0.9 - 2016/09/27

  • Corrigido vendas canceladas com o Checkout Pagar.me feitas quando a parcela mínima era menor do que o mínimo permitido.

2.0.8 - 2016/09/15

  • Adicionado order_number (número do pedido) como meta dado das transações.

2.0.7 - 2016/09/12

  • Corrigido o valor da primeira parcela quando é menor do que o mínimo permitido.
  • Adicionado código para corrigir o valor da taxa de juros antes de usar no Checkout Pagar.me.

2.0.6 - 2016/09/09

  • Corrigida a compatibilidade com o WordPress 4.6.
  • Corrigido o calculo das parcelas do cartão de crédito.

2.0.5 - 2016/07/15

  • Correções para previnir mensagens de erro ao receber notificações de pagamentos.

2.0.4 - 2016/06/08

  • Melhorado o fluxo das transações feitas com o Checkout Pagar.me.

2.0.3 - 2016/06/02

  • Corrigido erro ao fazer uma transação com o Checkout Pagar.me onde é adicionada taxa de juros.
  • Adicionado campo informando o total pago pelo cliente incluindo juros quando aplicável.

2.0.2 - 2016/05/11

  • Corrigida a validação de campos da finalização para o Checkout Pagar.me.
  • Melhorada das mensagens de erro para quando não abrir o Checkout Pagar.me.

2.0.1 - 2016/04/04

  • Permitida a validação dos campos da finalização antes de abrir o Checkout Pagar.me.
  • Corrigida a mudança de status do Checkout Pagar.me.

2.0.0 - 2016/04/02

  • Adicionado novo método para pagamento com cartões de crédito.
  • Adicionado novo método para pagamentos com boleto bancário.
  • Adicionado suporte ao Checkout Pagar.me para pagamentos com cartão de crédito.
  • Corrigida a exibição do boleto na página "Minha conta", fazendo os boletos aparecer apenas quando o pedido esta com os status de pendente ou aguardando.

1.2.4 - 2016/02/04

  • Adiciona opção para cobrar juros de todas as parcelas do cartão de crédito.

1.2.3 - 2016/01/27

  • Removida dependência do plugin WooCommerce Extra Checkout Fields From Brazil.
  • Removida dependência dos campos de endereço, telefone e empresa (obrigatório apenas nome, sobrenome e e-mail).
  • Adicionado link para segunda via do boleto na tela de administração de pedidos e na página "Minha Conta".

1.2.2 - 2014/10/27

  • Atualizada URL da biblioteca JavaScript do Pagar.me.

1.2.1 - 2014/10/27

  • Corrigido o método que manipula os retornos do Pagar.me.

1.2.0 - 2014/10/12

  • Adicionada opção para controlar o número de parcelas sem juros.

1.1.0 - 2014/09/07

  • Adicionado suporte para a API de parcelas do Pagar.me.
  • Adicionada opção de taxa de juros para as parcelas.
  • Adicionado suporte para o WooCommerce 2.2.

1.0.0

  • Versão incial do plugin.

Upgrade Notice

2.0.12

  • Adicionado cidade e estado nos dados enviados para o Checkout Pagar.me.
  • Adicionado suporte para "pending_review" melhorando a integração com boleto bancário.