Guia do usuário Módulo Cielo 3.0 Magento 1

Transcrição

1 Guia do usuário Módulo Cielo 3.0 Magento 1

2 Apresentação Módulo responsável por realizar pagamentos por cartão de crédito online, cartão de débito e boleto via Cielo versão 3.0. O módulo conta com a opção para apenas autorização ou autorização e captura da compra, para cartão de crédito, permitindo o estorno online de transações via painel administrativo de sua loja. Utiliza a última versão da API Cielo, versão 3.0. Permite o parcelamento das compras, incluindo a definição de valor mínimo para cada parcela, para cartão de crédito. Neste módulo, apenas compras simples são efetuadas, isso é, sem a opção de anti-fraude, para cartão de crédito (função não disponível para Boleto e cartão de débito na API da Cielo). Quais os pré-requisitos? Você precisa do Merchant ID e Merchant Key do serviço cielo 3.0, enviados pela Cielo após a contratação do mesmo. Para obter essas informações, você precisa contratar os serviços da Cielo: Como instalar? Basta você descompactar todo o conteúdo do arquivo baixado e copiar o conteúdo para as respectivas pastas do Magento.

3 ATENÇÃO: Verifique se todos os arquivos foram instalados no seu magento, incluindo a pasta lib/ Cielo Como configurar? Para configurar acesse: Sistema -> Configuração -> Formas de Pagamento Configurações Gerais Cielo Configuração

4 Ambiente: - Ambiente que será processado os pagamentos (Sandbox ou Produção); Merchant Key: - Chave enviada pela Cielo; Merchant Id: - Id enviado pela Cielo; Generate Log: - Gera log das requisições, envios e retornos no log var/log/cielo.log ; Antifraude: - Envia os dados e flag para antifraude. Quando essa opção está habilitada, os pagamentos entram como pendente e só são aprovados após verificação antifraude pela Cielo. As demais configurações estão explicadas abaixo de cada configuração no próprio Admin.

5 Cielo Cartão de Crédito

6 Habilitado: - Habilita ou desabilita a compra com cartão de crédito; Título: - O título que será mostrado ao cliente na finalização da compra; Bandeiras de cartão: - Escolha quais bandeiras serão permitidas para sua Loja (pressione a tecla CTRL para a escolha de mais de uma bandeira, ao clicar); Descrição na Fatura: - Nome customizado que aparecerá na fatura do cliente nas transações de cartão (máximo 13 caracteres); Número máximo de parcelas: - Até quantas parcelas sua loja irá permitir a compra; Valor mínimo para cada parcela: - Lembre-se de verificar com a Cielo se há valor mínimo de parcelas para compra; Juros para valor em x1: - Possibilita acrescentar juros para uma parcela. Juros para valor entre x2 e x6: - Possibilita acrescentar o valor de juros para parcelas entre 2x e 6x. Juros para valor entre 6x e 12x: - Possibilita acrescentar o valor de juros para parcelas entre 7x e 12x. Operação: - Está opção está relacionada ao fluxo de compra: - Capturar: Com essa opção selecionada, ao finalizar o pedido, o mesmo será capturado imediatamente direto do cartão de crédito do cliente; - Autorizar: Com essa opção, é apenas reservado o valor de compra no cartão do cliente, porém sem capturar. Isso permite que você cancele o pedido sem problemas ou capture horas depois, caso tenha passado por um processo de validação do pedido. Ao gerar a fatura (invoice) no painel do Magento, a captura online será realizado, registrando assim a compra no cartão de crédito do cliente; - Observação 1 : Se você utilizar a opção Autorizar, você terá que realizar a captura da compra no cartão de crédito manualmente, utilizando a opção de Faturar (online) o pedido no painel administrativo do Magento ou realizar o Cancelamento do pedido pelo painel do Magento; - Observação 2 : Quando a opção antifraude está habilitada, automaticamente o pedido seguirá o seguinte passo: Autorizar a transação -> Verificar no Antifraude a compra -> Capturar a compra ou Cancelar a compra. Ou seja, fará o mesmo que a configuração Autorizar, porém de forma automática. Validate Payment - Essa opção foi criada para desabilitar o validate no backend ao processar a compra. É recomendado configurar como Não nesta opção, quando seu checkout for OSC. As demais configurações estão explicadas abaixo de cada configuração no próprio Admin.

7 Cielo Cartão de Débito Ativado: - Ativa ou desativa a compra com cartão de débito cielo; Título: - O título que será mostrado ao cliente na finalização da compra; Descrição na Fatura: - Nome customizado que aparecerá na fatura do cliente nas transações de cartão (máximo 13 caracteres); Bandeiras de cartão: - Escolha quais bandeiras serão permitidas para sua Loja (pressione a tecla CTRL para a escolha de mais de uma bandeira, ao clicar);

8 Boleto Cielo Habilitado: - Habilita ou desabilita a compra com Boleto Cielo; Título: - O título que será mostrado ao cliente na finalização da compra; Dias Vencimento: - Dias adicionais que será gerado a data de vencimento do Boleto Cielo; Provider: - Banco habilitado para emissão do boleto pela Cielo (verificar com a Cielo qual utilizar); Instruções: - Uma frase que será apresentada ao cliente com instruções sobre o Boleto, como por exemplo sobre prazos de validade ou impressão.

9 Perguntas frequentes: - Quais bandeiras são suportadas pelo módulo? - R: As bandeiras suportadas pela Cielo são VISA, MASTERCARD, AMEX, DINERS e ELO. - O módulo possibilita testes the com ambiente sandbox da Cielo? - Sim, veja as Configurações Gerais do módulo para saber como habilitar essa opção. Veja também com o suporte da Cielo para mais informações para adquirir a Merchant Key e Id do Sandbox para testes. - Não possuo as chaves necessárias para a configuração do código e chave, o que devo fazer? - Você deve entrar em contato com a Cielo para obter tais informações, como a Merchant Key e Merchant Id (obrigatórios para funcionamento da integração). - O módulo permite emitir segunda via do Boleto? - Sim, quando um cliente efetua uma compra via Boleto, o link de impressão é apresentado na finalização da compra e enviado para o cliente via , sendo possível a impressão a qualquer momento. Apresenta também o link do Boleto no painel administrativo, dentro do pedido, porém sem alterar a data de vencimento do boleto. - Este módulo possui conciliação bancária (quando o boleto/débito for pago o status do pedido muda)? - Sim, ao receber a notificação de que o Boleto foi pago, o status do pedido no Magento receberá o status Aprovado, bem como um comentário do Pagamento. O mesmo ocorre para transações de cartão de crédito e débito. Porém, você deve verificar com a Cielo se a notificação está habilitada (configurar a url e se você não for utilizar a opção somente autorizar do módulo, no qual terá que faturar e cancelar os pedidos manualmente. - Qual a URL de notificação? - Deve ser configurada no painel da Cielo: - Este módulo permite comprar pelo Admin? - Sim, as formas de pagamento habilitadas do módulo Cielo aparecerão ao criar um pedido pelo painel administrativo. - Este módulo exibe o link de boleto na página de sucesso de compra? - Sim, o módulo adiciona o bloco de informações de pagamento na página de sucesso, incluindo o link de Boleto. Porém, deve-se tomar cuidado com a compatibilidade do tema, caso não exibir link do boleto, você deverá pedir para seu desenvolvedor corrigir ou informá-lo para adicionar o seguinte código no success.phtml: <?php echo Mage::app()->getLayout()->createBlock( trezo_cielo/onepage_success', 'trezo_cielo );?> - Observação : É recomendável que seja customizado o layout do link de boleto, já que é exibido sem estilo na página.

10 - Quais versões do Magento são suportadas? - O módulo foi testado com as versões 1.7.x, 1.8.x, 1.9.x, porém versões inferiores podem ser suportadas. Vale ressaltar que este módulo é NÃO é compatível com versões 2.x do Magento. - Posso utilizar o mesmo módulo em várias lojas? - Não. Cada loja precisa de uma licença. Portanto, é necessário comprar um módulo para cada loja Magento. Leia nossas regras: A licença suporte 1 módulo por instalação do magento - O que é capturar x autorizar? - Nas opções de compra com cartão de crédito há 2 fases da compra: 1. Autorização : Momento que é verificado se o cartão é válido, seguido pela verificação do limite do cartão de crédito se é o suficiente para a compra, terceiro é utilizado como uma reserva da compra. Porém, nesse momento, ainda não existe a transação e a compra não é exibida na fatura do cliente, dessa forma, permitindo cancelar a transação sem dor de cabeça ou seguir para o próximo passo que é a captura. 2. Captura : Nesse momento, após a autorização da compra, é possível você capturar a transação do cartão de crédito, tornando-a oficial e registrando a compra na fatura do cartão. Sabendo disso, no fluxo de compra, você pode optar pela opção de capturar automáticamente após a autorização da compra (opção Capturar do módulo) ou realizar a captura posterior (manualmente) utilizando-se da opção Autorizar do módulo. - Por que devo utilizar a opção Capturar? - Essa opção é recomendada quando não há a necessidade de verificação ou validação da compra antes de realizar a captura. Digamos que você venda para um público específico já pré-aprovado com cadastro ou venda um produto que impossibilita a tentativa de fraude. - Por que devo utilizar a opção Autorizar? - No mercado brasileiro, principalmente, há um indíce de fraude e tentativa de compras com cartões clonados/roubados muito grande, com isso, há a necessidade de se precaver com uma verificação da compra, utilizando algum serviço de anti-fraude (como o clearsale start, por exemplo). Dessa forma, você permite que o cliente realize a compra mas sem registrar em sua fatura, após uma verificação minuciosa, seja manual ou por algum serviço de antifraude, você então gera manualmente a fatura do pedido pelo admin, consequentemente realizando a captura da compra. Atenção Em alguns processos de homologação a Cielo requer que os campos sejam apagados após o envio das informações. Como este é uma personalização do seu tema, os seguintes passos abaixo devem ser seguidos pelo desenvolvedor no tema do checkout. Para o OneStepCheckout: skin/frontend/package/tema/onestepcheckout/js/form.js Vá no arquivo: skin/frontend/base/default/onestepcheckout/js/form.js

11 Próximo a linha 126, onde ele joga o alert() da mensagem de erro retornada do Ajax, dentro da função oncomplete, adicione: jquery('#payment_form_cielo_cc_cc').find("input[type=text], textarea, select").val(""); jquery('#payment_form_cielo_dc_dc').find("input[type=text], textarea, select").val(""); Para o checkout IWD: Arquivo: skin/frontend/base/default/js/iwd/opc/checkout.js Na linha 513, no método prepareorderresponse. Nos demais checkout, pedimos que a personalização seja efetuada pelo seu desenvolvedor conforme checkout.