搜索mozgbrasil / magento-itau-php_71
与Itau集成
Requires
This package is auto-updated.
Last update: 2024-09-05 16:47:02 UTC
README
Mozg\Itau
简介
动机
满足Magento模块市场的需求，提供改进和优秀的支持
演示
支持/疑问
为了获得适当的支持，请点击此处，尽可能详细地报告发生的原因，并附上屏幕截图以便我们理解
价格
模块资源
- [✓] 交易
- [✓] 查询
技术特性
在结账过程中进行授权流程
在成功页面发送信息到交易通知资源
通过CRON处理交易通知
在处理通知时，如果支付被确认，则应将订单的"state/status"更改为"processing"，即"处理中"，以释放处理账单和发货的操作
在发货商品之前，始终检查订单信息，如果显示交易状态表明支付已被确认，包括金融运营商是否捕获了交易，如果出现任何不一致，则必须取消订单，直到问题得到纠正
当订单发货时，状态会变为"complete"，即"完成"
实现了每5分钟查询一次交易状态以更新订单状态的自动化
设置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之前，请始终确保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_71:dev-master
您可以通过访问后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
为了更新模块，请在您的服务器上项目的目录中执行以下命令
在进行任何涉及更新Magento的过程之前，建议您保持Compiler和Cache处于禁用状态
composer update
在出现错误时，重命名/vendor/mozgbrasil文件夹并重新执行
为了检查模块的日期，执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
为了卸载模块，请在您的服务器上项目的目录中执行以下命令
composer remove mozgbrasil/magento-itau-php_71
--
为了禁用模块
-
在进行任何涉及更新Magento的过程之前，必须保持Compiler和Cache处于禁用状态
-
如果您想禁用MOZG的模块，请重命名以下文件夹app/code/local/Mozg
模块的禁用可以用来检测某个特定事件是否与模块有关
如何配置支付方式
要配置支付方式，请访问后端
STORES -> Configuration -> Sales/Payment Methods -> Itau (powered by MOZG)
您将看到以下字段
伊塔乌标准配置
必需的配置
• 公司代码
要获取公司代码，请访问伊塔乌的网上银行
收据 > 伊塔乌Shopline > 注册信息
• 加密密钥
要获取加密密钥，请访问伊塔乌的网上银行
收据 > 伊塔乌Shopline > 注册信息
高级：处理Magento订单
• 订单状态：创建订单
新创建的订单状态，在运营商服务器通知支付结果确认之前
• 订单状态：支付授权
运营商授权通知确认后的订单状态
• 订单状态：支付确认
运营商授权通知确认后的订单状态
• 订单状态：取消订单
运营商取消通知确认后的订单状态
如果订单已经开票，则无法取消
• 订单状态：支付捕获（虚拟产品）
仅选择分配给已完成状态的属性，留空则使用与普通产品相同的属性
• 订单状态：已退款
运营商退款通知确认后的订单状态
• 订单状态：部分退款
运营商部分退款通知确认后的订单状态。我们建议不要定义此状态，让Magento决定状态。
• 订单状态：待处理订单
运营商待处理通知后的订单状态
• 捕获类型
在需要使用此自动化处理通过CRON执行的通知时，应选择“自动”选项
在需要手动捕获交易时，应选择“手动”选项，该操作通过访问订单账单并点击“捕获”按钮完成
• 创建待处理账单（仅限手动捕获）
如果收到授权通知，则会创建待处理账单。
注意：这将在账单创建后将所有订单推送到“处理”状态，忽略所有其他设置。
• 订单状态：发货时捕获
如果您启用此功能，则在发货时将向运营商发送捕获请求
• 启用撤销订单
如果订单因某些原因被取消，但收到支付已授权的通知，则将自动撤销订单
• 取消订单时的自动退款/退款
启用/禁用取消订单时的自动退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用订单状态更改的电子邮件更新，以供客户查看
• 启用调试日志
应将模块进程存储在var/log/中
文件
DATE_mozg.log
这是模块日志，是一个更详细的日志，包含所有进程，包括模块外部库的执行过程
文件
payment_METHOD.log
高级：Itau通知
• 忽略退款通知
如果退款在运营商完成，并发出退款通知到Magento，将自动创建一个信用 memo。如果将此配置设置为“是”，则不会发生这种情况，因为它不会处理收到的任何退款通知。
高级：结账体验
• 取消支付后的重定向目标
确定付款取消后买家如何重定向
• 支付方式渲染方法
确定支付方式是否以其徽标或仅以名称显示
• 本地语言（可选）
这将替换默认的存储客户位置
留空以让 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 产品完美运行。
需要发布信息，如 BAIRO 和 DOCUMENTO（CPF/CNPJ）。
在Magento的客户注册表单中应包含这些字段的相应验证。
在Magento客户注册表单中，地址字段“BAIRRO”对应于“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完成后，作为订单参数00000112发送给Itaú
--
假设过去已使用订单号113与Itaú生成了一笔交易
如果现在再次尝试创建订单号00000113的订单，应返回错误
--
备注
支付交易过程在Itaú系统内完成，并在弹出窗口中打开。
除ItauShopLine手册外
在ItauShopLine的HTML主体中也向打开弹出窗口的页面发送信息
必须使用弹出窗口进行此支付方式
如果用户的浏览器启用了弹出窗口阻止功能，将显示一个“警告”，诱导用户点击以自动解锁弹出窗口。
联系方式 - Itau
企业支持
0300 100 7575
operemp@itau-unibanco.com.br
巴西伊塔乌联合银行股份有限公司
或访问
要联系Itau
手册
http://download.itau.com.br/downloadcenter/arquivos/Manual_Tecnico_ItauShopline.pdf
贡献者
Mozg团队
许可证
徽章
🐈