进行搜索mozgbrasil / magento-itau-php_72
与 Itau 集成
Requires
- dilneiss/itaubankline: *
- mozgbrasil/magento-payment-php_72: dev-master
This package is auto-updated.
Last update: 2024-09-05 17:07:20 UTC
README
Mozg\Itau
摘要
动机
满足 Magento 模块市场的需求，提供改进和优质的客户支持
演示
支持/疑问
为了获得适当的客户支持，请点击此处，尽可能详细地描述出现问题的原因，并附加屏幕截图以便我们理解
价格
模块资源
- [✓] 交易
- [✓] 查询
技术特性
在结账时进行授权过程
在成功页面发送信息到交易通知资源
通过 CRON 处理交易通知
在通知处理过程中，如果付款已确认，则应将订单的 "state/status" 修改为 "processing"，即 "处理中"，以便处理账单和发货
在发货商品之前，请始终检查订单信息，如果交易状态显示付款已确认，包括财务运营商是否已捕获交易，如果存在不一致，则必须取消订单直到问题得到纠正
当订单发货时，状态将更改为 "complete"，即 "完成"
已实现每5分钟进行一次交易状态查询以更新订单状态的自动化
设置 CRON
为了使用此方法，需要激活 Magento 的CRON
点击此处查看 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(); ?>
如果项目根目录中没有phpinfo.php文件，请创建该文件并添加上面的内容
通过浏览器访问该文件
然后搜索“ionCube PHP Loader”这个词
如果您的服务器不支持该扩展，请联系您的托管公司，让他们激活该扩展
如果您有权限并想激活该扩展，点击这里
在“Loader Downloads API”中，下载与您的服务器兼容的包
解压包，并将“loader-wizard.php”文件上传到您的服务器，它将展示激活扩展的步骤
点击这里查看执行过程
--
在存在“ionCube PHP Loader”的情况下，下载以下文件并将其放在服务器根目录下，然后访问它，如果它能正常运行，则表示“ionCube”正在读取这种加密类型
--
要使用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-php_72:dev-master
您可以通过进入后台检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
要更新模块，请在服务器的项目目录中执行以下命令
在进行任何涉及更新Magento的过程之前，建议关闭编译器和缓存
composer update
在出现错误时，将/vendor/mozgbrasil文件夹重命名，然后再次执行
要检查模块的日期，请执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
要卸载模块，请在服务器的项目目录中执行以下命令
composer remove mozgbrasil/magento-itau-php_72
--
要禁用模块
-
在进行任何涉及更新Magento的过程之前，需要保持编译器和缓存关闭
-
如果您想禁用MOZG的模块，请重命名以下文件夹app/code/local/Mozg
禁用模块可以用来检测某些问题是否与模块有关
如何配置支付方式
要配置支付方式，请访问后台
STORES -> Configuration -> Sales/Payment Methods -> Itau (powered by MOZG)
您将看到以下字段
伊塔乌配置
必要的配置
• 公司代码
要获取公司代码，请访问伊塔乌互联网银行
收款 > 伊塔乌Shopline > 注册信息
• 加密密钥
要获取加密密钥，请访问伊塔乌互联网银行
收款 > 伊塔乌Shopline > 注册信息
高级：处理订单
• 订单状态：创建订单
新创建的订单状态，在收到支付结果通知之前
• 订单状态：授权支付
已授权的订单状态，由运营商的授权通知确认
• 订单状态：支付确认
已确认的订单状态，由运营商的授权通知确认
• 订单状态：取消订单
订单取消确认后，由运营商发送的"CANCELAMENTO"通知后的订单状态
如果订单已开票，则无法取消
• 订单状态：支付抓取（虚拟产品）
仅选择分配给完成状态的订单状态，留空则使用与普通产品相同的设置
• 订单状态：已退款
运营商发送的"REEMBOLSO"通知确认后的退款订单状态
• 订单状态：部分退款
运营商发送的"REEMBOLSO_PARCIAL"通知确认后的部分退款订单状态。建议不定义此状态，让Magento决定状态。
• 订单状态：待处理订单
运营商发送的"PENDENCIA"通知后的订单状态
• 抓取类型
需要使用此自动化时，必须选择“自动”选项，该自动化应在通过CRON执行的执行通知时运行
需要手动抓取交易时，必须选择“手动”选项，此操作通过访问订单账单并单击“抓取”按钮完成
• 创建待处理账单（仅限手动抓取）
如果收到授权通知，将创建一个待处理账单。
注意：一旦创建账单，Magento会将所有订单推送到“处理”状态，忽略所有其他设置。
• 订单状态：装运时抓取
如果您启用此功能，则在发货时将向运营商发送抓取请求
• 激活取消订单
如果订单因某些原因被取消，但收到付款已授权的通知，则将自动取消订单
• 订单取消时的自动取消/退款
激活/停用取消订单时的自动退款
• 账单电子邮件
激活/停用电子邮件更新
• 发送订单状态通知电子邮件
激活/停用订单状态变更的所有更新电子邮件
• 激活调试日志
模块过程应存储在var/log/中
文件
DATE_mozg.log
这是模块的日志，是一个更详细的日志，包含所有过程，包括由模块的外部库执行的操作
文件
payment_METHOD.log
高级：Itau 通知
• 忽略退款通知
如果退款在运营商处完成，并且运营商向Magento发送退款通知，则将自动创建一个信用额度。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理接收到的任何REEMBOLSO通知。
高级：结账体验
• 取消支付后的重定向目标
确定付款取消后买家将被重定向的方式。
• 支付方式渲染方法
确定支付方式是否将显示其徽标或仅显示名称。
• 本地语言（可选）
这将以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”字段中发送。
• 未付款订单状态
通过Boleto支付可以支付少于总金额。如果适用，请在此处选择状态。如果您将其留空，它将采用默认的支付授权订单状态。
• 支付超过金额的订单状态
通过Boleto支付可以支付多于总金额。如果适用，请在此处选择状态。如果您将其留空，它将采用默认的支付授权订单状态。
• 可见性
确定此支付方式在前端和/或后端中的可见性。
常见问题“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 - 伊塔乌银行线”
应在日志中进行分析以查看发送给伊塔乌ShopLine的参数，如果未发送某些必填信息，则将显示错误08。
错误：“加密问题或值字段不正确。请联系SOS伊塔乌银行线。SOS - 伊塔乌银行线”
此错误与加密密钥有关
生成加密密钥后，该密钥需要24小时才能传播
建议等待传播期限，然后再次尝试
如果问题仍然存在，建议与伊塔乌银行联系，指明发生的情况
错误：\"支票数据或值与原始记录不同\"
如果伊塔乌银行系统中已经存在与当前交易相同的订单号，将显示此错误返回
一个可能的解决方案是递增订单ID
https://github.com/aligent/Magento_SetStartOrderNumber
--
在完成订单100000112时，将其作为订单参数00000112发送给伊塔乌
--
假设以前已经使用订单号113在伊塔乌生成了一笔交易
如果现在再次尝试使用订单号00000113创建订单，应该会返回错误
--
注意事项
支付交易过程是在伊塔乌银行系统中完成的，并在弹出窗口中打开。
除了在伊塔乌ShopLine手册中之外
伊塔乌ShopLine的自身HTML体中也会发送信息到打开弹出窗口的页面
使用此支付方法时，必须使用弹出窗口
如果用户的浏览器启用了弹出窗口阻止功能，将显示一个\"警告\"，诱导用户点击以自动解锁弹出窗口。
联系方式 - 伊塔乌
企业运营支持
0300 100 7575
operemp@itau-unibanco.com.br
伊塔乌-联合银行股份有限公司
或访问
要联系伊塔乌
手册
http://download.itau.com.br/downloadcenter/arquivos/Manual_Tecnico_ItauShopline.pdf
贡献者
Mozg团队
许可
徽章
🐈