mozgbrasil / magento-bradesco-php56
与Bradesco的集成
Requires
This package is auto-updated.
Last update: 2024-09-06 11:17:51 UTC
README
Mozg\Bradesco
摘要
与Bradesco集成
演示
动机
满足Magento模块市场的需求，提供改进和优秀的支持
支持/疑问
要获取适当的支持，请点击此处，尽可能详细地说明问题原因，并附上屏幕截图以便我们理解
价格
模块的功能
- [✓] 票据
- [✓] 电子转账
- [✓] 查询
技术特性
在结账时进行授权流程
在成功页面显示支付类型的窗口
通过CRON处理交易通知，如果支付已确认，则将订单状态更改为"处理中"，以释放处理账单和发货的操作
在发货前，始终检查订单信息，如果交易状态显示支付已确认，包括与金融机构一起确认交易是否被捕获，如果存在不一致，则需要取消订单直到问题纠正
设置CRON
点击此处查看MOZG文档
确保每分钟执行一次操作
此模块使用cronjob处理通知
模块执行至少5分钟前接收到的通知
安装 - 更新 - 卸载 - 禁用
--
此模块旨在使用Composer安装
在终端中执行以下命令，以查看Composer及其版本
composer --version
如果没有Composer在您的环境中，建议阅读以下文章 点击此处
--
服务器需要支持ionCube PHP Loader扩展
为了查看您的服务器是否已激活此扩展
请确认您的项目根目录是否存在phpinfo.php文件
<?php phpinfo(); ?>
如果您的Magento项目根目录中不存在phpinfo.php文件，请创建该文件并添加上述内容
通过浏览器访问该文件
然后搜索"ionCube PHP Loader"术语
如果您的服务器不支持此扩展，请点击此处
在"Loader Downloads API"中，下载与您的服务器兼容的包
解压包并将"loader-wizard.php"文件上传到您的服务器，其中将演示激活扩展的步骤
点击此处查看执行过程
--
要使用MOZG模块，必须接受最终用户许可协议
--
建议保留一个测试环境进行测试，并且只在经过适当的测试后，再将相应的程序应用到生产环境中
--
建议备份Magento平台和数据库
--
在更新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-php56:dev-master
您可以通过访问后端来检查模块是否已安装
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
要更新模块，请在您的服务器终端的项目目录中执行以下命令
在进行任何涉及更新Magento的操作之前，建议保持编译器和缓存处于禁用状态
composer clear-cache && composer update
在发生错误时，将/vendor/mozgbrasil文件夹重命名，然后重新执行
要检查模块的日期，请执行以下命令
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
要卸载模块，请在您的服务器终端的项目目录中执行以下命令
composer remove mozgbrasil/magento-bradesco-php56 && composer clear-cache && composer update
--
要禁用模块
-
在进行任何涉及更新Magento的操作之前，必须保持编译器和缓存处于禁用状态
-
如果您想禁用MOZG模块，请重命名以下文件夹app/code/local/Mozg
禁用模块可以用来检测特定事件是否与模块相关
如何配置支付方式
要配置支付方式，请访问后端
STORES -> Configuration -> Sales/Payment Methods -> Bradesco (powered by MOZG)
您将看到以下字段
Bradesco支付方式 - 默认设置
必要的设置
• 测试或生产模式
必须指定相应的环境
• 商户ID或测试环境下的"MID"
登录
https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp
在右上角我们可以找到这个信息作为MID
• 测试环境的密钥
在
https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/meiopagamento/form
如果没有定义，可以在此处生成安全密钥
• 生产环境的商户ID
信息应由Bradesco提供
• 生产环境的密钥
信息应由Bradesco提供
高级：处理订单的Magento
• 订单状态：创建订单
新创建的订单状态，在支付操作员的服务器通知确认支付结果之前
• 订单状态：支付授权
在支付操作员的通知确认授权后，订单的状态
• 订单状态：支付确认
支付操作员的通知确认捕获后，订单的状态
• 订单状态：订单取消
支付操作员的通知确认取消后，订单的状态
如果订单已经开账，则无法取消
• 订单状态：支付捕获（虚拟产品）
仅选择已分配给完成状态的订单状态，留空则使用与普通产品相同的状态
• 订单状态：退款
支付操作员的通知确认退款后，订单的状态
• 订单状态：部分退款
退款（部分）确认后，订单状态由运营商的 REEMBOLSO_PARCIAL 通知确定。我们建议不要设置此状态，让 Magento 决定状态。
• 订单状态：待处理订单
运营商通知待处理订单的状态
• 捕获类型
即时为默认设置
如果您希望以后手动执行资金捕获，请将其设置为手动
• 创建待处理账单（仅限手动捕获）
如果收到 AUTORIZAÇÃO 通知，这将创建一个待处理账单。
注意：一旦创建账单，Magento 将将所有订单推送到“处理”状态，忽略所有其他设置。
• 订单状态：发货时捕获
如果您启用此功能，则在发货时将向运营商发出捕获请求
• 启用取消订单
如果由于某种原因取消订单，但收到支付已授权的通知，则将自动取消订单
• 取消订单时自动退款/退款
启用/禁用取消订单时的自动退款/退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用所有订单状态更改的客户更新电子邮件
• 启用调试日志
模块过程应存储在 var/log/ 中
文件
DATE_mozg.log
这是模块日志，是一个更详细的日志，包含所有过程，包括由模块外部库执行的过程
文件
payment_METHOD.log
高级：Bradesco 通知
• 忽略退款通知
如果退款在运营商处完成，并且运营商向 Magento 发送退款通知，则将自动创建一个信用额度。如果您将此设置设置为“是”，则不会发生这种情况，因为它不会处理接收到的任何退款通知。
高级：结账体验
• 取消后重定向目标
确定买家在取消付款后如何重定向。
• 支付方式渲染方法
确定支付方式是否显示其标志或仅显示名称。
• 本地语言（可选）
这会替换 Magento 存储的默认客户本地设置。
留空以让 Magento 决定（例如：nl_NL）
• ISO 国家代码（可选）
这将在确定显示哪些支付方式时替换买家的账单地址国家。
Bradesco 票据
• 启用
用于“启用”或“禁用”该方法的用途
• 显示顺序
这是在订单结算步骤中显示的送货方式顺序
• 标题
应显示的方法的名称
• 适用于国家的支付方式
您可以选择该方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应适用的国家
• 受益人/出让人姓名
受益人/出让人姓名
• 钱包
钱包
• 到期日
到期日
• 标志
标志
图片尺寸应为 120px 宽度 x 80px 高度
• 在票据顶部显示的标题信息
在票据顶部显示的标题信息
• 指令（最多三行）
说明（最多三行）
• 未付款订单状态
使用汇票支付可以支付少于总金额。如果适用，请在此处选择状态。如果您留空，则默认为“支付授权订单状态”
• 已支付超出订单状态
使用汇票支付可以支付多于总金额。如果适用，请在此处选择状态。如果您留空，则默认为“支付授权订单状态”
• 可见性
确定在Magento的前端和/或后端中显示此支付方式
Bradesco电子转账
• 启用
用于“启用”或“禁用”该方法的用途
• 显示顺序
这是在订单结算步骤中显示的送货方式顺序
• 标题
应显示的方法的名称
• 适用于国家的支付方式
您可以选择该方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应适用的国家
• 电子转账类型
选择运营商允许的标志
• 未付款订单状态
使用汇票支付可以支付少于总金额。如果适用，请在此处选择状态。如果您留空，则默认为“支付授权订单状态”
• 已支付超出订单状态
使用汇票支付可以支付多于总金额。如果适用，请在此处选择状态。如果您留空，则默认为“支付授权订单状态”
• 可见性
确定在Magento的前端和/或后端中显示此支付方式
常见问题解答（FAQ）
如何创建交易授权头
下面是一个带有以下授权头的交易示例
--header 'Authorization: Basic MTAwMDA2ODczOm1WeWFuZzZpZm9GNjNkMWE1UFFqd25GQ3ZrWDM0bV9ZMWVQREpjQms3clE='
它等同于“base64_encode(merchantId:securityKey)”
我们可以使用以下服务来编码信息
访问
并告知
seu_merchantId:sua_chaveSeguranca
在我这个例子中是以下数据
"100006873:mVyang6ifoF63d1a5PQjwnFCvkX34m_Y1ePDJcBk7rQ"
认证模拟
以下是使用Bradesco测试环境和我的数据的模拟，请看认证返回是否正常
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提到以下内容
尊敬的（女士/先生），
我们验证到您的通知URL在测试环境中出现错误，我们正在调查以定位问题。
同时，为了加快进度并确保您可以过渡到生产环境，其中您的URL将正确工作，我们提供了以下URL
https://homolog.meiosdepagamentobradesco.com.br/lojatesteapi/
如何配置通知URL
http://SEU_DNS/index.php/mozg_bradesco/process/notification/
如何更改方法图片
可以添加以下命名之一的图片
method-boleto.png
- method-eletronictransfer.png
- 并将图片添加到您的模板目录中
/skin/frontend//default/images/mozg_bradesco
联系方式 - SCOPUS TECNOLOGIA
安全支付系统
技术支持
Scopus Tecnologia
(11) 3909-3482
(11) 3909-3637
kit@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团队
许可证
徽章
🐈