Cielo WooCommerce - Solução Webservice
| 开发者 |
Gabriel Reguly
claudiosanches gopaulo |
|---|---|
| 更新时间 | 2020年8月11日 07:01 |
| 捐献地址: | 去捐款 |
| PHP版本: | 3.9 及以上 |
| WordPress版本: | 5.5 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Visa (crédito e débido)
- MasterCard (crédito e débido)
- Diners Club
- Discover
- Elo
- American Express
- JCB
- Aura
- Solução Webservice.
- BuyPage Cielo (antigo e será desativado pela Cielo em breve).
- 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.
- 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:
- Cadastro de clientes do Banco do Brasil, Bradesco ou HSBC
- Cadastro de clientes dos demais bancos
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).
屏幕截图:
常见问题:
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.
更新日志:
- Força sempre limpar os dados do cartão quando algo acontece qualquer erro na finalização do pedido.
- Melhorada a exibição das opções de juros para cartão de crédito.
- Corridigo erro quando taxa de juros é igual ou menor do que zero.
- 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.
- Corrigido limite de caracteres para o campo de cartão (não estava funcionando para cartão Aura).
- Suporte confirmado para WooCommerce 2.4.
- 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.
- Corrigido os dados enviados para a Solução Webservice de débito e crédito.
- 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.
- Correção da validação de bandeira dos cartões de débito para a Solução Webservice.
- Correção da tradução.
- 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.
- 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.
- Corrigida a finalização com cartão de crédito quando as parcelas é configurada como 1.
- Corrigida a validação das parcelas quando configurado o número de parcelas como 1.
- 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".