搜索mozgbrasil / magento-bancodobrasil-php_71
与巴西银行集成
Requires
This package is auto-updated.
Last update: 2024-09-05 16:36:21 UTC
README
Mozg\Bancodobrasil
简介
与巴西银行电子商务集成
动机
为了满足Magento模块市场，提供改进和优秀的支持
演示
支持/疑问
要获取适当的支持点击此处，尽可能详细地报告发生的原因，并附上屏幕截图以便我们理解
价格
模块功能
- [✓] 交易
- [✓] 查询
技术特性
如视频演示所示
在成功页面向银行发送信息
通过CRON处理交易通知
在处理通知时，如果付款已确认，则应将订单的"state/status"更改为"processing"，即"处理中"，以允许处理账单和发货
在发货前，始终检查订单信息，如果交易状态显示付款已确认，包括与金融机构一起确认交易是否已被捕获，如果存在不一致的情况，则必须取消订单直到问题得到纠正
订单发货后，状态将更改为"complete"，即"完成"状态
已实施自动化，每5分钟查询一次交易状态以更新订单状态
设置CRON
点击此处查看MOZG文档
确保每分钟执行一次操作
此模块使用cronjob处理通知
模块执行至少5分钟前接收到的通知
在Heroku上测试
我想展示我为Heroku平台提供的应用程序
只需一键，应用程序即可创建使用电子商务平台Magento的虚拟商店并安装MOZG模块
https://github.com/mozgbrasil/heroku-magento#描述
安装 - 更新 - 卸载 - 禁用
--
建议“打印”包含所有执行步骤的屏幕截图
如果有任何困难，请将屏幕截图图像发送给我们
--
此模块旨在使用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_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-bancodobrasil-php_71
--
要禁用模块
-
在进行任何涉及 Magento 更新的过程之前，必须保持 Compiler 和 Cache 禁用状态
-
如果您想禁用MOZG的模块，请重命名以下文件夹app/code/local/Mozg
模块的禁用可以用来检测特定事件是否与模块有关
如何配置支付方式
要配置支付方式，请访问后端
STORES -> Configuration -> Sales/Payment Methods -> Bancodobrasil (powered by MOZG)
您将看到以下字段
巴西银行电子商务 - 默认配置
必要的配置
• 测试模式或生产模式
应提供相应环境的信息
• 电子商务公约代码
电子商务公约代码
• 电子商务收款代码
电子商务收款代码
• 到期日（天数）
到期日（天数）
• 注意
注意
• 将生成汇票的标题类型
将生成汇票的标题类型
高级：Magento订单处理
• 订单状态：创建订单
新创建的订单状态，在操作者服务器通知支付结果确认之前
• 订单状态：支付授权
操作者授权通知确认后的订单状态
• 订单状态：支付确认
操作者授权通知确认后的订单状态
• 订单状态：订单取消
操作者取消通知确认后的订单状态
如果订单已经开票，则无法取消
• 订单状态：支付捕获（虚拟产品）
仅选择分配给已完成状态的属性，留空以使用与普通产品相同的属性
• 订单状态：已退款
操作者退款通知确认后的订单状态
• 订单状态：部分退款
操作者部分退款通知确认后的订单状态。我们建议不要定义此状态，让Magento决定状态。
• 订单状态：待处理订单
操作者待处理通知后的订单状态
• 捕获类型
在需要使用此自动化处理通过CRON执行的通知时，必须选择“自动”选项
在需要手动捕获交易时，必须选择“手动”选项，此操作通过访问订单账单并点击“捕获”按钮执行
• 创建待处理账单（仅限手动捕获）
如果收到授权通知，这将创建一个待处理账单。
注意：这将在账单创建后将所有订单推送到“处理”状态，忽略所有其他设置。
• 订单状态：发货时捕获
如果您启用此功能，则在发货时将向操作者发出捕获请求
• 激活取消订单
如果由于某些原因取消订单，但收到支付已授权的通知，这将自动取消订单
• 订单取消时自动取消/退款
激活/取消取消订单时的自动退款
• 账单电子邮件
激活/取消电子邮件更新
• 发送订单状态通知电子邮件
激活/取消对所有订单状态更改的电子邮件更新，以供客户查看
• 激活调试日志
应将模块进程存储在var/log/
文件
DATE_mozg.log
这是模块的日志，是一个包含所有进程的详细日志，包括由模块的外部库执行的执行
文件
payment_METHOD.log
高级：Bancodobrasil通知
• 忽略退款通知
如果退款在操作者处完成，并且操作者向Magento发送退款通知，则将自动创建一个信用memo。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理接收到的任何退款通知。
高级：结账体验
• 取消后的目标重定向
确定在取消支付后买家如何被重定向。
• 支付方法渲染方式
确定支付方法是否以徽标或仅名称的形式显示。
• 本地语言（可选）
这将会替换掉 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)
这是因为输入的邮政编码不是输入的城市
这是巴西银行的控制，因此系统需要有良好的数据支持，以防止使用不一致的数据
如何更改方法图像
可以添加包含以下任一名称的图像
- 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 团队
许可
徽章
🐈