Cielo WooCommerce – Solução Webservice

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 é 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.

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.

Compatibilidade

Compatível desde a versão 2.3.x até 2.6.x do WooCommerce.

Instalação

Confira o nosso guia de instalação e configuração da Cielo na aba Installation.

Dúvidas?

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.

Colaborar

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

Agradecimentos

  • Anilton Veiga – 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.

Requerimentos:

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, 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?
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 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.

Reviews

Ótimo!!

Usei no meu ecommerce, foi muito simples de instalar, e parece bem atualizado. Recomendo

Muito BOm !

Gostaria de saber se existe uma previsão pra atualizar pra api 3.0 da cielo?

O melhor!

O plugin é perfeito e funciona pq é sempre bem mantido! Solução ideal para lojistas brasileiros operando online com WooCommerce!

Credenciais invalidas

Bom dia, estou seguindo os passos de homologação, porem quando modifiquei a o numero de filiação e a chave e coloquei em modo de produção, o teste da cielo recebeu esse erro.

em que eu estaria errando? não era para colocar em modo de produção, criar um produto teste no valor de R$1 e modificar de modo de teste para produção?

ou eles fazem o teste de homologação em modo de teste?

Realizados testes e verificado que é apresentado a mensagem abaixo. Favor certificar-se de utilizar os dados de produção abaixo:

define(“ENDERECO_BASE”, “https://ecommerce.cielo.com.br”);
define(“ENDERECO”, ENDERECO_BASE.”/servicos/ecommwsec.do”);

define(“LOJA”, “xxxxxxxxxxx”);
define(“LOJA_CHAVE”, “xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”);

Plugin Clearsale Para Cielo

Como a muito tempo não existe o By Verificado for Bandeira, no Woocomerce já deveria ter a disposição um plugin da Clearsale para autenticar, verificar e liberar ou não a venda para o lojista não levar prejuízos. Até a bomba do Interspire descontinuado que vendem a 1,99 tem a opção de integrar o Clearsale

Read all 61 reviews

Contributors & Developers

“Cielo WooCommerce – Solução Webservice” is open source software. The following people have contributed to this plugin.

Contributors

“Cielo WooCommerce – Solução Webservice” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Cielo WooCommerce – Solução Webservice” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by 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”.