mozgbrasil / magento-bancodobrasil-php_56
Bancodobrasil 集成
Requires
This package is auto-updated.
Last update: 2024-09-05 17:03:14 UTC
README
Mozg\Bancodobrasil
简介
与 Bancodobrasil 电子商务集成
动机
满足 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(); ?>
如果您的Magento项目根目录下不存在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-bancodobrasil-php_56: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-bancodobrasil-php_56
--
要禁用模块
-
在进行任何涉及更新Magento的过程之前,需要保持Compiler和Cache被禁用
-
如果您想禁用MOZG的模块,请重命名以下文件夹app/code/local/Mozg
禁用模块可以用来检测特定事件是否与模块有关
如何配置支付方式
要配置支付方式,请访问后端
STORES -> Configuration -> Sales/Payment Methods -> Bancodobrasil (powered by MOZG)
您将看到以下字段
巴西银行电子商务 - 标准设置
必要的设置
• 测试模式或生产模式
应提供相应的环境
• 电子商务协议代码
电子商务协议代码
• 电子商务收费代码
电子商务收费代码
• 到期日(天数)
到期日(天数)
• 注意
注意
• 将生成汇票的标题类型
将生成汇票的标题类型
高级:Magento订单处理
• 订单状态:创建订单
新创建订单的状态,在运营商服务器通知支付结果确认之前
• 订单状态:支付授权
运营商授权通知确认后的订单状态
• 订单状态:支付确认
运营商授权通知确认后的订单状态
• 订单状态:取消订单
运营商取消通知确认后的订单状态
如果订单已经开票,则不能取消
• 订单状态:支付捕获(虚拟产品)
仅选择分配给完成状态的属性,留空则与普通产品相同
• 订单状态:已退款
运营商退款通知确认后的订单状态
• 订单状态:部分退款
运营商部分退款通知确认后的订单状态。建议不要定义此状态,让Magento决定状态。
• 订单状态:挂起订单
运营商挂起通知后的订单状态
• 捕获类型
需要使用此自动化处理通知(通过CRON执行)时,必须选择“自动”选项
需要手动捕获交易时,必须选择“手动”选项,通过访问订单账单并单击“捕获”按钮执行此操作
• 创建挂起的账单(仅限手动捕获)
如果收到授权通知,这将创建一个挂起的账单。
注意:一旦创建账单,这将使Magento将所有订单推送到“处理”状态,忽略所有其他设置。
• 订单状态:发货时捕获
如果您启用此功能,则在您发货时将向运营商发出捕获请求
• 激活取消订单
如果订单因某种原因被取消,但收到支付已授权的通知,这将自动取消订单
• 取消订单时的自动退款/退款
激活/取消取消订单时的自动退款
• 账单电子邮件
激活/取消电子邮件更新
• 发送订单状态通知电子邮件
激活/取消对客户订单状态的所有更改的电子邮件更新
• 激活调试日志
应将模块进程存储在var/log/
文件
DATE_mozg.log
这是模块的日志,是一个包含所有进程的详细日志,包括模块外部库执行的执行
文件
payment_METHOD.log
高级:巴西银行通知
• 忽略退款通知
如果退款在运营商处进行,并且运营商向Magento发送退款通知,则将自动创建一个贷项通知。如果您将此配置设置为“是”,则不会发生这种情况,因为它不会处理接收到的任何退款通知。
高级:结账体验
• 取消支付后的重定向目标
确定在取消支付后如何将买家重定向。
• 支付方式渲染方法
确定支付方式是否以logo或仅以名称显示。
• 本地语言(可选)
这将替换Magento存储中的默认客户位置。
留空以让Magento决定(例如:nl_NL)
• ISO国家代码(可选)
这将替换购买者账单地址的国家以确定显示哪些支付方式。
巴西银行(所有选项)
• 启用
用于“启用”或“禁用”该方法的用途
• 显示顺序
这是在订单结算步骤中显示的送货方式顺序
• 标题
应显示的该方法名称
• 适用于国家的支付方式
您可以定义该方法是否应适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应适用的国家
巴西银行汇票
• 启用
用于“启用”或“禁用”该方法的用途
• 显示顺序
这是在订单结算步骤中显示的送货方式顺序
• 标题
应显示的该方法名称
• 适用于国家的支付方式
您可以定义该方法是否应适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应适用的国家
巴西银行汇票
• 启用
用于“启用”或“禁用”该方法的用途
• 显示顺序
这是在订单结算步骤中显示的送货方式顺序
• 标题
应显示的该方法名称
• 适用于国家的支付方式
您可以定义该方法是否应适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应适用的国家
• 未付款订单状态
使用汇票可以支付低于总金额的金额。如果适用,请在此选择状态。如果您留空,它将默认为支付授权订单状态
• 超额付款订单状态
使用汇票可以支付高于总金额的金额。如果适用,请在此选择状态。如果您留空,它将默认为支付授权订单状态
• 可见性
确定此支付方式在Magento前端和/或后端的可见性
巴西银行电子转账
• 启用
用于“启用”或“禁用”该方法的用途
• 显示顺序
这是在订单结算步骤中显示的送货方式顺序
• 标题
应显示的该方法名称
• 适用于国家的支付方式
您可以定义该方法是否应适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应适用的国家
• 未付款订单状态
使用汇票可以支付低于总金额的金额。如果适用,请在此选择状态。如果您留空,它将默认为支付授权订单状态
• 超额付款订单状态
使用汇票可以支付高于总金额的金额。如果适用,请在此选择状态。如果您留空,它将默认为支付授权订单状态
• 可见性
确定此支付方式在Magento前端和/或后端的可见性
常见问题解答(FAQ)
安装模块后做什么?
在方法中配置您的协议代码并启用该方法
进行测试
如果显示最终页面,则表示已处理您的交易
注意。
Para boleto não é possivel efetuar a consultar da transação, devendo ser processada fatura manualmente
模拟
我们可以在
http://loja.cerebrum.com.br/vendor/mozgbrasil/php-framework-php_56/examples/bb/Transacao.php
提供信息后
idConv: ???
refTran:
在点击“汇票”选项时返回
CPF do pagador nao encontrado na base. (C008-000)
我更改了参数为
indicadorPessoa: 2
cpfCnpj: 59.729.997/0001-68
在点击“汇票”选项时返回
CPF/CNPJ não informado para cobrança registrada (C031-000)
我更改了参数为
indicadorPessoa: 2
cpfCnpj: 16619423000124
在点击“汇票”选项时返回
CNPJ pagador informado inexistente. (C008-000)
我更改了参数为
indicadorPessoa: 2
cpfCnpj: 16619423000124
tpPagamento: 21
并显示了汇票
在模拟中进行了以下错误请求
UF informada no endereco pagador diferent (C008-000)
这是由于提供的CEP不是所在城市的信息
这是巴西银行的控件,因此系统需要良好的数据支持以防止使用不一致的数据
如何更改方法的图片
可以添加以下命名之一的图像
- method-boleto.png
- method-creditcard.png
- method-debitcard.png
- method-eletronictransfer.png
并将图像添加到您的模板目录中
/skin/frontend//default/images/mozg_bancodobrasil
注意事项
支付交易过程在巴西银行系统中完成,并在弹出窗口中打开。
如果用户的浏览器启用了弹出窗口阻止功能,将显示一个“警告”,引导用户点击以自动解锁弹出窗口。
联系方式 - 巴西银行
请拨打11 4004 0006,选择8,选择4,提供代理机构和账户,选择8,提供J密钥
报告发生的情况,应启动一个程序
可能需要将事件发送到电子邮件,suporte.clientes@bb.com.br,提供程序和事件
手册
http://bb.com.br/portalbb/page44,3766,2229,0,0,1,2.bb
贡献者
Mozg团队
许可证
徽章
🐈