搜索mozgbrasil / magento-itau-php_54
与 Itau 集成
Requires
This package is auto-updated.
Last update: 2024-09-05 18:00:35 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#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_54:dev-master
您可以通过进入后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
要更新模块，请在您的服务器终端的您的项目目录中执行以下命令
在执行任何涉及更新Magento的过程之前，建议您保持编译器和缓存停用
composer update
在发生错误时，将/vender/mozgbrasil文件夹重命名并再次执行
要检查模块的日期，请执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
要卸载模块，请在您的服务器终端的您的项目目录中执行以下命令
composer remove mozgbrasil/magento-itau-php_54
--
要停用模块
-
在执行任何有关更新Magento的操作之前，需要保持编译器和缓存停用
-
如果您想停用MOZG的模块，请重命名以下文件夹app/code/local/Mozg
模块的停用可以用来检测特定事件是否与模块有关
如何配置支付方式
要配置支付方式，请在后端进入
STORES -> Configuration -> Sales/Payment Methods -> Itau (powered by MOZG)
您将看到以下字段
巴西银行配置
所需配置
• 公司代码
要获取公司代码，请访问巴西银行的网上银行
收据 > 巴西银行Shopline > 注册信息
• 加密密钥
要获取加密密钥，请访问巴西银行的网上银行
收据 > 巴西银行Shopline > 注册信息
高级：处理订单
• 订单状态：创建订单
新创建的订单状态，在运营商服务器通知支付结果确认之前
• 订单状态：支付授权
运营商授权通知确认后的订单状态
• 订单状态：支付确认
运营商授权通知确认后的订单状态
• 订单状态：订单取消
运营商取消通知确认后的订单状态
如果订单已经开票，则不能取消
• 订单状态：支付捕获（虚拟产品）
仅选择分配给已完成状态的订单状态，留空使用与普通产品相同的设置
• 订单状态：已退款
运营商退款通知确认后的订单状态
• 订单状态：部分退款
运营商部分退款通知确认后的订单状态。建议不要设置此状态，让Magento决定状态。
• 订单状态：待处理订单
运营商待处理通知后的订单状态
• 捕获类型
需要使用此自动化进行CRON处理的通知处理时，应选择“自动”选项
需要手动捕获交易时，应选择“手动”选项，该操作通过访问订单发票并单击“捕获”按钮完成
• 创建挂起的发票（仅适用于手动捕获）
如果收到授权通知，则会创建一个挂起的发票。
注意：一旦创建发票，这将使Magento将所有订单推送到“处理”状态，忽略所有其他设置。
• 订单状态：发货时捕获
如果您启用此功能，则在您发货时将向运营商发出捕获请求
• 启用取消订单
如果订单因某些原因被取消，但收到支付已授权的通知，则将自动取消订单
• 取消订单时的自动退款/退款
启用/禁用取消订单时的自动退款
• 发票电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用所有订单状态变更的更新电子邮件以供客户查看
• 启用调试日志
模块进程应存储在var/log/
文件
DATE_mozg.log
这是模块日志，是一个更详细的日志，包含所有进程，包括由模块外部库执行的执行
文件
payment_METHOD.log
高级：Itau 通知
• 忽略退款通知
如果退款在运营商完成，并且运营商向Magento发送退款通知，则将自动创建一个信用额度。如果您将此配置设置为“是”，则不会发生此情况，因为它不会处理接收到的任何退款通知。
高级：结账体验
• 取消支付后的重定向目标
确定购买者在取消支付后如何重定向。
• 支付方式渲染方法
确定支付方式是否以其徽标或仅以名称显示。
• 本地化语言（可选）
这将以默认的存储客户位置替换Magento的默认客户位置。
留空让Magento决定（例如：nl_NL）
• ISO 国家代码（可选）
这将替换在确定显示哪些付款方式时，买家的账单地址国家。
伊塔乌商线
• 激活
用于“激活”或“禁用”该方法的使用
• 显示顺序
这是在订单关闭步骤中交付方式显示的顺序
• 标题
应显示的该方法的名称
• 适用于国家的付款方式
您可以定义该方法是否应对“所有接受的国家”或“指定国家”起作用
• 特定国家的付款方式
您必须选择该方法应该在其上起作用的国家
• 到期日（天数）
通过此功能，您可以设定汇票到期日的天数
• 附加说明（1）
可用于为每个订单发送唯一消息行，但仅在观察字段包含文本3时才会显示。
• 附加说明（2）
可用于为每个订单发送唯一消息行，但仅在观察字段包含文本3时才会显示。
• 附加说明（3）
可用于为每个订单发送唯一消息行，但仅在观察字段包含文本3时才会显示。
• 观察
可用于为每个订单发送唯一消息行或指示要显示哪个附加消息（1）的参数。
发送
-
一条消息或
-
1以显示附加消息1或
-
2以显示附加消息2或
-
3以显示在ObsAdicional1、ObsAdicional2和ObsAdicional3字段中发送的3条附加消息的行。
附加消息1（参数1）- 预先注册的默认消息，将在汇票发行和重新发行时显示（如果有的话），并应在伊塔乌商线模块的个人信息屏幕上的附加消息1项中注册。
附加消息2（参数2）- 预先注册的默认消息，将在汇票发行和重新发行时显示（如果有的话），并应在伊塔乌商线模块的个人信息屏幕上的附加消息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产品。
需要发布有关BAIRRO和DOCUMENTO（CPF/CNPJ）的信息。
在Magento中的客户注册表单中应包含这些字段的适当验证。
在Magento的客户注册表单中，BAIRRO字段是“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团队
许可证
徽章
🐈