Title: Cielo WooCommerce – Solução Webservice Author: Gabriel Reguly Published: Korse 7, 2013 Last modified: Juko 10, 2020 --- Search plugins ![](https://ps.w.org/cielo-woocommerce/assets/banner-772x250.png?rev=1356962) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/cielo-woocommerce/assets/icon-256x256.png?rev=1356962) # Cielo WooCommerce – Solução Webservice By [Gabriel Reguly](https://profiles.wordpress.org/gabriel-reguly/) [Download](https://downloads.wordpress.org/plugin/cielo-woocommerce.4.0.14.zip) * [Details](https://fuc.wordpress.org/plugins/cielo-woocommerce/#description) * [Reviews](https://fuc.wordpress.org/plugins/cielo-woocommerce/#reviews) * [Installation](https://fuc.wordpress.org/plugins/cielo-woocommerce/#installation) * [Development](https://fuc.wordpress.org/plugins/cielo-woocommerce/#developers) [Support](https://wordpress.org/support/plugin/cielo-woocommerce/) ## Description Utilize a Solução Webservice da Cielo em sua loja WooCommerce e permita os seus clientes pagarem com cartão de crédito ou débido. A [Cielo](http://www.cielo.com.br/) é 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: * Solução Webservice. * BuyPage Cielo (antigo e será desativado pela Cielo em breve). Nota: O Checkout Cielo esta disponível no plugin [WooCommerce Checkout Cielo](https://wordpress.org/plugins/woocommerce-checkout-cielo/). #### Desenvolvimento 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 [Manual do Desenvolvedor da Cielo](https://www.cielo.com.br/ecommerce). #### Compatibilidade Compatível desde a versão 2.3.x até 2.6.x do [WooCommerce](https://wordpress.org/plugins/woocommerce/). #### Instalação Confira o nosso guia de instalação e configuração da Cielo na aba [Installation](https://wordpress.org/plugins/cielo-woocommerce/installation/). #### Dúvidas? Você pode esclarecer suas dúvidas usando: * A nossa sessão de [FAQ](https://wordpress.org/plugins/cielo-woocommerce/faq/). * O fórum de suporte do [WordPress](https://wordpress.org/support/plugin/cielo-woocommerce)( apenas em inglês). * O fórum de suporte do [WordPress Brasil](https://br.forums.wordpress.org/forum/plugins-e-codigos) utilizando as tags “cielo” e “woocommerce”. * O nosso fórum de suporte no [GitHub](https://github.com/greguly/cielo-woocommerce/issues). #### Colaborar Você pode contribuir com código-fonte em nossa página no [GitHub](https://github.com/greguly/cielo-woocommerce). #### Agradecimentos * [Anilton Veiga](https://www.behance.net/aniltonveiga) – Criação do design/ícones do formulário de pagamento. ## Screenshots * [[ * Configurações para cartão de crédito. * [[ * Configurações para cartão de débito. * [[ * Página de finalização utilizando o tema Storefront, mostrando as opções de crédito e débito na Solução Webservice. ## 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. * Para mais detalhes sobre a instalação de plugins no WordPress leia o tutorial [WordPress – Gerenciando Plugins](https://codex.wordpress.org/pt-br:Gerenciando_Plugins#Instalando_Plugins). #### Requerimentos: * 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](http://www.cielo.com.br/documents/b771c7655be54bc983aba229162f0faa.pdf)” da Cielo. * Ter cadastro no [Cielo e-Commerce](http://www.cielo.com.br/portal/cielo/solucoes-de-tecnologia/e-commerce.html), faça o seu cadastro utilizando: - [Cadastro de clientes do Banco do Brasil, Bradesco ou HSBC](http://www.cielo.com.br/sitecielo/afiliacao/credenciamentoafiliacaonaologado.html) - [Cadastro de clientes dos demais bancos](http://www.cielo.com.br/sitecielo/e-commerce/credenciamento-ecommerce.html) #### Configurações do plugin: É 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. #### Notas sobre o ambiente de testes No ambiente de **Testes** é possível utilizar alguns cartões de teste disponíveis no [Manual do Desenvolvedor Cielo](https://www.cielo.com.br/ecommerce), 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). ## FAQ ### Qual é a licença do plugin? Este plugin esta licenciado como GPL. ### O que eu preciso para utilizar este plugin? * WooCommerce versão 2.1.x ou superior instalado e ativado. * Seguir o nosso [guia de instalação](https://wordpress.org/plugins/cielo-woocommerce/installation/). ### São aceitas quais moedas? No momento apenas Real (BRL). ### Quais são as bandeiras disponíveis? * Visa (crédito e débido) * MasterCard (crédito e débido) * Diners Club * Discover * Elo * American Express * JCB * Aura ### Quais são os modelos de checkout disponíveis? * Solução Webservice. * BuyPage Cielo (antigo e será desativado pela Cielo em breve). ### Como funciona a Solução Webservice? 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. ### Como funciona a BuyPage Cielo? 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. ### É possível usar o pagamento por celular? No momento ainda não é possível, entretanto pretendemos integrar no futuro. ### É possível fazer pagamentos recorrentes/assinaturas? Não é possível no momento, mas será entregado no futuro. ### 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”. ### É possível cancelar o pagamento/devolver o dinheiro do cliente pelo plugin? Sim é possível fazer reembolsos do valor total ou parcial, entretanto apenas para transações feitas em menos de 120 dias, além de que é necessário utilizar WooCommerce 2.2 ou superior. Os reembolsos devem ser feito dentro da página do pedido na tela de administração do WordPress em “WooCommerce > Pedidos”, sendo possível encontrar a opção para isso clicando no botão “Reembolso” na tabela de itens do pedido. **Nota:** Para pagamentos com débito e para cartão de crédito da bandeira Discover é possível apenas realizar o reembolso do valor total do pedido. ### Aconteceu um erro, o que eu faço? 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](http://pastebin.com) ou o [gist.github.com](http://gist.github.com) solicitar ajuda usando: * O fórum de suporte do [WordPress](https://wordpress.org/support/plugin/cielo-woocommerce)( apenas em inglês). * O fórum de suporte do [WordPress Brasil](https://br.forums.wordpress.org/forum/plugins-e-codigos) utilizando as tags “cielo” e “woocommerce”. * O nosso fórum de suporte no [GitHub](https://github.com/greguly/cielo-woocommerce/issues). ### 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. ## Reviews ![](https://secure.gravatar.com/avatar/5bf0049c9a86641647f4347a16710b66ef826dcbf03e96f3eec791e649543904? s=60&d=retro&r=g) ### 󠀁[Não funciona mais](https://wordpress.org/support/topic/nao-funciona-mais-3/)󠁿 [eversoncoutinho](https://profiles.wordpress.org/eversoncoutinho/) Jolal 9, 2021 Infelizmente o plugin não funciona na versão nova do WP ![](https://secure.gravatar.com/avatar/728283f04c239a41ee35ff8f1753375940204d8e398cef6aae790d6d45a210d3? s=60&d=retro&r=g) ### 󠀁[NÂO FUNCIONA NA VERSAO RECENTE WORDPRESS](https://wordpress.org/support/topic/nao-funciona-na-versao-recente-wordpress/)󠁿 [tianoduarte0909](https://profiles.wordpress.org/tianoduarte0909/) Korse 23, 2021 Esse plugin nao funciona com a versão recente do wordpress, nem aparece no site quando se muda para produção, apenas em modo de teste. E mesmo em modo de teste não esta funcionando. Aparece uma mensagem com os dizeres: Cartão de débito: Um erro aconteceu ao processar o seu pagamento, por favor, tente novamente ou entre em contato para conseguir assistência. ![](https://secure.gravatar.com/avatar/574ea1ac0696ad82f786c9ba031890f29cc5af57e163bc1f5f6a234788d85ca2? s=60&d=retro&r=g) ### 󠀁[Muito bom.](https://wordpress.org/support/topic/muito-bom-1356/)󠁿 [grupoverao](https://profiles.wordpress.org/grupoverao/) Siilo 11, 2021 Simples e Bom! ![](https://secure.gravatar.com/avatar/dd68d0f9c9bf20260a3ac22ec96551dc935bd714ade15f9db19d1e6ba43eb40a? s=60&d=retro&r=g) ### 󠀁[Excelente / Superb](https://wordpress.org/support/topic/excelente-superb/)󠁿 [mpassos](https://profiles.wordpress.org/mpassos/) Jolal 12, 2020 Plugin excelente, muito obrigado e boa sorte! ![](https://secure.gravatar.com/avatar/bd5cb5f83d5782d637b78e341e2ff11552bc7ad2235f516b613a01aec3d61da4? s=60&d=retro&r=g) ### 󠀁[Bom](https://wordpress.org/support/topic/bom-114/)󠁿 [Heliton Afonso Gonçalves](https://profiles.wordpress.org/helitonafonso/) Korse 23, 2020 Interface super simples e amigável. Show de bola. Se tiver com a opção “Teste” marcado( tanto para cartão de crédito quanto cartão de débito) na loja aparece como opção de pagamento. Mas se tiver em produção e eu informar o Merchant Id e Merchant Key, na tela de pagamento não aparece estes como forma de pagamento. Estou utilizando: PHP 7.4, o WordPress 5.4.2 e Woocommerce 4.2.1. Espero voltar aqui após a atualização desse plugin para aumentar a nota. ![](https://secure.gravatar.com/avatar/46ee6b2734123e17810081e1486c6b648275c625690b01cd341525e5695b7a4c? s=60&d=retro&r=g) ### 󠀁[Muito bom](https://wordpress.org/support/topic/muito-bom-1061/)󠁿 [DaviHamilton](https://profiles.wordpress.org/davihamilton/) Colte 17, 2020 Obrigado de verdade a todos os desenvolvedores, ajudou muito a nós… [ Read all 72 reviews ](https://wordpress.org/support/plugin/cielo-woocommerce/reviews/) ## Contributors & Developers “Cielo WooCommerce – Solução Webservice” is open source software. The following people have contributed to this plugin. Contributors * [ Gabriel Reguly ](https://profiles.wordpress.org/gabriel-reguly/) * [ Claudio Sanches ](https://profiles.wordpress.org/claudiosanches/) * [ Paulo Vieira ](https://profiles.wordpress.org/gopaulo/) “Cielo WooCommerce – Solução Webservice” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/cielo-woocommerce/contributors) for their contributions. [Translate “Cielo WooCommerce – Solução Webservice” into your language.](https://translate.wordpress.org/projects/wp-plugins/cielo-woocommerce) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/cielo-woocommerce/), check out the [SVN repository](https://plugins.svn.wordpress.org/cielo-woocommerce/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/cielo-woocommerce/) by [RSS](https://plugins.trac.wordpress.org/log/cielo-woocommerce/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 4.0.14 – 2017/01/05 * Força sempre limpar os dados do cartão quando algo acontece qualquer erro na finalização do pedido. #### 4.0.13 – 2016/12/24 * Melhorada a exibição das opções de juros para cartão de crédito. #### 4.0.12 – 2016/11/07 * Corridigo erro quando taxa de juros é igual ou menor do que zero. #### 4.0.11 – 2016/06/30 * Suporte para WooCommerce 2.6. * Melhorada a URL de retorno que em alguns servidores não funcionava. * Corrigido método de débito sendo recusado mesmo quando o pagamento esta em andamento. #### 4.0.10 – 2015/08/09 * Corrigido limite de caracteres para o campo de cartão (não estava funcionando para cartão Aura). * Suporte confirmado para WooCommerce 2.4. #### 4.0.9 – 2015/05/14 * Correção do método de reembolsos. * Removido código antigo que fazia reembolsos quando alterado o pédido para cancelado( veja a documentação do plugin para mais detalhes). * Correção das opções de autenticação. * Correção da autenticação para cartão de débito. #### 4.0.8 – 2015/05/08 * Corrigido os dados enviados para a Solução Webservice de débito e crédito. #### 4.0.7 – 2015/05/08 * Alterado os atributos “name” dos campos de débito e crédito para a Solução Webservice. * Corrigido erros na identificação da bandeira de cartões com a Solução Webservice. #### 4.0.6 – 2015/05/03 * Correção da validação de bandeira dos cartões de débito para a Solução Webservice. #### 4.0.5 – 2015/05/01 * Correção da tradução. #### 4.0.4 – 2015/04/30 * Corrigida validação de parcelas. * Adicionado método em PHP para detectar a bandeira do cartão de crédito e removido o método antigo em JavaScript. #### 4.0.3 – 2015/04/26 * Corrigida verificação de SSL no checkout, este erro estava impedindo de exibir as opções em produção para a Solução Webservice. * Alterado o limite para cancelamento/reembolso de 90 dias para 120 dias, como manda a nova documentação da Cielo. #### 4.0.2 – 2015/04/13 * Corrigida a finalização com cartão de crédito quando as parcelas é configurada como 1. #### 4.0.1 – 2015/04/11 * Corrigida a validação das parcelas quando configurado o número de parcelas como 1. #### 4.0.0 – 2015/04/10 * Implementada a Solução Webservice (funciona apenas para WooCommerce 2.3 ou superior). * 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. * Corrigido do parcelamento, agora funciona corretamente com o juros por mês. * Alterado nome do plugin para “Cielo WooCommerce – Solução Webservice”. ## Meta * Version **4.0.14** * Last updated **6 years ago** * Active installations **300+** * WordPress version ** 3.9 or higher ** * Tested up to **5.5.18** * Languages * [English (US)](https://wordpress.org/plugins/cielo-woocommerce/) and [Portuguese (Brazil)](https://br.wordpress.org/plugins/cielo-woocommerce/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/cielo-woocommerce) * Tags * [cielo](https://fuc.wordpress.org/plugins/tags/cielo/)[payment gateway](https://fuc.wordpress.org/plugins/tags/payment-gateway/) [woocommerce](https://fuc.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://fuc.wordpress.org/plugins/cielo-woocommerce/advanced/) ## Ratings 4.8 out of 5 stars. * [ 66 5-star reviews ](https://wordpress.org/support/plugin/cielo-woocommerce/reviews/?filter=5) * [ 2 4-star reviews ](https://wordpress.org/support/plugin/cielo-woocommerce/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/cielo-woocommerce/reviews/?filter=3) * [ 1 2-star review ](https://wordpress.org/support/plugin/cielo-woocommerce/reviews/?filter=2) * [ 3 1-star reviews ](https://wordpress.org/support/plugin/cielo-woocommerce/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/cielo-woocommerce/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/cielo-woocommerce/reviews/) ## Contributors * [ Gabriel Reguly ](https://profiles.wordpress.org/gabriel-reguly/) * [ Claudio Sanches ](https://profiles.wordpress.org/claudiosanches/) * [ Paulo Vieira ](https://profiles.wordpress.org/gopaulo/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/cielo-woocommerce/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://claudiosmweb.com/doacoes/)