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

Guia

_{​ ​do​ ​usuário}

Apresentação

Módulo_{​ ​responsável​ ​por​ ​realizar​ ​pagamentos​ ​por​ ​cartão​ ​de​ ​crédito​ ​online​ ​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,} 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.​ ​Neste​ ​módulo,​ ​apenas​ ​compras​ ​simples​ ​são​ ​efetuadas,​ ​isso​ ​é,​ ​sem​ ​a​ ​opção​ ​de} anti-fraude.

*Se_{​ ​desejar​ ​opção​ ​de​ ​anti-fraude,​ ​favor​ ​comunicar​ ​no​ ​email:​ ​​contato@mageup.com​​ ​para} agendar_{​ ​com​ ​nossa​ ​equipe​ ​a​ ​validação​ ​do​ ​antifraude​}.

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:​ ​​http://www.cielo.com.br/}

Como

_{​ ​instalar?}

Basta_{​ ​você​ ​descompactar​ ​todo​ ​o​ ​conteúdo​ ​do​ ​arquivo​ ​baixado​ ​e​ ​copiar​ ​o​ ​conteúdo​ ​para​ ​as​ ​respectivas} pastas_{​ ​do​ ​Magento.}

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ção

Configurações

_{​ ​Gerais​ ​Cielo}

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

Cielo

_{​ ​Cartão​ ​de​ ​Crédito}

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);}

- 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;} 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.}

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

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​ ​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 e-mail, 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 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. Porém, você deve verificar com a Cielo se a notificação está habilitada 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.}

-

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

-

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:}

- https://www.mageup.com/termos-e-condicoes

- 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​.}

-

E

_{​ ​se​ ​eu​ ​habilitar​ ​o​ ​anti​ ​fraude​ ​da​ ​Cielo?}

- No_{​ ​caso​ ​de​ ​você​ ​habilitar​ ​o​ ​anti​ ​fraude​ ​da​ ​Cielo,​ ​as​ ​suas​ ​transações​ ​serão} automaticamente_{​ ​de​ ​​autorizar​,​ ​independente​ ​se​ ​sua​ ​configuração​ ​estiver​ ​como}

capturar_{​,​ ​pois​ ​dessa​ ​forma​ ​o​ ​anti​ ​fraude​ ​da​ ​Cielo​ ​avaliará​ ​a​ ​compra​ ​e​ ​se​ ​não​ ​aprovada} realizará_{​ ​o​ ​cancelamento,​ ​sem​ ​necessidade​ ​de​ ​estorno,​ ​ou​ ​realizará​ ​a​ ​captura​ ​se} aprovado.