mozgbrasil / magento-bancodobrasil-php_72
与巴西银行集成
Requires
- mozgbrasil/magento-payment-php_72: dev-master
This package is auto-updated.
Last update: 2024-09-05 17:04:28 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(); ?>
如果项目根目录中没有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_72: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_72
--
要停用模块
-
在执行任何涉及更新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发送退款通知,则将自动创建一个贷项通知。如果您将此配置设置为“是”,则不会发生此情况,因为它不会处理接收到的任何退款通知。
高级:结账体验
• 取消支付后的重定向目标
确定买家在取消支付后的重定向方式。
• 支付方式渲染方法
确定支付方式是否以其徽标或仅以名称显示。
• 本地语言(可选)
这将替换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团队
许可
徽章
🐈