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

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:

• 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:
  • Cadastro de clientes do Banco do Brasil, Bradesco ou HSBC
  • Cadastro de clientes dos demais bancos

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?

• WooCommerce vers?o 2.1.x ou superior instalado e ativado.
• Seguir o nosso guia de instala??o.

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

N?o funciona mais

eversoncoutinho November 9, 2021

Infelizmente o plugin n?o funciona na vers?o nova do WP

N?O FUNCIONA NA VERSAO RECENTE WORDPRESS

tianoduarte0909 June 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.

Muito bom.

grupoverao January 11, 2021

Simples e Bom!

Excelente / Superb

mpassos November 12, 2020

Plugin excelente, muito obrigado e boa sorte!

Bom

Heliton Afonso Gon?alves June 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.

Muito bom

DaviHamilton February 17, 2020

Obrigado de verdade a todos os desenvolvedores, ajudou muito a nós…

Contributors & Developers

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