mozgbrasil/magento-cielo-php55

Integração ao cielo

, _(*1)

Mozg\Cielo

Sinopse

Integração a Cielo 3.0, _(*2)

Demonstração

, _(*3)

Motivação

Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte, _(*4)

Suporte / Dúvidas

Para obter o devido suporte Clique aqui, relatando o motivo da ocorrência o mais detalhado possível e anexe o print da tela para nosso entendimento, _(*5)

Preço

Clique aqui, _(*6)

Quais os recursos do módulo

• [✓] Transação
• [✓] Consulta
• [✓] Captura
• [✓] Reembolso
• [✓] Cancelamento

Característica técnica

No checkout é feito o processo de autorização, _(*7)

No retorno de "Transação autorizada" é feito redirecionamento para a página de sucesso, _(*8)

Na página de sucesso é enviado infomações para o recurso de notificação da transação, _(*9)

Via CRON deve ser processado a notificação da transação, caso o pagamento seja confirmado, deve ser alterado o status do pedido para "Processando", liberando as ações para processar a fatura e o envio, _(*10)

A captura da transação deve ser feita acessando a fatura no Magento e clicando no botão "Capturar", caso seja feita a captura pelo sistema da Cielo não deve ser exibido no Magento o status de "Pagamento confirmado" quando feito a consulta usando a API da Cielo, _(*11)

Antes do envio da mercadoria, sempre confira as informações do pedido, se o status da transação está sendo exibido que o pagamento foi confirmado, inclusive junto a operadora financeira se a transação foi capturada, caso algo esteja inconsistente será necessário cancelar o pedido até a correção da ocorrência, _(*12)

Setup Cron

Para o uso do método é necessário ativar a CRON para o Magento, _(*13)

Clique aqui para visualizar o documento da MOZG, _(*14)

Certifique-se de que ação esteja sendo executado a cada minuto, _(*15)

Esse módulo usa o cronjob para processar as notificações, _(*16)

O módulo executa as notificações que foram recebidas há pelo menos 5 minutos., _(*17)

Instalação - Atualização - Desinstalação - Desativação

--, _(*18)

Este módulo destina-se a ser instalado usando o Composer, _(*19)

Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão, _(*20)

composer --version

Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui, _(*21)

--, _(*22)

É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader, _(*23)

Para visualizar se essa extensão está ativa em seu servidor, _(*24)

Certique se da presença do arquivo phpinfo.php na raiz do seu projeto, _(*25)

<?php phpinfo(); ?>

Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima, _(*26)

Acesse o arquivo pelo browser, _(*27)

Em seguida pesquise pelo termo "ionCube PHP Loader", _(*28)

Caso o seu servidor não tenha o suporte a extensão, Clique aqui, _(*29)

Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor, _(*30)

Descompacte o pacote e faça upload do arquivo "loader-wizard.php" para seu servidor, onde será demonstrado o passo a passo para a ativação da extensão, _(*31)

Clique aqui para ver os processos executados, _(*32)

--, _(*33)

Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final, _(*34)

--, _(*35)

Sugiro manter um ambiente de testes para efeito de testes e somente após os devidos testes aplicar os devidos procedimento no ambiente de produção, _(*36)

--, _(*37)

Sugiro efetuar backup da plataforma Magento e do banco de dados, _(*38)

--, _(*39)

Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado, _(*40)

--, _(*41)

Certique se da presença do arquivo composer.json na raiz do seu projeto Magento e que o mesmo tenha os parâmetros semelhantes ao modelo JSON abaixo, _(*42)

{
  "minimum-stability": "dev",
  "prefer-stable": true,
  "license": [
    "proprietary"
  ],
  "repositories": [
    {
      "type": "composer",
      "url": "https?://packages.firegento.com"
    }
  ],
  "extra": {
    "magento-root-dir": "./",
    "magento-deploystrategy": "copy",
    "magento-force": true
  }
}

Caso não exista o arquivo composer.json na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima, _(*43)

Para instalar o módulo execute o comando a seguir no terminal do seu servidor

composer require mozgbrasil/magento-cielo-php55:dev-master

Você pode verificar se o módulo está instalado, indo ao backend em:, _(*44)

STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output

--, _(*45)

Para atualizar o módulo execute o comando a seguir no terminal do seu servidor

Antes de efetuar qualquer processo que envolva atualização no Magento é recomendado manter o Compiler e Cache desativado, _(*46)

composer clear-cache && composer update

Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente, _(*47)

Para checar a data do módulo execute o seguinte comando, _(*48)

grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil

--, _(*49)

Para desinstalar o módulo execute o comando a seguir no terminal do seu servidor

composer remove mozgbrasil/magento-cielo-php55 && composer clear-cache && composer update

--, _(*50)

Para desativar o módulo

1. Antes de efetuar qualquer processo que envolva atualização sobre o Magento é necessário manter o Compiler e Cache desativado, _(*51)

2. Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg, _(*52)

A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo, _(*53)

Como configurar o método de pagamento

Para configurar o método de pagamento, acesse no backend em:, _(*54)

STORES -> Configuration -> Sales/Payment Methods -> Cielo (powered by MOZG)

Você terá os campos a seguir, _(*55)

Cielo API 3.0 - Configurações Padrão

Configurações necessárias

• Modo Teste ou Produção

Deve ser informado o devido ambiente, _(*56)

• Merchant ID para o ambiente de teste

Efetue o cadastro no seguinte ambiente para obter os dados de integração como: MerchantId e MerchantKey, _(*57)

https://cadastrosandbox.cieloecommerce.cielo.com.br/, _(*58)

• Merchant Key Ambiente de teste

Efetue o cadastro no seguinte ambiente para obter os dados de integração como: MerchantId e MerchantKey, _(*59)

https://cadastrosandbox.cieloecommerce.cielo.com.br/, _(*60)

• Merchant ID para o ambiente de produção

A informação deve ser fornecido pela Cielo, _(*61)

• Merchant Key Ambiente de produção

A informação deve ser fornecido pela Cielo, _(*62)

• Merchant ID Checkout Cielo

A informação deve ser fornecido pela Cielo, _(*63)

Avançado: Processamento de Pedidos Magento

• Status do pedido: ordem de criação

Status dos pedidos recém-criados, antes da confirmação de resultado de pagamento via notificações de servidor da operadora, _(*64)

• Status do pedido: autorização de pagamento

Status dos pedidos após autorização confirmada por uma notificação de AUTORIZAÇÃO da operadora, _(*65)

• Status do pedido: pagamento confirmado

Status dos pedidos após captura confirmada por uma notificação de AUTORIZAÇÃO da operadora, _(*66)

• Status do pedido: cancelamento de pedido

Status dos pedidos após cancelamento confirmada por uma notificação de CANCELAMENTO da operadora, _(*67)

Se as encomendas já estiverem faturadas, não poderão ser canceladas, _(*68)

• Status do pedido: captura de pagamento (produtos virtuais)

Selecione somente o status atribuído ao estado concluído, deixe vazio para usar o mesmo que os produtos normais, _(*69)

• Status do pedido: Reembolsado

Status dos pedidos após reembolso confirmada por uma notificação de REEMBOLSO da operadora, _(*70)

• Status do pedido: Reembolsado Parcial

Status dos pedidos após reembolso (parcial) confirmada por uma notificação de REEMBOLSO_PARCIAL da operadora. Recomendamos que não defina este status e deixe Magento decidir o status., _(*71)

• Status do pedido: pedidos pendentes

Status dos pedidos após notificação de PENDENCIA da operadora, _(*72)

• Criar uma fatura pendente (apenas para captura manual)

Isso criará uma fatura pendente se a notificação de AUTORIZAÇÃO for recebida., _(*73)

Nota: isto fará com que Magento empurre todas as encomendas para o estado: 'Processamento' uma vez que a fatura é criada, ignorando todas as outras definições., _(*74)

• Tipo de Captura

Imediato é o padrão, _(*75)

Defina como manual se você quiser executar a captura de fundos manualmente mais tarde, _(*76)

• Status do pedido: Capturar no embarque

Se você habilitar esta função será feito uma solicitação de captura para a operadora se você fizer o envio, _(*77)

• Ativar Descancelar pedido

Se uma pedido é cancelada por algum motivo, mas recebeu uma notificação de que o pagamento é autorizado, isso cancelará automaticamente o pedido, _(*78)

• Cancelamento\Reembolso automático quando o pedido é cancelado

Ativar / Desativar reembolso automático ao cancelar um pedido, _(*79)

• E-mail da fatura

Ativar / desativar atualizações de e-mails, _(*80)

• Enviar e-mail de notificaçao do status do pedido

Ativar / desativar e-mails de atualização para todas as alterações no status do pedido para o cliente, _(*81)

• Ativar log de depuração

Deve ser armazenado os processos do módulo em var/log/, _(*82)

O arquivo, _(*83)

DATE_mozg.log, _(*84)

se trata de log do módulo sendo um log mais detalhado contendo todos os processos inclusive das execuções realizadas pelas bibliotecas externas do módulo, _(*85)

O arquivo, _(*86)

payment_METHOD.log, _(*87)

Avançado: Cielo Notificações

• Ignorar notificação de reembolso

Se o reembolso for feito na operadora, e a mesma enviar uma notificação de reembolso para o Magento, deve ser criado automaticamente uma nota de crédito. Se você definir essa configuração como 'Sim', isso não acontecerá porque ele não processará nenhuma das notificações de REEMBOLSO recebidas., _(*88)

Avançao: Experiência de Checkout

• Redirecionar o destino após o cancelamento

Determina como os compradores são redirecionados após cancelar um pagamento., _(*89)

• Método de pagamento método de renderização

Determina se os métodos de pagamento serão exibidos com seu logotipo ou apenas o nome., _(*90)

• Idioma local (opcional)

Isso substituirá o local do cliente padrão do armazenamento do Magento., _(*91)

Deixe vazio para deixar Magento decidir (Ex: nl_NL), _(*92)

• Código do país ISO (opcional)

Isso irá substituir o país do endereço de faturamento do comprador ao determinar quais métodos de pagamento serão exibidos., _(*93)

Cartão de Crédito Cielo

• Ativar

Para "ativar" ou "desativar" o uso do método, _(*94)

• Ordem de exibição

É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, _(*95)

• Título

Nome do método que deve ser exibido, _(*96)

• Pagamentos aplicáveis aos países

Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países ", _(*97)

• Pagamentos específicos aos países

Você deve selecionar os países que o método deve ser funcional, _(*98)

• Tipos de Cartão de Crédito

Selecione as bandeiras liberadas pela operadora, _(*99)

• Visível em

Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, _(*100)

• Autenticar

Define se o comprador será direcionado ao Banco emissor para autenticação do cartão, _(*101)

Para essa opção é enviado o parâmetro ReturnUrl, não deve funcionar para dominios que contenham caracteres especiais conforme as regras da Cielo, _(*102)

Para pedidos feito no backend não ative essa opção, pois não deve funcionar o redirecionamento para a URL de autenticação, _(*103)

• Analise de Fraude

Deve funcionar somente no ambiente de produção, _(*104)

• Ativar Parcelamentos

Define o uso de parcelas, _(*105)

• Parcelas padrão

Para a coluna "Moeda" informe a sigla da moeda por exemplo BRL, _(*106)

Para a coluna "Montante (incl.)" informe o valor para a exibição da parcela, _(*107)

Para a coluna "Número máximo de parcelas" informe o número de parcelas que será exibida até o valor previamente informando para a exibição da parcela, _(*108)

Para a coluna "Taxa de juro (%)" informe a taxa de juro usada, _(*109)

-, _(*110)

A regra para a exibição da parcela é definida com base na faixas de preços, _(*111)

O módulo já vem pré-configurado da seguinte forma, _(*112)

Até R$ 100,00 em 1 parcela, _(*113)

Até R$ 200,00 em 2 parcelas, _(*114)

Até R$ 600,00 em 3 parcelas, _(*115)

Até R$ 800,00 em 4 parcelas, _(*116)

Até R$ 10.000,00 em 5 parcelas, _(*117)

Até R$ 100.000,00 em 6 parcelas, _(*118)

Altere conforme sua necessidade, _(*119)

• Desativar em total geral zero

Desative esta forma de pagamento no checkout quando o total geral da cotação for 0., _(*120)

Cartão de Débito Cielo

• Ativar

Para "ativar" ou "desativar" o uso do método, _(*121)

• Ordem de exibição

É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, _(*122)

• Título

Nome do método que deve ser exibido, _(*123)

• Pagamentos aplicáveis aos países

Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países ", _(*124)

• Pagamentos específicos aos países

Você deve selecionar os países que o método deve ser funcional, _(*125)

• Tipos de Cartão de Débito

Selecione as bandeiras liberadas pela operadora, _(*126)

• Visível em

Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, _(*127)

• Desativar em total geral zero

Desative esta forma de pagamento no checkout quando o total geral da cotação for 0., _(*128)

Boleto Cielo

• Ativar

Para "ativar" ou "desativar" o uso do método, _(*129)

• Ordem de exibição

É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, _(*130)

• Título

Nome do método que deve ser exibido, _(*131)

• Pagamentos aplicáveis aos países

Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países ", _(*132)

• Pagamentos específicos aos países

Você deve selecionar os países que o método deve ser funcional, _(*133)

• Tipos de Boleto

Selecione as bandeiras liberadas pela operadora, _(*134)

• Status do pedido não pago

Com Boleto é possível pagar menos do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*135)

• Status do pedido pago em excesso

Com Boleto é possível pagar mais do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*136)

• Visível em

Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, _(*137)

Transferência Eletrônica Cielo

• Ativar

Para "ativar" ou "desativar" o uso do método, _(*138)

• Ordem de exibição

É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, _(*139)

• Título

Nome do método que deve ser exibido, _(*140)

• Pagamentos aplicáveis aos países

Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países ", _(*141)

• Pagamentos específicos aos países

Você deve selecionar os países que o método deve ser funcional, _(*142)

• Tipos de Transferência Eletrônica

Selecione as bandeiras liberadas pela operadora, _(*143)

• Status do pedido não pago

Com Boleto é possível pagar menos do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*144)

• Status do pedido pago em excesso

Com Boleto é possível pagar mais do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*145)

• Visível em

Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, _(*146)

Checkout Cielo

• Ativar

Para "ativar" ou "desativar" o uso do método, _(*147)

• Ordem de exibição

É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, _(*148)

• Título

Nome do método que deve ser exibido, _(*149)

• Pagamentos aplicáveis aos países

Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países ", _(*150)

• Pagamentos específicos aos países

Você deve selecionar os países que o método deve ser funcional, _(*151)

• Nome que aparecerá na fatura

Informe o nome que aparecerá na fatura, _(*152)

• Ativar Antifraud

Defina o uso, _(*153)

• Status do pedido não pago

Com Boleto é possível pagar menos do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*154)

• Status do pedido pago em excesso

Com Boleto é possível pagar mais do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão, _(*155)

• Visível em

Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, _(*156)

Perguntas mais frequentes "FAQ"

Como cancelar um pedido

Para cancelar um pedido pelo magento, acesse a fatura previamente criada e clique no botão "Cancelar" em seguida acesse o pedido e clique no botão "Cancelar, _(*157)

Como fazer o reembolso

Acesse a fatura previamente criada e clique no botão "Reembolso", _(*158)

Obs. o botão "Reembolso" só deve ser exibido quando tiver sido feito a captura, _(*159)

Sobre erro de validação do cartão de crédito "Número do Cartão de Crédito não condiz com o tipo do cartão"

No Magento as validações de cartão de crédito é feita pelo script nativo da própria plataforma Magento, _(*160)

ou seja o seguinte script, _(*161)

/js/prototype/validation.js, _(*162)

_, _(*163)

Na ocasião habilitei o método nativo do Magento "Credit Card (saved)" que também usa o validador nativo onde o número do cartão em questão não passou pelo validador, _(*164)

Esse teste é uma forma de detectar se a ocorrência parte de módulos de terceiros ou se trata de ocorrência relativa ao Magento, _(*165)

_, _(*166)

Detectei que a validação não estava funcionando porque o projeto estava usando uma versão defasada do Magento que tem esse problema de validação, _(*167)

O projeto estava na versão 1.7.0.2 e a atual versão do Magento é 1.9.3.3, _(*168)

Como recomendado é sugerido sempre manter o projeto atualizado devido as melhorias e correções, _(*169)

_, _(*170)

Recomendei o uso de forma temporária do validador do Magento 1.9.3.3, até que o cliente atualize o projeto para a nova versão do Magento, _(*171)

https://raw.githubusercontent.com/firegento/magento/magento-1.9.3.3/js/prototype/validation.js, _(*172)

_, _(*173)

Uma forma para testar o validador é a seguinte, _(*174)

1. No checkout não digite nada e clique no botão de finalizar pedido, verá que será disparado o evento do validador apontando as ocorrência de não preenchimento, _(*175)

2. Digite a informação no devido campo e clique no botão de finalizar pedido, com as informações correta o validador deve ser processado sem exibição de alerta, _(*176)

_, _(*177)

Caso queira testar todas as bandeiras acesse, _(*178)

https://mozg.com.br/dicas/dicas-magento1#cartões-de-crédito-para-testes, _(*179)

Sobre o armazenamento da parcela

Para o método de pagamento: Braspag API V2 ou Cielo API 3.0 ou Redecard Komerci Webservice, _(*180)

A seleção da parcela é feita no Magento e armazenada no Magento, _(*181)

Para resgatar a parcela, podemos usar o seguinte script modelo, _(*182)

$order = Mage::getModel('sales/order')->load('855');
$payment = $order->getPayment();
$additionaInformation = $payment->getData('additional_information');
$installment = $additionaInformation['number_of_installments'];
echo $installment;

_, _(*183)

Para o método de pagamento: Checkout Cielo, _(*184)

A seleção da parcela é feita no ambiente da Cielo, _(*185)

No /checkout/ do Magento não é solicitado a seleção da parcela, por isso não temos o armazenamento e a exibição da mesma no gerenciamento do pedido em "Informações de Pagamento", _(*186)

_, _(*187)

Vejo no manual da Cielo em, _(*188)

https://developercielo.github.io/Checkout-Cielo/index.html#url-de-notifica%C3%A7%C3%A3o, _(*189)

Que a Cielo envia para a URL de notificação as informações relativas a transação do pagamento, _(*190)

Se estiver usando o módulo da MOZG posso estar analisando a possibilidade de adicionar esse recurso, _(*191)

Sobre URL: de Retorno, Notificação e Mudança de Status para o método Checkout Cielo

Esse recurso não foi implementado ainda, no aguardo de dados para acesso ao seguinte ambiente, _(*192)

https://cieloecommerce.cielo.com.br/Backoffice/, _(*193)

Sobre Ativar Parcela do Produto na Vitrine

Na necessidade de exibição de parcela na página de produto, talvez o seguinte módulo deva atender sua necessidade, _(*194)

https://www.magentocommerce.com/magento-connect/preco-parcelado-1.html, _(*195)

Que pode ser instalado via composer, _(*196)

Para instalar o módulo via composer execute o seguinte comando na raiz do projeto, _(*197)

composer require connect20/franciscoprado_precoparcelado

Oque fazer após a instalação do módulo ?

Crie uma conta de teste em, _(*198)

https://cadastrosandbox.cieloecommerce.cielo.com.br/, _(*199)

Onde será fornecido o seu MerchantId e MerchantKey, _(*200)

Configure no método o seu MerchantId e MerchantKey, _(*201)

Efetue um teste, _(*202)

Se foi exibido a tela de finalização quer dizer que foi processado sua transação, _(*203)

Envie e-mail para a Cielo solicitando homologação dessa integração e solicitando os dados para ser usados em ambiente de produção, _(*204)

Informe no assunto do e-mail "Número do Estabelecimento: ??? / Razão Social: ??? / Sobre: ???", _(*205)

A Cielo deve enviar e-mail com os devidos procedimentos, _(*206)

Não envie de e-mail a Cielo contendo assinatura e logotipos pois o mesmo pode ser bloqueado, _(*207)

O corpo do e-mail tem que ser branco somente com a interação de homologação, _(*208)

30 minutos depois de enviar o e-mail ligar para confirmar se eles receberem o e-mail, _(*209)

Dados que a Cielo solicita quando se liga para a confirmação do e-mail ( Número do estabelecimento, razão social e CNPJ), _(*210)

Como alterar a imagem do método

Pode ser adicionado a imagem, contendo qualquer uma das nomenclaturas a seguir, _(*211)

• method-boleto.png
• method-creditcard.png
• method-debitcard.png
• method-eletronictransfer.png

E adicione a imagem no diretório do seu template, _(*212)

/skin/frontend/, _(*213)

Dados de contato - Cielo

Cielo E-Commerce cieloecommerce@cielo.com.br Tel: 4002-9700 (Capitais e regiões metropolitanas) e 0800-570-1700 (Demais localidades), _(*214)

Enviar assunto no seguinte formato:, _(*215)

Número do Estabelecimento: ??? / Razão Social: ??? / Sobre: ???, _(*216)

ou acesse, _(*217)

Para entrar em contato com a [Cielo][contact-cielo], _(*218)

Manual

https://www.cielo.com.br/wps/portal/Home/internas/desenvolvedores/, _(*219)

https://developercielo.github.io/Webservice-3.0/, _(*220)

https://developercielo.github.io/Checkout-Cielo/, _(*221)

Contribuintes

Equipe Mozg, _(*222)

License

Comercial License, _(*223)

Badges

, _(*224)

:cat2:, _(*225)