搜索mozgbrasil / magento-bradesco-php_72
Bradesco 集成
Requires
- mozgbrasil/magento-payment-php_72: dev-master
This package is auto-updated.
Last update: 2024-09-05 16:58:00 UTC
README
Mozg\Bradesco
概述
集成到 Bradesco
动机
满足 Magento 模块市场，提供改进和优秀的支持
演示
支持/疑问
要获得适当的支持，请点击此处，尽可能详细地报告问题发生的原因，并附加屏幕截图以供理解
价格
模块资源
- [✓] 交易
- [✓] 查询
技术特性
在结账时进行授权过程
在成功页面上显示选择支付类型的窗口
通过 CRON 处理交易通知
在通知处理过程中，如果支付被确认，则应将订单的 "state/status" 改为 "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之前，始终确保禁用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-bradesco-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-bradesco-php_72
--
要禁用模块
-
在进行任何涉及更新Magento的过程之前，需要保持Compiler和Cache禁用
-
如果您想禁用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
• 测试环境的密钥安全
Em
https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/meiopagamento/form
如果没有定义，可以生成安全密钥
• 生产环境中的商户ID
此信息应由Bradesco提供
• 生产环境中的安全密钥
此信息应由Bradesco提供
高级：Magento订单处理
• 订单状态：创建订单
新创建的订单状态，在运营商服务器通知支付结果确认之前
• 订单状态：支付授权
运营商授权通知确认后，订单的状态
• 订单状态：支付确认
运营商授权通知确认后，订单的状态
• 订单状态：订单取消
运营商取消通知确认后的订单状态
如果订单已经开票，则无法取消
• 订单状态：支付捕获（虚拟产品）
仅选择分配给完成状态的订单状态，留空以使用与普通产品相同的状态
• 订单状态：退款
运营商退款通知确认后的订单状态
• 订单状态：部分退款
运营商部分退款通知确认后的订单状态。我们建议不要定义此状态，让Magento决定状态。
• 订单状态：待处理订单
运营商待处理通知后的订单状态
• 捕获类型
需要使用此自动化执行CRON执行的订单通知处理时，应选择“自动”选项
需要手动捕获交易时，应选择“手动”选项，此操作通过访问订单账单并单击“捕获”按钮完成
• 创建待处理账单（仅限手动捕获）
如果收到授权通知，这将创建一个待处理账单。
注意：一旦创建账单，这将使Magento将所有订单推送到“处理”状态，忽略所有其他设置。
• 订单状态：发货时捕获
如果您启用此功能，则在发货时将向运营商发送捕获请求
• 启用取消订单
如果订单由于某种原因被取消，但收到支付授权通知，则会自动取消订单
• 取消订单时自动退款/退款
启用/禁用取消订单时的自动退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用所有订单状态更改的更新电子邮件，以发送给客户
• 启用调试日志
应在var/log/中存储模块过程
文件
DATE_mozg.log
这是模块的日志，它是一个更详细的日志，包含所有过程，包括由模块的外部库执行的过程
文件
payment_METHOD.log
高级：Bradesco通知
• 忽略退款通知
如果在运营商处进行退款，并且运营商向Magento发送退款通知，则应自动创建一个贷项通知。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理收到的任何退款通知。
高级：结账体验
• 取消订单后重定向目标
确定在取消付款后买家如何被重定向。
• 支付方式显示方法
确定支付方式是否以其标志或仅以名称显示。
• 本地语言（可选）
这会替换掉默认的客户端存储的Magento本地。
留空以让Magento决定（例如：nl_NL）
• ISO国家代码（可选）
这将替换在确定显示哪些支付方式时买家的账单地址国家。
Bradesco汇票
• 激活
用于“激活”或“禁用”方法的使用
• 显示顺序
这是在订单结算步骤中显示的送货方式顺序
• 标题
要显示的方法的名称
• 适用于国家的支付方式
您可以定义方法是否适用于“所有可接受的国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 受益人或出让人名称
受益人或出让人名称
• 钱包
钱包
• 到期日
到期日
• 标志
标志
图像大小应为120px宽80px高
• 在汇票顶部显示的标题信息
在汇票顶部显示的标题信息
• 说明（最多三行）
说明（最多三行）
• 未付款订单状态
使用Bradesco汇票支付可以支付少于总金额。如果适用，请选择此状态。如果留空，则默认为订单支付授权状态
• 超额付款订单状态
使用Bradesco汇票支付可以支付多于总金额。如果适用，请选择此状态。如果留空，则默认为订单支付授权状态
• 可见性
确定在Magento的前端和/或后端中此支付方式的可见性
Bradesco电子转账
• 激活
用于“激活”或“禁用”方法的使用
• 显示顺序
这是在订单结算步骤中显示的送货方式顺序
• 标题
要显示的方法的名称
• 适用于国家的支付方式
您可以定义方法是否适用于“所有可接受的国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 电子转账类型
选择运营商释放的标志
• 未付款订单状态
使用Bradesco汇票支付可以支付少于总金额。如果适用，请选择此状态。如果留空，则默认为订单支付授权状态
• 超额付款订单状态
使用Bradesco汇票支付可以支付多于总金额。如果适用，请选择此状态。如果留空，则默认为订单支付授权状态
• 可见性
确定在Magento的前端和/或后端中此支付方式的可见性
常见问题解答 "FAQ"
模块安装后做什么？
首先应在测试环境中进行测试
访问Bradesco管理器
https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp
访问：设置 -> 支付方式
并获取信息
merchantId=???
email=???
chaveSeguranca=???
在Magento的支付方式中更新这些设置
创建一个价值R$ 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
错误："当前系统不可用
在尝试通过汇票进行交易时返回了错误“钱包的金额应为25或26”，我将其更改为26后，功能正常
如何更改支付方式图片
可以添加包含以下任何名称的图片
- method-boleto.png
- method-eletronictransfer.png
并将图片添加到您的模板目录中
/skin/frontend//default/images/mozg_bradesco
如何创建交易授权头
下面是一个带有以下授权头的交易示例
--header 'Authorization: Basic MTAwMDA2ODczOm1WeWFuZzZpZm9GNjNkMWE1UFFqd25GQ3ZrWDM0bV9ZMWVQREpjQms3clE='
这相当于“base64_encode(merchantId:安全密钥)”资源
我们可以使用以下服务来编码信息
访问
并输入
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 TECNOLOGIA
安全支付系统
技术支持
Scopus Tecnologia
(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 团队
许可
徽章
🐈