claudiosanches / woocommerce-checkout-cielo

WooCommerce Checkout Cielo - WordPress Plugin
https://wordpress.org/plugins/woocommerce-checkout-cielo/
20 stars 17 forks source link

=== Claudio Sanches - Checkout Cielo for WooCommerce === Contributors: claudiosanches, Gabriel Reguly Donate link: http://claudiosmweb.com/doacoes/ Tags: woocommerce, cielo, payment Requires at least: 4.0 Tested up to: 5.2 Stable tag: 1.1.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

Adds Checkout Cielo gateway to the WooCommerce plugin

== Description ==

Adicione o Checkout Cielo como método de pagamento em sua loja WooCommerce e permita seus clientes a pagarem usando cartão de crédito, cartão de débito, débito online e boleto bancário.

Checkout Cielo é uma solução de pagamento da Cielo.

Este plugin foi desenvolvido sem nenhum incentivo da Cielo. Nenhum dos desenvolvedores deste plugin possuem vínculos com esta empresas.

Este plugin foi desenvolvido a partir da Manual do desenvolvedor v1.3 da Cielo.

= Compatibilidade =

Compatível com as versões atuais do WooCommerce.

Este plugin também é compatível com o WooCommerce Extra Checkout Fields for Brazil, desta forma é possível enviar os campos de "CPF/CNPJ", "número do endereço" e "bairro".

= Instalação =

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

= Integração =

Este plugin funciona perfeitamente em conjunto com:

= Dúvidas? =

Você pode esclarecer suas dúvidas usando:

= Coloborar =

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

== Installation ==

= Instalação do plugin: =

= Requerimentos: =

É necessário possuir uma conta na Cielo, onde deve ser solicitado acesso ao Checkout Cielo (conhecido anteriormente como Solução Integrada).

Também é necessário ter instalada a última versão do WooCommerce.

= Configurações na Cielo: =

Antes de começar é necessário recuperar seu Merchant ID em Cielo Backoffice > Configurações > Dados cadastrais.

Depois indo até Cielo Backoffice > Configurações > Configurações da loja é possível configurar para funcionar ou não é modo de testes e configurar as URLs de retorno, notificação e mudança de status (note que são indicadas as URLs certas dentro da página de configurações do plugin).

= Configurações do Plugin: =

Com o plugin instalado acesse o admin do WordPress e entre em "WooCommerce" > "Configurações" > "Finalizar compra" > "Checkout Cielo".

Nesta págína você pode habitar o Checkout Cielo, adicionando o Merchant ID indicado nos passos anteriores, além de poder visualizar as URLs que serão utilizadas para retorno, notificação e mudança de status.

Também é possível ativar e desativar o Antifraude e também ativar uma opção capaz de colocar o pedido como "processando" quando o pagamento é autorizado (neste caso, o status do pedido muda antes do pagamento ser capturado).

Você ainda pode definir o comportamento da integração utilizando as opções:

= Configurações no WooCommerce =

No WooCommerce existe uma opção para cancelar a compra e liberar o estoque depois de alguns minutos.

Esta opção não funciona muito bem com a Cielo, pois pagamentos por débito online e boleto bancário podem demorar até 48 horas para serem validados.

Para impedir que os pagamentos sejam cancelados automaticamente pelo WooCommerce é necessário ir em "WooCommerce" > "Configurações" > "Produtos" > "Inventário" e limpar (deixe em branco) a opção Manter estoque (minutos).

Pronto, sua loja já pode receber pagamentos pelo Checkout Cielo.

== Frequently Asked Questions ==

= Qual é a licença do plugin? =

Este plugin esta licenciado como GPL.

= O que eu preciso para utilizar este plugin? =

= Como funciona o Checkout Cielo? =

Veja como funciona em Vendas online | Cielo e-Commerce.

= Como que plugin faz integração com a Cielo? =

Fazemos a integração baseada no Manual do Desenvolvedor.

= É possível enviar os dados de "Número", "Bairro" e "CPF" para a Cielo? =

Sim é possível, basta utilizar o plugin WooCommerce Extra Checkout Fields for Brazil.

= 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".

= Ao retornar a loja, não é exibida as informações do pedido, o que esta acontecendo de errado? =

O que acontece de errado, é que a API do Checkout Cielo ainda é muito pobre, não é possível enviar uma URL dinâmica para a Cielo e também a Cielo não retorna o cliente de volta utilizando qualquer parametro para que seja indentificado o pedido em questão.

Não gostou disso? Ótimo, porque eu também não estou safisteito com isso, entretanto tudo que podemos fazer é reclamar com a Cielo para tornar isto possível.

= Não consigo configurar o Google Analytics para detectar as vendas por este plugin, o que tem de errado? =

O mesmo problema da questão a cima, como o Checkout Cielo ainda tem uma API pobre, é impossível saber qual é o pedido do retorno.

= É possível funcionar com pagamentos recorrentes? =

O Checkout Cielo não possui nenhuma API ou forma para trabalhar com pagamentos recorrentes.

Entretanto é possível usar a opção de pagamentos recorrentes de forma manual do WooCommerce Subscriptions.

= A compra é cancelada após alguns minutos, mesmo com o pedido sendo pago, como resolvo isso? =

Para resolver este problema vá até "WooCommerce" > "Configurações" > "Produtos" > "Inventário" e limpe (deixe em branco) a opção Manter Estoque (minutos).

= O total do pedido no WooCommerce é diferente do enviado para a Cielo, como eu resolvo isso? =

Caso você tenha este problema, basta marcar ativar a opção Enviar apenas o total do pedido na página de configurações do plugin.

= Acontece um erro 404 quando redireciona para a Cielo =

Aparece 'HTTP Error 404. The requested resource is not found.' na URL http://cieloecommerce.cielo.com.br/Transactional/Order/Index? Provavelmente seu site está usando um serviço de CDN como o CloudFare e impedindo o redirecionamento HTTPS. Desligue o CDN e tente novamente.

= Mais dúvidas relacionadas ao funcionamento do plugin? =

Por favor, caso você tenha algum problema com o funcionamento do plugin, envie o log (ative ele nas opções do plugin e tente fazer uma compra, ele vai ficar dentro da pasta wp-content/plugins/woocommerce/logs/) usando o pastebin.com ou o gist.github.com, desta forma fica mais rápido para fazer o diagnóstico.

Com o log em mãos abra um tópico em nosso fórum.

== Screenshots ==

  1. Configurações do plugin.
  2. Exemplo do método de pagamento na página de finalização do pedido.
  3. Exemplo de tela de pagamento no ambiente da Cielo

== Changelog ==

= 1.1.0 - 2019/09/20 =

= 1.0.4 - 2015/08/16 =

= 1.0.3 - 2015/05/08 =

= 1.0.2 - 2015/04/16 =

= 1.0.1 - 2015/04/12 =

= 1.0.0 - 2015/04/07 =

== Upgrade Notice ==

= 1.1.0 =