mozgbrasil / magento-itau-php_56
与 Itau 集成
Requires
This package is auto-updated.
Last update: 2024-09-05 17:04:23 UTC
README
Mozg\Itau
简介
与 Itaú Shopline 集成
动机
满足 Magento 模块市场，提供改进和优质支持
演示
支持/疑问
要获得适当支持，请点击此处，尽可能详细地报告发生的原因，并附上屏幕截图以便理解
价格
模块资源
- [✓] 交易
- [✓] 查询
技术特性
在结账时进行授权流程
在成功页面发送信息到交易通知资源
通过 CRON 应处理交易通知
在处理通知时，如果支付已确认，应将订单的 "state/status" 改为 "processing"，即 "处理中"，以便处理账单和发货
在发货前，始终检查订单信息，如果显示交易状态为已确认支付，包括金融运营商是否已捕获交易，如果存在不一致，则必须取消订单直到问题得到纠正
订单发货时，状态将更改为 "complete"，即 "完成"
已实现每5分钟查询一次交易状态的自动化，以更新订单状态
设置 CRON
点击此处 查看MOZG的文档
确保每分钟执行一次该操作
该模块使用cronjob处理通知
模块执行至少5分钟前收到的通知
在Heroku上进行测试
我想展示我为Heroku平台提供的应用程序
只需单击一次，应用程序即可创建使用电子商务平台 Magento 的虚拟商店并安装MOZG模块
https://github.com/mozgbrasil/heroku-magento#描述
安装 - 更新 - 卸载 - 禁用
--
建议“打印”所有执行步骤的屏幕
如有任何困难，请将屏幕图像发送给我们
--
此模块旨在使用 Composer 安装
在终端中执行以下命令，以查看Composer及其版本是否存在
composer --version
如果环境中没有Composer，建议阅读以下文章 点击此处
--
服务器需要支持 ionCube PHP Loader 扩展
要查看该环境中名为PHP CLI的扩展是否存在，请在终端中执行以下命令
php -v
要查看该扩展是否在PHP WEB环境中激活在您的服务器上
请确认您的项目根目录下存在phpinfo.php文件
<?php phpinfo(); ?>
如果您的项目根目录中没有phpinfo.php文件，请创建一个，并添加上述内容
通过浏览器访问该文件
然后搜索“ionCube PHP Loader”这个词
如果您的服务器不支持这个扩展，请联系您的托管公司，让他们激活这个扩展
如果您有权限并且想要激活这个扩展，请点击这里
在“Loader Downloads API”中，下载与您的服务器兼容的包
解压缩包，然后将loader-wizard.php文件上传到您的服务器上，它会展示激活扩展的步骤
点击这里查看执行过程
--
如果存在“ionCube PHP Loader”，请下载以下文件并将其放置在服务器根目录下，然后访问，如果它工作正常，则表示“ionCube”正在读取这种加密类型
--
要使用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-itau-php_56:dev-master
您可以通过访问后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
要更新模块，请使用以下命令在服务器的项目目录的终端中执行
在进行任何涉及更新Magento的过程之前，建议您禁用Compiler和Cache
composer update
发生错误时，请将/vender/mozgbrasil文件夹重命名，然后重新执行
要检查模块的日期，请执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
要卸载模块，请使用以下命令在服务器的项目目录的终端中执行
composer remove mozgbrasil/magento-itau-php_56
--
要禁用模块
-
在进行任何涉及更新Magento的过程之前，必须保持Compiler和Cache禁用
-
如果您想禁用MOZG的模块，请重命名以下文件夹app/code/local/Mozg
禁用模块可以用来检测某些问题是否与模块相关
如何配置支付方式
要配置支付方式，请访问后端
STORES -> Configuration -> Sales/Payment Methods -> Itau (powered by MOZG)
您将看到以下字段
Itau标准配置
必要的配置
• 公司代码
要获取公司代码，请访问Itaú的网上银行
收款 > Itaú Shopline > 注册信息
• 加密密钥
要获取加密密钥，请访问Itaú的网上银行
收款 > Itaú Shopline > 注册信息
高级：处理Magento订单
• 订单状态：创建订单
新创建的订单状态，在操作员的服务器通知支付结果确认之前
• 订单状态：支付授权
操作员授权通知确认后的订单状态
• 订单状态：支付确认
操作员授权通知确认后的订单状态
• 订单状态：订单取消
操作员取消通知确认后的订单状态
如果订单已经开票，则无法取消
• 订单状态：支付捕获（虚拟产品）
仅选择分配给已完成状态的订单状态，留空以使用与普通产品相同的设置
• 订单状态：已退款
操作员退款通知确认后的订单状态
• 订单状态：部分退款
操作员部分退款通知确认后的订单状态。建议不要设置此状态，让Magento决定状态。
• 订单状态：待处理订单
操作员待处理通知后的订单状态
• 捕获类型
在需要执行CRON执行的自动化通知处理时，应选择“自动”选项
在需要手动捕获交易时，应选择“手动”选项，该操作通过访问发票并单击“捕获”按钮执行
• 创建待处理的账单（仅适用于手动捕获）
如果收到授权通知，则会创建待处理的账单。
注意：这将在创建账单后使Magento将所有订单推送到“处理”状态，忽略所有其他设置。
• 发货时捕获
如果您启用此功能，则在进行发货时将向操作员发出捕获请求
• 激活取消订单
如果由于某些原因取消订单，但收到支付已授权的通知，则将自动取消订单
• 订单取消时的自动退款/退款
启用/禁用取消订单时的自动退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用订单状态更新电子邮件
• 启用调试日志
应在var/log/存储模块的过程
文件
DATE_mozg.log
这是模块的日志，是一个包含所有过程的更详细日志，包括由模块的外部库执行的操作
文件
payment_METHOD.log
高级：Itau 通知
• 忽略退款通知
如果退款在操作员处完成，并且操作员向Magento发送退款通知，则将自动创建信用memo。如果您将此配置设置为“是”，则不会发生此操作，因为它不会处理收到的任何退款通知。
高级：结账体验
• 取消支付后的重定向目标
确定买家在取消支付后如何重定向。
• 支付方式渲染方法
确定是否以支付方式的标志或仅以名称显示支付方式。
• 本地语言（可选）
这会替换掉Magento存储的默认客户位置。
留空以让Magento决定（例如：nl_NL）
• ISO国家代码（可选）
这将替换购买者收货地址中的国家，以确定显示哪些支付方式。
伊塔乌Shopline
• 激活
用于“激活”或“禁用”该方法的
• 显示顺序
这是在订单结算步骤中显示的配送方式顺序
• 标题
要显示的支付方式名称
• 适用于国家的支付方式
您可以选择该方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应适用的国家
• 到期日（天数）
通过此功能可以设定汇票到期日的时间（天数）
• 附加说明（1）
可用于发送每笔订单的唯一消息行，仅当“说明”字段包含文本3时才会显示。
• 附加说明（2）
可用于发送每笔订单的唯一消息行，仅当“说明”字段包含文本3时才会显示。
• 附加说明（3）
可用于发送每笔订单的唯一消息行，仅当“说明”字段包含文本3时才会显示。
• 说明
可用于发送每笔订单的唯一消息行或指示要显示哪个附加消息（1）的参数。
发送
-
一条消息或
-
1 显示附加消息1或
-
2 显示附加消息2或
-
3 显示在“ObsAdicional1”、“ObsAdicional2”和“ObsAdicional3”字段中发送的3条附加消息。
附加消息1（参数1）- 在汇票开具和重新开具（如果有）时显示的预存标准消息，必须在伊塔乌Shopline模块的信息登记屏幕的“附加消息1”项中注册。
附加消息2（参数2）- 在汇票开具和重新开具（如果有）时显示的预存标准消息，必须在伊塔乌Shopline模块的信息登记屏幕的“附加消息2”项中注册。
附加消息3（参数3）- 每笔订单的唯一消息，将在汇票开具和重新开具（如果有）时显示，并应在“ObsAdicional1”、“ObsAdicional2”和“ObsAdicional3”字段中发送。
• 未支付订单状态
通过汇票可以支付少于总额的金额。如果适用，请在此处选择状态。如果留空，它将采用默认的已授权支付订单状态。
• 支付超额订单状态
通过汇票可以支付多于总额的金额。如果适用，请在此处选择状态。如果留空，它将采用默认的已授权支付订单状态。
• 可见性
确定在Magento的前端和/或后端中显示此支付方式
常见问题“FAQ”
如何更改方法图像
可以添加包含以下任一名称的图像
- method-bankline.png
- method-boleto.png
并将图像添加到您的模板目录中
/skin/frontend//default/images/mozg_itau
伊塔乌系统返回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”属性并应用适当的验证。
错误：“处理过程中出现问题，请稍后再试。（错误 08）SOS - Itaú Bankline”
应分析日志以查看发送到ItauShopLine的参数，如果未向Itaú发送必填信息，则应显示错误08。
错误：“加密问题或值字段不正确。请联系SOS Itaú Bankline。SOS - Itaú Bankline”
错误与加密密钥相关。
生成加密密钥后，需要24小时才能传播。
建议等待传播期限后再尝试。
如果问题持续存在，建议联系Itaú并指出发生的情况。
错误：“支票日期或值与原始记录不同”
如果Itaú系统中已存在与当前交易相同的订单编号，则会显示此错误返回。
一个可能的解决方案是增加订单ID。
https://github.com/aligent/Magento_SetStartOrderNumber
--
订单完成时，100000112被发送到Itaú作为订单参数00000112。
--
假设过去已经使用订单编号113与Itaú生成了交易。
如果现在再次尝试使用订单编号00000113创建订单，应返回错误。
--
注释
支付交易过程在Itaú系统中完成，并在弹窗中打开。
除在ItauShopLine手册中说明外
在ItauShopLine的HTML主体中还会发送信息到打开弹窗的页面
使用此支付方式必须使用弹窗
如果用户的浏览器启用了弹出窗口阻止功能，则会显示一个“警告”，引导用户点击以自动解锁弹出窗口。
联系信息 - Itau
企业运营支持
0300 100 7575
operemp@itau-unibanco.com.br
Itaú-Unibanco S.A.银行
或访问
要联系Itau
手册
http://download.itau.com.br/downloadcenter/arquivos/Manual_Tecnico_ItauShopline.pdf
纳税人
Mozg团队
许可
徽章
🐈