Contributors: Gabriel Reguly, claudiosanches, gopaulo
Donate link: http://claudiosmweb.com/doacoes/
Tags: woocommerce, payment gateway, cielo
Requires at least: 3.9
Tested up to: 4.1.1
Stable tag: 4.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Adds Brazilian payment gateway Cielo to WooCommerce
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 trabalhar com:
- BuyPage Cielo (antigo e será desativo pela Cielo em breve).
- Solução Webservice.
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 desde a versão 2.1.x até 2.3.x do WooCommerce.
Entretanto a Solução Webservice funciona apenas com WooCommerce 2.3.x ou superior.
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.
- 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 "Manual_Desenvolvedor_WebService_XXX_vX.pdf".
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).
Este plugin esta licenciado como GPL.
- WooCommerce versão 2.1.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
- BuyPage Cielo (antigo e será desativo pela Cielo em breve).
- Solução Webservice.
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.
Entretanto a Cielo esta desativando esta opção em favor do Checkout Cielo, então em breve o BuyPage Cielo não irá mais funcionar.
Com a Solução Webservice 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.
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.
- Implementada a Solução Webservice.
- Adicionado esquema de templates para tornar possível a manipulação dos formulários de checkout.
- Depreciado o filtro
wc_cielo_form_path. - Refatorado todo o código do plugin dividindo em dois gateways, uma para crédito e outro para débito.
- Correção do SSL da Cielo.
- Melhorada a integração com o
_transaction_idpara o WooCommerce 2.2.
- 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.
- Implementada a Solução Webservice.
- Adicionado esquema de templates para tornar possível a manipulação dos formulários de checkout.
- Depreciado o filtro
wc_cielo_form_path. - Refatorado todo o código do plugin dividindo em dois gateways, uma para crédito e outro para débito.
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/.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent