README

Mozg\Itau

简介

集成到Itaú Shopline

演示

动机

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

支持/疑问

要获得适当的支持，请点击这里，尽可能详细地说明发生的原因，并附上屏幕截图以便我们理解

价格

点击这里

模块有哪些功能

• [✓] 交易
• [✓] 查询

技术特性

在结账时进行授权过程

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

通过CRON处理交易通知，如果付款被确认，则应将订单状态更改为“处理中”，释放处理账单和发货的操作

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

设置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 更新之前，始终保持编译器和缓存处于禁用状态。

--

请确认您的项目根目录中存在 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-itau-php55:dev-master

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

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

--

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

在进行任何涉及 Magento 更新的过程之前，建议保持编译器和缓存处于禁用状态。

composer clear-cache && composer update

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

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

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

--

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

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

--

要禁用模块

1. 在进行任何涉及 Magento 更新的过程之前，必须保持编译器和缓存处于禁用状态。

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

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

如何配置支付方式

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

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

您将看到以下字段

伊塔乌标准配置

必需的配置

• 公司代码

要获取公司代码，请访问伊塔乌的网上银行

收款 > 伊塔乌 Shopline > 注册信息

• 加密密钥

要获取加密密钥，请访问伊塔乌的网上银行

收款 > 伊塔乌 Shopline > 注册信息

高级：Magento 订单处理

• 订单状态：创建订单

新创建的订单状态，在操作者的服务器通知确认支付结果之前。

• 订单状态：支付授权

经过操作者授权通知确认的授权支付订单状态。

• 订单状态：支付确认

经过操作者授权通知确认的支付订单状态。

• 订单状态：订单取消

经过操作者取消通知确认的订单状态。

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

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

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

• 订单状态：退款

经过操作者退款通知确认的退款订单状态。

• 订单状态：部分退款

经过操作者部分退款通知确认的部分退款订单状态。我们建议不要定义此状态，让 Magento 决定状态。

• 订单状态：待处理订单

经过操作者待处理通知的订单状态。

• 捕获类型

立即捕获是默认设置。

如果您想稍后手动执行资金捕获，请将其设置为手动。

• 创建待处理发票（仅限手动捕获）

如果收到授权通知，这将创建一个待处理发票。

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

• 订单状态：捕获发货

如果您启用此功能，则在发货时将向操作员发出捕获请求。

• 启用取消订单

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

• 订单取消时自动退款

启用/禁用取消订单时自动退款

• 发票电子邮件

启用/禁用电子邮件更新

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

启用/禁用客户订单状态更改更新电子邮件

• 启用调试日志

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

文件

DATE_mozg.log

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

文件

payment_METHOD.log

高级：Itau通知

• 忽略退款通知

如果退款在操作员处完成，并且操作员向Magento发送退款通知，则将自动创建一张信用凭证。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理收到的任何退款通知。

高级：结账体验

• 取消后重定向目标

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

• 支付方式渲染方法

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

• 本地语言（可选）

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

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

• ISO国家代码（可选）

这将替换在确定显示哪些支付方式时使用的买家发票地址的国家。

Itaú Shopline

• 启用

用于“启用”或“禁用”方法的使用

• 显示顺序

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

• 标题

应显示的方法名称

• 适用于国家的支付方式

您可以为“所有国家接受”或“指定国家”定义方法是否应该工作

• 特定国家的支付方式

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

• 到期日（天数）

通过此功能可以规定汇票到期日为天数

• 附加说明（1）

可用于为每个订单发送唯一消息行，仅在附加说明字段包含文本3时显示。

• 附加说明（2）

可用于为每个订单发送唯一消息行，仅在附加说明字段包含文本3时显示。

• 附加说明（3）

可用于为每个订单发送唯一消息行，仅在附加说明字段包含文本3时显示。

• 附加说明

可用于为每个订单发送唯一消息行或一个指示要显示哪个附加消息（1）的参数。

发送

• 一条消息行或

• 1以显示附加消息1或

• 2以显示附加消息2或

• 3以显示在ObsAdicional1、ObsAdicional2和ObsAdicional3字段中发送的3行附加消息。

附加信息1（参数1） – 在发票的发出和重发（如果有）时将显示的预存标准信息，并应记录在Itaú Shopline模块的“个人信息”页面中的“附加信息1”项。

附加信息2（参数2） – 在发票的发出和重发（如果有）时将显示的预存标准信息，并应记录在Itaú Shopline模块的“个人信息”页面中的“附加信息2”项。

附加信息3（参数3） – 每个订单显示的唯一信息，将在发票的发出和重发（如果有）时显示，并应在ObsAdicional1、ObsAdicional2和ObsAdicional3字段中发送。

• 未付款订单状态

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

• 超额付款订单状态

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

• 可见性

确定在Magento的前端和/或后端中显示此支付方式的方法

常见问题“FAQ”

如何更改方法图像

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

• method-bankline.png
• method-boleto.png

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

/skin/frontend//default/images/mozg_itau

返回到Itaú系统的URL

返回URL应包含一个安全的页面，用于显示您的商店的成功页面。

例如：https://www.minhaloja.com.br/mozg_itau/process/success/

依赖项

为了ItauShopLine产品的完美运行。

需要发布如“街区”和“文件”（CPF/CNPJ）等信息。

Magento中的客户注册表单应包含这些字段的适当验证。

Magento客户注册表单中的“街区”字段对应于“billing:street2”，建议应用适当的验证。

Magento客户注册表单中的“tax_vat”属性通常用于存储“CPF/CNPJ”，建议启用“tax_vat”属性并应用适当的验证。

ERROR: “处理问题，稍后再试。（错误08）SOS - Itaú Bankline”

应分析日志以查看发送到ItauShopLine的发送参数，如果未向Itaú发送必填信息，则显示错误08

ERROR: “加密问题或金额字段不正确。请联系SOS Itaú Bankline。SOS - Itaú Bankline”

错误与加密密钥相关

生成加密密钥后，需要24小时才能传播

建议等待传播期限后再尝试

如果问题持续存在，建议联系Itaú并指出问题

备注

支付交易过程是在Itaú系统中进行的，并在弹出窗口中打开。

除了在ItauShopLine手册中

在ItauShopLine的HTML主体中也向打开弹出窗口的页面发送信息

对于此支付方式，必须使用弹出窗口

如果用户的浏览器启用了弹出窗口阻止功能，则将显示“警告”，引导用户进行自动解锁弹出窗口的点击。

联系信息 - Itau

企业支持运营
0300 100 7575
operemp@itau-unibanco.com.br
Banco Itaú-Unibanco S.A.

或访问

要联系 Itau，请

手册

http://download.itau.com.br/downloadcenter/arquivos/Manual_Tecnico_ItauShopline.pdf

贡献者

Mozg 团队

许可证

商业许可证

徽章

🐈