mozgbrasil/magento-bancodobrasil-php_72

与巴西银行集成

dev-master 2019-04-05 01:37 UTC

This package is auto-updated.

Last update: 2024-09-05 17:04:28 UTC


README

valid XHTML

Mozg\Bancodobrasil

简介

Bancodobrasil 电子商务集成

动机

满足 Magento 模块市场的需求,提供改进和优秀的支持

演示

Clique para visualizar o vídeo

支持/疑问

为了获得适当的支持,请点击此处,尽可能详细地说明问题发生的原因,并附上屏幕截图以便我们理解

价格

点击此处

模块资源

  • [✓] 交易
  • [✓] 查询

技术特性

如视频演示所示

在成功页面发送信息到银行

通过 CRON 应处理交易通知

在处理通知时,如果付款已确认,则应将订单的 "state/status" 改为 "processing",即 "处理中",以便执行处理账单和发货的操作

在发货之前,始终检查订单信息,如果显示交易状态已确认付款,包括与金融机构的确认,如果存在不一致的情况,则必须取消订单直到问题得到纠正

当订单发货时,状态将变为 "complete",即 "完成"。

实现了每5分钟查询一次交易状态以更新订单状态的自动化

设置 CRON

为了使用该方法,需要为 CRON 启用 Magento

点击此处 查看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”可以读取这种加密类型

https://raw.githubusercontent.com/mozgbrasil/heroku-magento/master/phpinfo-ioncube-encoder10-x86-64-php_72.php

--

要使用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

--

要停用模块

  1. 在执行任何涉及更新Magento的过程之前,必须保持Compiler和Cache未激活状态

  2. 如果您想停用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团队

许可

商业许可

徽章

Join the chat at https://gitter.im/mozgbrasil Latest Stable Version Total Downloads Latest Unstable Version License Monthly Downloads Daily Downloads Reference Status Dependency Status

🐈