Contributors: Gabriel Reguly, claudiosanches
Donate link: http://claudiosmweb.com/doacoes/
Tags: WooCommerce, Payment Gateway, Cielo
Requires at least: 3.5
Tested up to: 4.0
Stable tag: 3.1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Adds Brazilian payment gateway Cielo to WooCommerce
The Cielo WooCommerce plugin enables integration with WooCommerce and the Cielo Payment Gateway (for Brazilian Merchants).
Please notice that WooCommerce must be installed and active.
You can contribute to the source code in our GitHub page.
Utilize a Cielo em sua loja WooCommerce e permita os seus clientes pagarem com cartão de crédito ou débido.
A Cielo é uma empresa líder em soluções de pagamentos eletrônicos na América Latina. Responsável pelo credenciamento de estabelecimentos comerciais, e pela captura, transmissão, processamento e liquidação financeira das transações realizadas com cartões de crédito e débito, capturando transações das maiores bandeiras de cartões do mundo.
Estão disponíveis as seguintes bandeiras:
- Visa (crédito e débido)
- MasterCard (crédito e débido)
- Diners Club
- Discover
- Elo
- American Express
- JCB
- Aura
Com este plugin é possível escolher entre os modelos de BuyPage:
- Cielo
- Loja (ainda não implementado, será possível em breve)
O plugin Cielo WooCommerce foi desenvolvido sem nenhum incentivo da Cielo. Isto quer dizer que nenhum dos desenvolvedores deste plugin possuem vínculos com a Cielo e contamos com a sua ajuda para melhorar o código e o funcionamento deste plugin.
Toda a integração foi desenvolvida a partir da última versão do kit de integração da Cielo.
Compatível com as versões 2.0.x e 2.1.x do WooCommerce.
Confira o nosso guia de instalação e configuração da Cielo na aba Installation.
Você pode esclarecer suas dúvidas usando:
- A nossa sessão de FAQ.
- O fórum de suporte do WordPress (apenas em inglês).
- O fórum de suporte do WordPress Brasil utilizando as tags "cielo" e "woocommerce".
- O nosso fórum de suporte no GitHub.
Você pode contribuir com código-fonte em nossa página no GitHub.
- Anilton Veiga - Criação do design/ícones do formulário de pagamento.
- Upload plugin files to your plugins folder, or install using WordPress built-in Add New Plugin installer;
- Activate the plugin;
- Navigate to WooCommerce -> Settings -> Payment Gateways, choose Cielo and fill the plugin options.
- Envie os arquivos do plugin para a pasta wp-content/plugins, ou instale usando o instalador de plugins do WordPress.
- Ative o plugin.
- Para mais detalhes sobre a instalação de plugins no WordPress leia o tutorial WordPress - Gerenciando Plugins.
- Ter um site pronto com o WordPress e WooCommerce instalados.
- Utilizar um certificado SSL (é recomendado um de 2048 bits).
- Ler o material "Boas Práticas de Segurança no e-Commerce" da Cielo.
- Ter cadastro no Cielo e-Commerce, faça o seu cadastro utilizando:
É possível acessar a tela de configurações do plugin na página de administração do WordPress em WooCommerce -> Configurações -> Finalizar Compra -> Cielo.
O plugin funciona com os ambientes de Teste e Produção, onde você deve utilizar o ambiente de Teste para testar a integração antes de fazer a homologação. Uma vez que estiver homologado, você poderá ter utilizar o ambiente de Produção onde é possível entrar com o número e a chave de afiliação do estabelecimento com a Cielo.
No ambiente de Testes é possível utilizar alguns cartões de teste disponíveis no kit de integração da Cielo, basta fazer o download do kit e ler o arquivo "Cielo e-Commerce - Manual do Desenvolvedor X.X.X.X.pdf" que esta dentro da pasta "Materiais Técnicos".
Outra coisa importante é saber que o ambiente de Testes tem alguns comportamentos peculiares que você deve conhecer para poder utilizá-lo com eficiência:
- Para simular pagamentos aprovados o valor total do pedido não pode ter nenhum centavo, exemplo:
R$ 100,00. - É possível simular pagamentos recusados fazendo pedidos com o valor total contendo centavos, exemplo:
R$ 100,99. - Os cartões do kit de integração que estão marcados com a opção "Autenticação" poderão redirecionar para uma página em branco com um XML e um botão, logo após inserir os dados dentro da página da Cielo, isto é normal e serve para "simular" a autenticação dentro do banco do cliente, basta clicar no botão e você será redirecionado novamente para a sua loja (não se preocupe, o cliente não irá ver esta tela no ambiente de produção e sim o site de seu banco).
- Ao tentar simular uma compra, observe que o juros as vezes pode adicionar centavos no total e isso vai simular uma transação recusada (parece besta, mas muita gente quer simular pagamentos aprovados e acaba forçando todos para serem recusados por causa disso).
- This plugin is released under a GPL license.
- WooCommerce version 2.0.x or latter installed and active.
- Follow our installation guide.
Este plugin esta licenciado como GPL.
- WooCommerce versão 2.0.x ou superior instalado e ativado.
- Seguir o nosso guia de instalação.
No momento apenas Real (BRL).
- Visa (crédito e débido)
- MasterCard (crédito e débido)
- Diners Club
- Discover
- Elo
- American Express
- JCB
- Aura
- Cielo
- Loja (ainda não implementado, será possível em breve)
Na BuyPage Cielo a digitação dos dados do cartão será no ambiente da Cielo. Geralmente é aconselhada a clientes que não queiram lidar com questões de segurança e desejam utilizar a infraestrutura da Cielo.
Na BuyPage Loja a digitação dos dados do cartão será no ambiente da Loja. Ou seja, a própria Loja se encarrega do desenvolvimento de uma página segura na Internet (HTTPS), respeitando políticas de segurança, para capturar os dados do cartão do portador.
Este modelo de BuyPage não esta disponível ainda no plugin, iremos implementar em breve e contamos com a sua ajuda, tanto para a melhoria do código e implementação desta feature como também para doações (desta forma você ajuda os desenvolvedores deste plugin a ter mais tempo livre para implementar esta funcionalidade).
No momento ainda não é possível, entretanto pretendemos integrar no futuro.
Não é possível no momento, mas será entregado no futuro.
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".
Sim é possível fazer reembolsos do valor total ou parcial, entretanto apenas para transações feitas em menos de 90 dias,
Reembolso total
Basta mudar o status do pedido para "reembolsado", desta forma é enviado um sinal para a Cielo dizendo que a transação deve ser cancelada e o valor reembolsado.
- Nota: Isto irá funcionar apenas para pagamentos feitos depois de instalada a versão 3.0.0 deste plugin.
Reembolso parcial
A partir do WooCommerce 2.2 foi implementada uma API e uma interface para fazer reembolsos parciais e este plugin a partir da versão 3.1.0 esta totalmente integrado com esta nova API.
Desta forma basta fazer o reembolso na tela do pedido, assim será enviado um sinal para a Cielo dizendo qual o valor deve ser reembolsado.
- Nota: Para reembolsos parciais você deve utilizar o WooCommerce 2.2 ou superior, além de que os pedidos devem ter sido feitos nesta versão e também com o Cielo WooCommerce na versão 3.1.0 ou superior.
Sempre que ocorrer um erro você deve ativar a opção de log do plugin e tentar simular o erro novamente, desta forma o erro será gravado no arquivo de log e você poderá saber o que aconteceu.
Não é um problema caso você não consiga entender o arquivo de log, pois você pode salvar o conteúdo dele utilizando o pastebin.com ou o gist.github.com solicitar ajuda usando:
- O fórum de suporte do WordPress (apenas em inglês).
- O fórum de suporte do WordPress Brasil utilizando as tags "cielo" e "woocommerce".
- O nosso fórum de suporte no GitHub.
O que fazer quando tentar finalizar a compra aparece a mensagem "Cielo: Um erro aconteceu ao processar o seu pagamento, por favor, tente novamente ou entre em contato para conseguir assistência" ?
Esta mensagem geralmente irá aparecer quando o seu servidor tiver problemas para fazer a conexão com a Cielo. Mas é possível saber com certeza o que aconteceu de errado utilizando a opção de log do plugin como descrito na sessão acima.
É possível alterar formulário e adicionar um customizado utilizando o filtro wc_cielo_form_path.
Exemplo de uso do filtro em um tema:
function custom_wc_cielo_form_path( $path ) {
return get_template_directory() . '/cielo-html-form.php';
}
add_filter( 'wc_cielo_form_path', 'custom_wc_cielo_form_path' );
Depois basta criar o arquivo cielo-html-form.php dentro do seu tema e escrever o HTML dele como você julgar melhor (utilize os modelos prontos no plugin dentro de includes/views para ter uma ideia de como deve ser os elementos e as variáveis que você pode utilizar).
Ao criar um formulário customizado pode ser boa ideia remover os scripts adicionados pelo plugin e você pode fazer da seguinte forma:
function remove_wc_cielo_scripts() {
wp_dequeue_style( 'wc-cielo-checkout-icons' );
wp_dequeue_script( 'wc-cielo-checkout-icons' );
}
add_action( 'wp_enqueue_scripts', 'remove_wc_cielo_scripts', 1000 );
- Adicionado suporte para reembolsos parciais do WooCommerce 2.2.
- Melhorada a compatibilidade com o WordPress 4.0.
- Adicionada opção para selecionar os métodos de débito disponíveis.
- Melhorada a exibição das notas do pedido com as informações sobre o pagamento.
- Corrigido o script que atualiza as opções do plugin ao utilizar uma versão mais nova.
- Permitido valores inferiores a R$ 5,00 para pagamento à vista em cartão de crédito.
- Quando cancelado o pagamento na tela da Cielo o cliente é redirecionado para o caralogo do WooCommerce.
- Refatorado todo o código do plugin.
- Adicionado completo suporte para as versões 2.0.x e 2.1.x do WooCommerce
- Atualizada a versão da API da Cielo para 1.3.0.
- Adicionada ação de cancelar a transação (devolver o dinheiro) ao marcar o pedido como "reembolsado".
- Adicionada novas formas de exibir o formulário com os cartões de crédito e parcelas disponíveis.
- Removida a opção de captura (não tinha utilidade e a melhor forma de trabalhar é capturar automaticamente sempre).
- Adicionado suporte para os cartões JBC e Aura.
- Adicionado opção de pagamento por débito para o MasterCard.
- Adicionada uma mensagem informando o cartão, forma de pagamento (crédito ou débito) e quantidade de parcelas nas notas do pedido ao concluir o pagamento.
- Adicionado filtro
wc_cielo_form_path, que torna possível customizar o formulário de seleção do cartão e de parcelas.
- Corrigido a finalização e a URL de retorno para versões 2.0.x do WooCommerce.
- Correção dos valores padrões das opções.
- Correção do retorno do pagamento para as versões 2.1.x do WooCommerce.
- Suporte inicial para as versões 2.1.x do WooCommerce.
- Adicionadas mensagens de erro para quando as bandeiras de cartão não foram selecionadas.
- Removido o template customizado review-order.php
- Adicionada opção de reduzir o estoque quando o pagamento é completado com sucesso.
- Corrigida falha com a página de retorno da Cielo.
- Fixed a bug with as_is()/PHP < 5.3 where it hang at payment page.
- Added a direct settings link on plugins page list.
- Fixed a bug, thanks for Claudio Sanches who reported it.
- Updated to WooCommerce 2.0
- Initial plugin release.
- Adicionado suporte para reembolsos parciais do WooCommerce 2.2.
- Melhorada a compatibilidade com o WordPress 4.0.
Cielo WooCommerce is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Cielo WooCommerce is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Cielo WooCommerce. If not, see http://www.gnu.org/licenses/.