README

Mozg\Cielo

简介

集成到Cielo 3.0

动机

为了满足市场对Magento模块的需求，提供改进和优秀的支持

演示视频

支持 / 咨询

为了获得适当的支持，请点击此处，尽可能详细地描述问题发生的原因，并附加屏幕截图以供理解

价格

点击此处

模块资源

• [✓] 交易
• [✓] 查询
• [✓] 捕获
• [✓] 退款
• [✓] 取消

技术特征

在结账时执行授权过程

在收到“交易授权”返回时，将重定向到成功页面

在成功页面上发送信息到交易通知资源

通过CRON应处理交易通知

在处理通知时，如果支付已确认，则应将订单的“状态/状态”更改为“processing”或“正在处理”，以释放处理账单和发货的操作

捕获交易应通过访问Magento中的账单并单击“捕获”按钮来完成，如果通过Cielo的系统进行捕获，则在使用Cielo的API进行查询时不应在Magento中显示“支付已确认”状态

在发货之前，始终检查订单信息，如果显示交易状态表明支付已确认，包括金融运营商是否已捕获交易，如果存在不一致的情况，则必须取消订单直到问题纠正

当订单发货时，状态将更改为“complete”或“完成”

已实施自动化，每5分钟查询一次交易状态以更新订单状态

设置Cron

为了使用该方法，需要激活CRON以供Magento使用

点击此处查看MOZG文档

确保每分钟执行一次操作

该模块使用cronjob来处理通知

模块执行至少5分钟前收到的通知

在Heroku上测试

我想展示我为Heroku平台提供的应用程序

只需一键，应用程序即可创建使用电子商务平台Magento的在线商店并安装MOZG模块

https://github.com/mozgbrasil/heroku-magento#descrição

安装 - 更新 - 卸载 - 禁用

--

建议“打印”包含所有执行步骤的屏幕截图

如有任何困难，请将屏幕截图发送给我们

--

此模块旨在使用Composer安装

在终端中执行以下命令，以查看Composer及其版本是否存在

composer --version

如果您环境中没有Composer，建议阅读以下文章 点击这里

--

服务器需要支持ionCube PHP Loader扩展点击这里

为了查看该扩展在PHP CLI环境中的存在，请在终端中执行以下命令

php -v

为了查看该扩展在PHP WEB环境中的激活情况

请确认您的项目根目录中存在phpinfo.php文件

<?php phpinfo(); ?>

如果您的Magento项目根目录中没有phpinfo.php文件，请创建该文件并添加上述内容

通过浏览器访问该文件

然后在浏览器中搜索“ionCube PHP Loader”

如果您的服务器不支持该扩展，请联系您的托管服务提供商，并请求他们激活该扩展

如果您有权限并希望激活该扩展，点击这里

在“Loader Downloads API”中，下载与您的服务器兼容的包

解压包并将“loader-wizard.php”文件上传到您的服务器，该文件将演示激活扩展的步骤

点击这里查看执行过程

--

在存在“ionCube PHP Loader”的情况下，下载以下文件并将其放置在服务器根目录中，然后访问它。如果一切正常，则说明“ionCube”正在读取此类加密

https://raw.githubusercontent.com/mozgbrasil/heroku-magento/master/phpinfo-ioncube-encoder10-x86-64-php_71.php

--

要使用MOZG的模块，必须接受最终用户许可协议

--

建议您保留一个测试环境进行测试，并且只有在经过适当的测试后，才在生产环境中应用适当的程序

--

建议您备份Magento平台和数据库

--

在进行任何Magento更新之前，始终保持Compiler和Cache禁用

--

请确认您的项目根目录中存在composer.json文件，并且其参数与以下JSON模式类似

{
  "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
  }
}

如果您的Magento项目根目录中没有composer.json文件，请创建该文件并添加上述内容

要安装模块，请在您的服务器终端中执行以下命令

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

您可以通过访问后端来检查模块是否已安装

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

--

要更新模块，请在您的服务器终端中执行以下命令

在进行任何涉及更新的过程之前，建议保持Compiler和Cache禁用

composer update

在发生错误时，请将/vendor/mozgbrasil文件夹重命名，然后重新执行

要检查模块的日期，请执行以下命令

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

--

要卸载模块，请在您的服务器终端中执行以下命令

composer remove mozgbrasil/magento-cielo-php_71

--

要禁用模块

1. 在进行涉及更新的任何过程之前，必须保持Compiler和Cache禁用

2. 如果您想禁用MOZG的模块，请重命名以下文件夹app/code/local/Mozg

模块禁用可以用来检测特定事件是否与模块有关

如何配置支付方式

要配置支付方式，请访问后端

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

您将看到以下字段

Cielo API 3.0 - 默认配置

必需的配置

• 测试或生产模式

必须指定相应环境

• 测试环境的商户ID

在以下环境中进行注册以获取集成数据，如：MerchantId 和 MerchantKey

https://cadastrosandbox.cieloecommerce.cielo.com.br/

• 测试环境 Merchant Key

在以下环境中进行注册以获取集成数据，如：MerchantId 和 MerchantKey

https://cadastrosandbox.cieloecommerce.cielo.com.br/

• 生产环境 Merchant ID

信息应由 Cielo 提供

• 生产环境 Merchant Key

信息应由 Cielo 提供

• Cielo Checkout Merchant ID

信息应由 Cielo 提供

高级：Magento 订单处理

• 订单状态：创建订单

订单状态，在通过运营商服务器通知确认支付结果之前

• 订单状态：支付授权

订单在运营商授权通知确认后

• 订单状态：支付确认

订单在运营商授权通知确认捕获后

• 订单状态：订单取消

订单在运营商取消通知确认后

如果订单已开票，则无法取消

• 订单状态：支付捕获（虚拟产品）

仅选择分配给完成状态的订单状态，留空以使用与普通产品相同的状态

• 订单状态：已退款

运营商退款通知确认后的订单状态

• 订单状态：部分退款

运营商确认部分退款（部分退款）后的订单状态。建议不要定义此状态，让 Magento 决定状态。

• 订单状态：挂起订单

运营商挂起通知后的订单状态

• 创建挂起的账单（仅适用于手动捕获）

如果收到授权通知，这将创建一个挂起的账单。

注意：这将在创建账单后将所有订单推送到“处理”状态，忽略所有其他设置。

• 捕获类型

需要使用此自动化执行 CRON 运行的通知处理时，应选择“自动”选项。

需要手动捕获交易时，应选择“手动”选项。此操作通过访问订单账单并单击“捕获”按钮完成。

• 在发货时捕获

如果您启用此功能，则在发货时将向运营商发出捕获请求。

• 激活取消订单

如果订单由于某些原因被取消，但收到支付授权的通知，则会自动取消订单。

• 取消订单时自动退款/退款

激活/停用取消订单时的自动退款/退款

• 账单电子邮件

激活/停用电子邮件更新

• 发送订单状态通知电子邮件

激活/停用所有订单状态更改的客户更新电子邮件

• 激活调试日志

应将模块过程存储在 var/log/ 中

文件

DATE_mozg.log

这是模块日志，是一个更详细的日志，包含所有过程，包括模块外部库执行的执行

文件

payment_METHOD.log

高级：Cielo 通知

• 忽略退款通知

如果退款在运营商完成，并且运营商向 Magento 发送退款通知，则将自动创建一个贷项通知。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理收到的任何退款通知。

高级：结账体验

• 取消订单后重定向目标

确定买家在取消付款后如何被重定向。

• 支付方式显示方式

确定支付方式是否以logo或仅以名称显示。

• 本地语言（可选）

这将替换Magento存储的默认客户位置。

留空以由Magento决定（例如：nl_NL）

• ISO国家代码（可选）

这将替换在确定显示哪些支付方式时，买家的账单地址的国家。

天际信用卡

• 启用

用于“启用”或“禁用”该方法的用途

• 显示顺序

这是在订单结算步骤中显示的送货方式顺序

• 标题

应显示的该方法名称

• 适用于国家的支付方式

您可以选择该方法是否应适用于“接受所有国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• 信用卡类型

选择运营商批准的标志

• 创建发货

如果您启用此选项，则在创建账单时将自动创建发货

• 可见性

确定在Magento前端和/或后端中此支付方式的可见性

• 认证

定义买家是否将被重定向到发卡银行进行卡认证

对于此选项，将发送ReturnUrl参数，不应在遵循Cielo规则的包含特殊字符的域中工作

对于在后台制作的订单，不要激活此选项，因为它不应将重定向到认证URL

• 欺诈分析

仅在生产环境中使用

• 启用分期付款

定义分期付款的使用

• 默认分期付款

对于“货币”列，请提供货币缩写，例如BRL

对于“金额（含）”列，请提供显示分期的值

对于“最大分期数”列，请提供显示分期数直到之前提供显示分期值的金额

对于“利率（%）0.0”列，请提供使用的利率

分期显示规则基于价格范围

模块已预先配置，使用以下规则

在这个规则中

介于R$ 0,00至R$ 100,00显示1期

介于R$ 101,00至R$ 200,00显示2期

介于R$ 201,00至R$ 600,00显示3期

介于R$ 601,00至R$ 800,00显示4期

介于R$ 801,00至R$ 10,000,00显示5期

介于R$ 10,000,00至R$ 100,000,00显示6期

根据您的需要进行更改

• 总金额为零时禁用

当报价的总金额为0时，在结账时禁用此支付方式。

天际借记卡

• 启用

用于“启用”或“禁用”该方法的用途

• 显示顺序

这是在订单结算步骤中显示的送货方式顺序

• 标题

应显示的该方法名称

• 适用于国家的支付方式

您可以选择该方法是否应适用于“接受所有国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• 借记卡类型

选择运营商批准的标志

• 可见性

确定在Magento前端和/或后端中此支付方式的可见性

• 总金额为零时禁用

当报价的总金额为0时，在结账时禁用此支付方式。

天际汇票

• 启用

用于“启用”或“禁用”该方法的用途

• 显示顺序

这是在订单结算步骤中显示的送货方式顺序

• 标题

应显示的该方法名称

• 适用于国家的支付方式

您可以选择该方法是否应适用于“接受所有国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• 汇票类型

选择运营商批准的标志

• 订单未付款状态

使用汇票可以支付少于总金额的金额。如果适用，请在此选择状态。如果您留空，它将采用默认的订单付款授权状态

• 订单超额付款状态

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

• 可见性

确定在Magento前端和/或后端中此支付方式的可见性

Transferência Eletrônica Cielo

• 启用

用于“启用”或“禁用”该方法的用途

• 显示顺序

这是在订单结算步骤中显示的送货方式顺序

• 标题

应显示的该方法名称

• 适用于国家的支付方式

您可以选择该方法是否应适用于“接受所有国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• Tipos de Transferência Eletrônica

选择运营商批准的标志

• 订单未付款状态

使用汇票可以支付少于总金额的金额。如果适用，请在此选择状态。如果您留空，它将采用默认的订单付款授权状态

• 订单超额付款状态

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

• 可见性

确定在Magento前端和/或后端中此支付方式的可见性

Checkout Cielo

• 启用

用于“启用”或“禁用”该方法的用途

• 显示顺序

这是在订单结算步骤中显示的送货方式顺序

• 标题

应显示的该方法名称

• 适用于国家的支付方式

您可以选择该方法是否应适用于“接受所有国家”或“指定国家”

• 特定国家的支付方式

您必须选择该方法应功能的国家

• Nome que aparecerá na fatura

Informe o nome que aparecerá na fatura

• Ativar Antifraud

Defina o uso

• 订单未付款状态

使用汇票可以支付少于总金额的金额。如果适用，请在此选择状态。如果您留空，它将采用默认的订单付款授权状态

• 订单超额付款状态

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

• 可见性

确定在Magento前端和/或后端中此支付方式的可见性

Perguntas mais frequentes "FAQ"

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

::

Crie uma conta de teste em

https://cadastrosandbox.cieloecommerce.cielo.com.br/

Onde será fornecido o seu MerchantId e MerchantKey

Configure no método o seu MerchantId e MerchantKey

Para efeito de testes, pode ser usado os seguintes cartões de testes

http://mozg.com.br/dicas/dicas-magento1#cartões-de-crédito-para-testes

Efetue a finalização de um pedido sobre o ambiente de teste onde será feito o processamento da transação

Se foi exibido a tela de finalização quer dizer que foi processado sua transação

::

Deve ser enviado e-mail para a Cielo solicitando homologação dessa integração e solicitando os dados para ser usados em ambiente de produção

::

Envie o seguinte email para cieloecommerce@cielo.com.br

Assunto: "Número do Estabelecimento: ??? / Razão Social: ??? / Sobre: ??"

A/C Suporte Cielo

Favor iniciar processo de homologação

Fico no aguardo dos dados do ambiente de produção para prosseguirmos com processo de homologação

Conforme imagem em anexo o processo está funcional sobre esse ambiente

- URL do produto

    http://phpstack-97926-416875.cloudwaysapps.com/teste.html

- Usuário e Senha (caso seja necessário)

    mailer@mozg.com.br / 123456

::

A Cielo deve enviar e-mail com os devidos procedimentos

Não envie de e-mail a Cielo contendo assinatura e logotipos pois o mesmo pode ser bloqueado

O corpo do e-mail tem que ser branco somente com a interação de homologação

30 minutos depois de enviar o e-mail ligar para confirmar se eles receberem o e-mail

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

::

Sobre "cartões internacionais"

Conforme

https://developercielo.github.io/faq/faq-api-3-0#24-a-api-cielo-ecommerce-aceita-pagamento-com-diferentes-moedas-e-cartões-internacionais

A Cielo aceita cartões internacionais, mas as transações são processadas em Reais "R$/BRL"

Portanto a moeda base da loja deve ser "R$/BRL"

A seguir temos um topico sobre a cotação de moedas

http://mozg.com.br/dicas/dicas-magento1#cotação-de-moedas-magento-cambio

Sobre "Pagamento por e-mail"

A pratica de "Pagamento por e-mail" consiste conter no e-mail do pedido ou similar um link para o usuario acessar e efetuar o pagamento

No módulo da Cielo consta a integração "Checkout Cielo" que permite essa funcionalidade

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

Como fazer o reembolso

Acesse a fatura previamente criada e clique no botão "Reembolso"

Obs. o botão "Reembolso" só deve ser exibido quando tiver sido feito a captura

Na visualização do pedido ao clicar no botão "Reembolsar" o Magento só exibe o botão nomeado como "Reembolso Offline", ao clicar nesse botão só é feito a ação de Reembolso para o Magento

Na visualização da fatura do pedido ao clicar no botão "Reembolsar" o Magento deve exibir os botões nomeados como "Reembolso Offline" e "Reembolso", ao clicar no botão "Reembolso" é disparado ação "Online" ou seja é disparado ação para a operadora de pagamento "Cancelar" a transação relacionada ao pedido

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

ou seja o seguinte script

/js/prototype/validation.js

::

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

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

::

检测到验证未正常工作，因为项目正在使用一个过时的 Magento 版本，该版本存在验证问题

项目正在使用 1.7.0.2 版本，而 Magento 的最新版本是 1.9.3.3

如推荐的那样，始终建议保持项目更新，以利用改进和修复

::

建议临时使用 Magento 1.9.3.3 版本的验证器，直到客户将项目更新到新的 Magento 版本

https://raw.githubusercontent.com/firegento/magento/magento-1.9.3.3/js/prototype/validation.js

::

测试验证器的一种方法是以下方法

1. 在结账时不输入任何内容，然后点击“完成订单”按钮，您将看到会触发验证器事件，指向未填写的地方

2. 在相应的字段中输入信息，然后点击“完成订单”按钮，如果信息正确，验证器应处理而没有警报显示

::

如果您想测试所有标志，请访问

https://mozg.com.br/dicas/dicas-magento1#cartões-de-crédito-para-testes

关于分期付款存储

对于付款方式：Braspag API V2 或 Cielo API 3.0 或 Redecard Komerci Webservice

分期选择在 Magento 中进行，并存储在 Magento 中

要提取分期，我们可以使用以下模型脚本

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

::

对于付款方式：Checkout Cielo

分期选择在 Cielo 环境中进行

在 Magento 的 /checkout/ 中不要求选择分期，因此我们无法在“支付信息”订单管理中存储和显示它

管理 Checkout Cielo

https://cieloecommerce.cielo.com.br/Backoffice/

关于 URL：返回、通知和状态更改的“Checkout Cielo”方法

对于 URLs

• 返回 URL

建议不提供任何信息

• 通知 URL

  http://SEU_DNS/mozg_cielo/process/notification/checkout_cielo/robo/

• 状态更改 URL

  http://SEU_DNS/mozg_cielo/process/notification/checkout_cielo/robo/

关于“Checkout Cielo”环境中选择的标志

Cielo 发送的通知中是

如何更改方法图像

可以添加包含以下任何名称的图像

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

并将图像添加到您的模板目录中

/skin/frontend//default/images/mozg_cielo

联系信息 - Cielo

Cielo E-Commerce cieloecommerce@cielo.com.br 电话：4002-9700（首都和直辖市）和0800-570-1700（其他地区）

发送主题格式如下

商户编号：??? / 商户名称：??? / 关于：???

或访问

要联系 Cielo

手册

https://developercielo.github.io/manual/cielo-ecommerce

https://developercielo.github.io/manual/checkout-cielo

贡献者

Mozg 团队

许可

商业许可

徽章

🐈