mozgbrasil / magento-bradesco-php_71

与Bradesco集成

1.0.0 2018-03-01 14:27 UTC

This package is auto-updated.

Last update: 2024-09-05 17:27:11 UTC


README

valid XHTML

Mozg\Bradesco

简介

Bradesco集成

动机

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

演示

Clique para visualizar o vídeo

支持/疑问

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

价格

点击这里

模块资源

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

技术特性

在结账时执行授权过程

在成功页面显示选择支付类型的窗口

通过CRON处理交易通知

在处理通知时,如果支付已确认,则应将订单的"状态/状态"更改为"processing",即"处理中",以释放处理账单和发货的操作

在发货之前,始终检查订单信息,如果显示交易状态为已确认支付,包括金融运营商是否捕获了交易,如果存在任何不一致,则必须取消订单,直到问题得到纠正

订单发货后,状态将更改为"complete",即"完成"}

已实施每5分钟查询交易状态以更新订单状态的自动化

设置Cron

使用此方法需要为Magento激活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”正在读取此类加密

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

--

要使用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-bradesco-php_71:dev-master

您可以通过访问后端来检查模块是否已安装

STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output

--

要更新模块,请在上一个项目目录的服务器终端中执行以下命令

在进行任何涉及更新Magento的过程之前,建议保持编译器和缓存关闭

composer update

如果出现错误,请将/vendor/mozgbrasil文件夹重命名,然后再次执行

要检查模块的日期,请执行以下命令

grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil

--

卸载模块,请在上一个项目目录的服务器终端中执行以下命令

composer remove mozgbrasil/magento-bradesco-php_71

--

要停用模块

  1. 在进行任何涉及更新Magento的过程之前,必须保持编译器和缓存关闭

  2. 如果您想停用MOZG的模块,请重命名以下文件夹 app/code/local/Mozg

模块的停用可以用来检测特定事件是否与模块相关

如何配置支付方式

要配置支付方式,请访问后端

STORES -> Configuration -> Sales/Payment Methods -> Bradesco (powered by MOZG)

您将看到以下字段

Bradesco支付方式 - 默认设置

必要的设置

测试模式或生产模式

必须指定相应的环境

测试环境的Merchant ID或"MID"

https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp

右上角有这个信息作为MID

测试环境的安全密钥

https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/meiopagamento/form

如果尚未定义,可以生成安全密钥

生产环境的Merchant ID

此信息应由Bradesco提供

生产环境的安全密钥

此信息应由Bradesco提供

高级:处理订单

订单状态:创建订单

新创建的订单状态,在支付结果通过运营商的服务器通知确认之前

订单状态:支付授权

运营商授权确认后的订单状态

订单状态:支付已确认

运营商授权确认后的订单状态

订单状态:订单取消

运营商取消确认后的订单状态

如果订单已开账,则不能取消

订单状态:支付捕获(虚拟产品)

仅选择分配给完成状态的订单状态,留空则使用与普通产品相同的设置

订单状态:已退款

运营商退款确认后的订单状态

订单状态:部分退款

运营商部分退款确认后的订单状态。建议不要定义此状态,让Magento决定状态。

订单状态:挂起订单

运营商挂起通知后的订单状态

捕获类型

需要使用此自动化时,应选择“自动”选项,该自动化应在通过CRON执行的通知处理过程中执行

需要手动捕获交易时,应选择“手动”选项,通过访问订单账单并点击“捕获”按钮执行此操作

创建挂起账单(仅限手动捕获)

如果收到授权通知,这将创建一个挂起账单。

注意:这将使Magento在创建账单后将所有订单推送到“处理”状态,忽略所有其他设置。

发货时捕获

如果启用此功能,则在发货时将向运营商发出捕获请求

激活取消订单

如果由于某种原因取消订单,但收到支付已授权的通知,则将自动取消订单

订单取消时的自动取消/退款

激活/停用取消订单时的自动退款

账单电子邮件

激活/停用电子邮件更新

发送订单状态通知电子邮件

激活/停用所有订单状态更改的更新电子邮件给客户

激活调试日志

模块过程应存储在var/log/

文件

DATE_mozg.log

这是模块日志,是一个更详细的日志,包含所有过程,包括模块外部库执行的执行

文件

payment_METHOD.log

高级:Bradesco通知

忽略退款通知

如果在运营商处退款,并且运营商向Magento发送退款通知,则将自动创建一个贷项通知。如果您将此配置设置为“是”,则不会发生此情况,因为它不会处理收到的任何退款通知。

高级:结账体验

取消后的重定向目标

确定购买者在取消支付后如何重定向。

支付方法渲染方法

确定支付方法是否以徽标或仅名称显示。

本地化语言(可选)

这将替换Magento存储的默认客户本地化。

留空让Magento决定(例如:nl_NL)

ISO国家代码(可选)

这将在确定要显示哪些支付方法时替换买家的账单地址国家。

Bradesco借记单

激活

用于“激活”或“停用”该方法的用途

显示顺序

这是在订单关闭步骤中交付方法中显示的顺序

标题

应显示的方法名称

适用于国家的支付方式

您可以定义方法是否应适用于“所有接受的国家”或“指定国家”

特定国家的支付方式

您必须选择方法应能正常工作的国家

受益人/出让人名称

受益人/出让人名称

钱包

钱包

到期日

到期日

标志

标志

图像大小应为120px宽和80px高

在收据顶部显示的标题信息

在收据顶部显示的标题信息

指令(最多三行)

指令(最多三行)

未付款订单状态

使用Boleto可以支付低于总金额的金额。如果适用,请在此处选择状态。如果您留空,则默认为已授权付款订单状态

超额付款订单状态

使用Boleto可以支付高于总金额的金额。如果适用,请在此处选择状态。如果您留空,则默认为已授权付款订单状态

可见性

确定在Magento前端和/或后端中显示此支付方法

Bradesco电子转账

激活

用于“激活”或“停用”该方法的用途

显示顺序

这是在订单关闭步骤中交付方法中显示的顺序

标题

应显示的方法名称

适用于国家的支付方式

您可以定义方法是否应适用于“所有接受的国家”或“指定国家”

特定国家的支付方式

您必须选择方法应能正常工作的国家

电子转账类型

选择运营商释放的标志

未付款订单状态

使用Boleto可以支付低于总金额的金额。如果适用,请在此处选择状态。如果您留空,则默认为已授权付款订单状态

超额付款订单状态

使用Boleto可以支付高于总金额的金额。如果适用,请在此处选择状态。如果您留空,则默认为已授权付款订单状态

可见性

确定在Magento前端和/或后端中显示此支付方法

常见问题解答(FAQ)

模块安装后做什么?

首先必须在测试环境中进行测试

访问Bradesco管理器

https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp

访问:设置 -> 支付方式

并获取信息

merchantId=???
email=???
chaveSeguranca=???

在Magento的支付方法中更新这些设置

创建一个1.00元的测试订单

执行订单完成测试

如果显示订单交易

发送电子邮件给Scopus,请求对该集成进行认证,并请求用于生产环境的数据

https://meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp

如何更改Boleto和TEF方法的状态

为了处理Boleto和TEF,每5分钟CRON将访问运营商以获取交易状态,以便执行通知处理

“mozg_bradesco_trigger_notification”CRON服务必须正在运行

如何配置通知URL

如上所述,执行访问通知URL的相同过程

由于Bradesco和商店环境之间可能存在TLS不兼容性

Scopus建议使用以下通知URL

https://meiosdepagamentobradesco.com.br/notification

错误:“当前系统不可用”

在尝试通过Boleto进行交易时返回了错误“钱包的值应包含25或26”,将其更改为26后正常工作

如何更改方法图像

可以添加以下任一名称的图像

  • method-boleto.png
  • method-eletronictransfer.png

并将图像添加到您的模板目录中

/skin/frontend//default/images/mozg_bradesco

如何创建交易的授权标题

以下是一个具有以下授权标题的交易

--header 'Authorization: Basic MTAwMDA2ODczOm1WeWFuZzZpZm9GNjNkMWE1UFFqd25GQ3ZrWDM0bV9ZMWVQREpjQms3clE='

相当于“base64_encode(merchantId:securityKey)”资源

我们可以使用以下服务来编码信息

访问

https://www.base64encode.org/

并输入

seu_merchantId:sua_chaveSeguranca

在我这个案例中是以下数据

"100006873:mVyang6ifoF63d1a5PQjwnFCvkX34m_Y1ePDJcBk7rQ"

认证模拟

下面是使用布拉德斯科测试环境和我的数据进行模拟,可以看到认证返回是正常的

merchantId=100006873
email=suporte@cerebrum.com.br
chaveSeguranca=mVyang6ifoF63d1a5PQjwnFCvkX34m_Y1ePDJcBk7rQ

suporte@cerebrum.com.br:mVyang6ifoF63d1a5PQjwnFCvkX34m_Y1ePDJcBk7rQ

curl --request GET https://homolog.meiosdepagamentobradesco.com.br/SPSConsulta/Authentication/100006873 --header 'Content-Type: application/json' --header 'Authorization: Basic c3Vwb3J0ZUBjZXJlYnJ1bS5jb20uYnI6bVZ5YW5nNmlmb0Y2M2QxYTVQUWp3bkZDdmtYMzRtX1kxZVBESmNCazdyUQ==' --data '' --verbose

汇票交易模拟

curl --request POST https://homolog.meiosdepagamentobradesco.com.br/apiboleto/transacao --header 'Content-Type: application/json' --header 'Authorization: Basic MTAwMDA2ODczOm1WeWFuZzZpZm9GNjNkMWE1UFFqd25GQ3ZrWDM0bV9ZMWVQREpjQms3clE=' --data '{
     "merchant_id":"100006873",
     "meio_pagamento":"300",
     "pedido":{
            "numero":"145000639",
            "valor":10000,
            "descricao":"Compra pelo site http://127.0.0.1/public_html/magento-1.9.3.1-dev34/root/"
     },
     "comprador":{
            "nome":"Eula Jackson",
            "documento":"25739569000102",
            "endereco":{
                 "cep":"08215070",
                 "logradouro":"Avenida Córrego do Jacuu",
                 "numero":"12",
                 "complemento":"ap. 23 B",
                 "bairro":"Itaquera",
                 "cidade":"São Paulo",
                 "uf":"CE"
            },
            "ip":"127.0.0.1",
            "user_agent":"Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:53.0) Gecko/20100101 Firefox/53.0"
     },
     "boleto":{
            "beneficiario":"ACME (American Company Makes Everything)",
            "carteira":"25",
            "nosso_numero":"145000639",
            "data_emissao":"2017-05-25",
            "data_vencimento":"2017-06-01",
            "valor_titulo":10000,
            "url_logotipo":"",
            "mensagem_cabecalho":"mensagem de cabecalho",
            "tipo_renderizacao":"2",
            "instrucoes":{
                 "instrucao_linha_1":"- instrucao_linha_1",
                 "instrucao_linha_2":"- instrucao_linha_2",
                 "instrucao_linha_3":"- instrucao_linha_3"
            },
            "registro":null
     },
     "token_request_confirmacao_pagamento":"a784f7b1e854b967da7fc2e2bc91ef2465712196"
}' --verbose

电子转账交易模拟

curl --request POST https://homolog.meiosdepagamentobradesco.com.br/transf/transacao --header 'Content-Type: application/json' --header 'Authorization: Basic MTAwMDA2ODczOm1WeWFuZzZpZm9GNjNkMWE1UFFqd25GQ3ZrWDM0bV9ZMWVQREpjQms3clE=' --data '{
     "merchant_id":"100006873",
     "meio_pagamento":"800",
     "pedido":{
            "numero":"145000641",
            "valor":100,
            "descricao":"Compra pelo site http://127.0.0.1/public_html/magento-1.9.3.1-dev34/root/"
     },
     "comprador":{
            "nome":"Eula Jackson",
            "documento":"25739569000102",
            "endereco":{
                 "cep":"08215070",
                 "logradouro":"Avenida Córrego do Jacuu",
                 "numero":"12",
                 "complemento":"ap. 23 B",
                 "bairro":"Itaquera",
                 "cidade":"São Paulo",
                 "uf":"CE"
            },
            "ip":"127.0.0.1",
            "user_agent":"Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:53.0) Gecko/20100101 Firefox/53.0"
     },
     "token_request_confirmacao_pagamento":"a784f7b1e854b967da7fc2e2bc91ef2465712196"
}' --verbose

联系方式 - SCOPUS 技术公司

安全支付系统
技术支持
Scopus 技术
(11) 3909-3482
(11) 3909-3637
kit@scopus.com.brhomologacao@scopus.com.brcomerciobradesco@scopus.com.br

手册

https://homolog.meiosdepagamentobradesco.com.br/manual/Manual_BoletoBancario.pdf

https://homolog.meiosdepagamentobradesco.com.br/manual/Manual_ConsultaPedidos.pdf

https://homolog.meiosdepagamentobradesco.com.br/manual/Manual_API_Transferencia.pdf

贡献者

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

🐈