mozgbrasil / magento-bradesco-php_71
与Bradesco集成
Requires
This package is auto-updated.
Last update: 2024-09-05 17:27:11 UTC
README
Mozg\Bradesco
简介
与Bradesco集成
动机
满足市场对Magento模块的需求,提供改进和优秀的支持
演示
支持/疑问
为了获得适当的支持,请点击此处,尽可能详细地报告发生的原因,并附加屏幕截图以便我们理解
价格
模块资源
- [✓] 交易
- [✓] 查询
技术特性
在结账时执行授权过程
在成功页面显示选择支付类型的窗口
通过CRON处理交易通知
在处理通知时,如果支付已确认,则应将订单的"状态/状态"更改为"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之前,始终保持编译器和缓存关闭
--
请确认您的项目根目录中存在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
--
要停用模块
-
在进行任何涉及更新Magento的过程之前,必须保持编译器和缓存关闭
-
如果您想停用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)”资源
我们可以使用以下服务来编码信息
访问
并输入
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.br,homologacao@scopus.com.br,comerciobradesco@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 团队
许可
徽章
🐈