README

Mozg\Cielo

概述

集成到Cielo 3.0

演示

动机

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

支持/疑问

要获取适当的支持，请点击此处，尽可能详细地报告发生的原因，并附加屏幕截图以便我们理解

价格

点击此处

模块有哪些功能

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

技术特性

在结账时进行授权过程

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

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

通过CRON应处理交易通知，如果支付得到确认，则应将订单状态更改为“处理中”，以便处理账单和发货

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

在发货之前，始终检查订单信息，如果显示交易状态表明支付已确认，包括与金融机构一起，如果交易已捕获，如果出现不一致的情况，则需要取消订单直到问题得到纠正

设置Cron

使用该方法需要为Magento激活CRON

点击此处查看MOZG的文档

确保每分钟执行一次该操作

该模块使用cronjob来处理通知

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

安装 - 更新 - 卸载 - 禁用

本模块旨在通过Composer安装

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

composer --version

如果没有在环境中安装Composer，建议阅读以下文章点击此处

服务器需要支持ionCube PHP Loader扩展

要查看该扩展是否在您的服务器上激活

请确保项目根目录中存在phpinfo.php文件

<?php phpinfo(); ?>

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

通过浏览器访问该文件

然后搜索“ionCube PHP Loader”

如果您的服务器不支持扩展，请点击此处点击这里

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

解压包并上传“loader-wizard.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
  }
}

如果项目根目录下不存在composer.json文件，请创建一个并添加以上内容

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

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

您可以通过进入后台来检查模块是否已安装

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

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

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

composer clear-cache && composer update

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

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

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

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

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

要禁用模块

在执行涉及更新Magento的任何过程之前，必须保持Compiler和Cache禁用
如果您想禁用MOZG模块，请重命名以下文件夹 app/code/local/Mozg

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

如何配置支付方式

要配置支付方式，请进入后台

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

您将看到以下字段

Cielo API 3.0 - 默认设置

必要的设置

• 测试模式或生产模式

应指定相应的环境

• 测试环境Merchant 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决定状态。

• 订单状态：待处理

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

• 创建挂账发票（仅适用于手动捕获）

如果收到授权通知，将创建一个挂账发票。

注意：一旦创建发票，Magento将自动将所有订单推送到“处理”状态，忽略所有其他设置。

• 捕获类型

即时是默认值

如果您想在以后手动执行资金捕获，请设置为手动

• 订单状态：在发货时捕获

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

• 激活取消订单

如果由于某些原因取消订单，但收到支付已授权的通知，这将自动取消订单

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

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

• 发票电子邮件

激活/取消电子邮件更新

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

激活/取消电子邮件更新，以向客户发送所有订单状态更改

• 激活调试日志

应将模块进程存储在var/log/

文件

DATE_mozg.log

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

文件

payment_METHOD.log

高级：Cielo 通知

• 忽略退款通知

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

高级：结账体验

• 取消支付后重定向目的地

确定支付取消后购买者如何重定向。

• 支付方法渲染方法

确定支付方法是否显示其徽标或仅显示名称。

• 本地语言（可选）

这将替换Magento存储的客户默认语言设置。

留空让Magento决定（例如：nl_NL）

• ISO 国家代码（可选）

这将替换购买者账单地址的国家/地区，以确定将显示哪些支付方法。

天际信用卡

• 激活

用于“激活”或“取消”使用该方法的

• 显示顺序

这是在订单关闭步骤中显示的交货方式顺序

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 信用卡类型

选择运营商释放的标志

• 可见性

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

• 认证

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

为此选项将发送ReturnUrl参数，不应适用于符合Cielo规则的包含特殊字符的域名

对于后端下发的订单，请勿激活此选项，因为不应将重定向到认证URL

• 欺诈分析

仅在生产环境中生效

• 激活分期付款

定义分期付款的使用

• 默认分期

在“货币”列中，请输入货币缩写，例如BRL

在“总金额（含）”列中，请输入分期显示的金额

在“最大分期数”列中，请输入显示分期直到预先输入的显示分期金额的分期数

在“利率（%）”列中，请输入使用的利率

分期显示规则是基于价格区间的

模块已预先配置如下

100.00元及以下，1期

200.00元及以下，2期

600.00元及以下，3期

800.00元及以下，4期

10,000.00元及以下，5期

100,000.00元及以下，6期

根据您的需求进行修改

• 总体总额为零时禁用

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

天翼借记卡

• 激活

用于“激活”或“取消”使用该方法的

• 显示顺序

这是在订单关闭步骤中显示的交货方式顺序

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 借记卡类型

选择运营商释放的标志

• 可见性

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

• 总体总额为零时禁用

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

天翼汇票

• 激活

用于“激活”或“取消”使用该方法的

• 显示顺序

这是在订单关闭步骤中显示的交货方式顺序

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 汇票类型

选择运营商释放的标志

• 未付款订单状态

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

• 超额付款订单状态

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

• 可见性

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

天翼电子转账

• 激活

用于“激活”或“取消”使用该方法的

• 显示顺序

这是在订单关闭步骤中显示的交货方式顺序

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 电子转账类型

选择运营商释放的标志

• 未付款订单状态

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

• 超额付款订单状态

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

• 可见性

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

天翼结账

• 激活

用于“激活”或“取消”使用该方法的

• 显示顺序

这是在订单关闭步骤中显示的交货方式顺序

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 账单中显示的名称

请输入账单中显示的名称

• 激活反欺诈

定义使用

• 未付款订单状态

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

• 超额付款订单状态

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

• 可见性

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

常见问题解答“FAQ”

如何取消订单

要取消通过magento进行的订单，请访问先前创建的账单，然后点击“取消”按钮。接下来，访问订单并点击“取消”按钮

如何退款

访问先前创建的账单并点击“退款”按钮

注意：仅在已进行扣款时显示“退款”按钮

关于信用卡验证错误“信用卡卡号不符合卡类型”

在magento中，信用卡验证是通过magento自身脚本完成的

也就是说，以下脚本

/js/prototype/validation.js

在此情况下，我启用了magento的内置方法“Credit Card (saved)”，它也使用内置验证器，其中所涉及的卡号未通过验证器

此测试是为了检测问题是否来自第三方模块或是否与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

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

在没有结账的情况下，不要输入任何内容，然后点击完成订单按钮，您会发现会触发验证器事件，提示未填写
在相应的字段中输入信息，然后点击完成订单按钮，如果信息正确，验证器应该会处理而不显示警报

如果您想测试所有卡种，请访问

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/中不需要选择分期，因此我们没有在“支付信息”中的订单管理中存储和显示分期的功能

请查看Cielo手册中的

https://developercielo.github.io/Checkout-Cielo/index.html#url-de-notifica%C3%A7%C3%A3o

Cielo会将支付交易的相对信息发送到通知URL

如果您使用的是MOZG模块，我可以分析添加此功能的可能性

关于Checkout Cielo的返回、通知和状态更改URL

此功能尚未实现，正在等待访问以下环境的数据

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

关于在商店中激活产品分期

在需要在产品页面上显示分期的需求下，以下模块可能满足您的需求

https://www.magentocommerce.com/magento-connect/preco-parcelado-1.html

该模块可以通过composer安装

要使用composer安装模块，请在项目根目录中执行以下命令

composer require connect20/franciscoprado_precoparcelado

模块安装后应做什么？

在

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

创建一个测试账户，其中将提供您的MerchantId和MerchantKey

在方法中配置您的MerchantId和MerchantKey

进行测试

如果显示了完成页面，则表示您的交易已处理

向Cielo发送电子邮件，请求对该集成进行认证，并请求用于生产环境的数据

在电子邮件主题中填写“店铺编号：??? / 名称：??? / 关于：???"

Cielo应发送包含相应程序的电子邮件

不要在发送给Cielo的电子邮件中包含签名和标志，因为这可能会被阻止

电子邮件正文必须是白色的，仅包含认证交互

发送电子邮件后30分钟内，请打电话确认他们是否收到了电子邮件

Cielo在电话确认电子邮件时请求的数据（店铺编号、名称和CNPJ）

如何更改方法图像

可以添加以下任何一种命名的图像

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://www.cielo.com.br/wps/portal/Home/internas/desenvolvedores/

https://developercielo.github.io/Webservice-3.0/

https://developercielo.github.io/Checkout-Cielo/

纳税人

Mozg 团队

许可证

商业许可证

徽章

🐈

mozgbrasil / magento-cielo-php55

维护者

详细信息

README

Mozg\Cielo

概述

演示

动机

支持/疑问

价格

模块有哪些功能

技术特性

设置Cron

安装 - 更新 - 卸载 - 禁用

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

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

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

要禁用模块

如何配置支付方式

Cielo API 3.0 - 默认设置

必要的设置

• 测试模式或生产模式

• 测试环境Merchant ID

• 测试环境Merchant Key

• 生产环境Merchant ID

• 生产环境Merchant Key

• Cielo Checkout Merchant ID

高级：处理订单的Magento

• 订单状态：订单创建

• 订单状态：支付授权

• 订单状态：支付确认

• 订单状态：订单取消

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

• 订单状态：已退款

• 订单状态：部分退款

• 订单状态：待处理

• 创建挂账发票（仅适用于手动捕获）

• 捕获类型

• 订单状态：在发货时捕获

• 激活取消订单

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

• 发票电子邮件

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

• 激活调试日志

高级：Cielo 通知

• 忽略退款通知

高级：结账体验

• 取消支付后重定向目的地

• 支付方法渲染方法

• 本地语言（可选）

• ISO 国家代码（可选）

天际信用卡

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 信用卡类型

• 可见性

• 认证

• 欺诈分析

• 激活分期付款

• 默认分期

• 总体总额为零时禁用

天翼借记卡

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 借记卡类型

• 可见性

• 总体总额为零时禁用

天翼汇票

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 汇票类型