mozgbrasil / magento-bradesco-php_56
与Bradesco集成
Requires
This package is auto-updated.
Last update: 2024-09-05 17:07:19 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环境中激活,请执行以下命令
Certique-se da presença do arquivo phpinfo.php na raiz do seu projeto
<?php phpinfo(); ?>
Se não houver o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo e adicione o conteúdo acima
Acesse o arquivo pelo navegador
Em seguida, procure pelo termo "ionCube PHP Loader"
Se o seu servidor não tiver suporte à extensão, entre em contato com sua empresa de hospedagem e peça para que eles ativem a extensão
Se tiver permissão e quiser ativar a extensão, Clique aqui
Em "Loader Downloads API", baixe o pacote compatível com o seu servidor
Descomprima o pacote e faça upload do arquivo "loader-wizard.php" para seu servidor, onde será demonstrado o passo a passo para a ativação da extensão
Clique aqui para ver os processos executados
--
Na presença do "ionCube PHP Loader", faça o download do seguinte arquivo e coloque na raiz do seu servidor e acesse, se funcionar, isso significa que o "ionCube" está lendo esse tipo de criptografia
--
Para usar o(s) módulo(s) da MOZG, é necessário aceitar o Acordo de licença do usuário final
--
Recomendo manter um ambiente de teste para efeitos de teste e, só após os devidos testes, aplicar os procedimentos no ambiente de produção
--
Recomendo fazer backup da plataforma Magento e do banco de dados
--
Antes de fazer qualquer atualização no Magento, sempre mantenha o Compiler e o Cache desativados
--
Certifique-se de que o arquivo composer.json esteja presente na raiz do seu projeto Magento e que ele tenha os parâmetros semelhantes ao modelo JSON abaixo
{
"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
}
}
Se não houver o arquivo composer.json na raiz do projeto Magento, crie o mesmo e adicione o conteúdo acima
Para instalar o módulo, execute o seguinte comando no terminal do seu servidor no diretório do seu projeto
composer require mozgbrasil/magento-bradesco-php_56:dev-master
Você pode verificar se o módulo está instalado, indo para o backend em
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
Para atualizar o módulo, execute o seguinte comando no terminal do seu servidor no diretório do seu projeto
Antes de fazer qualquer processo que envolva atualização no Magento, é recomendado manter o Compiler e o Cache desativados
composer update
No caso de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente
Para verificar a data do módulo, execute o seguinte comando
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
Para desinstalar o módulo, execute o seguinte comando no terminal do seu servidor no diretório do seu projeto
composer remove mozgbrasil/magento-bradesco-php_56
--
Para desativar o módulo
-
Antes de fazer qualquer processo que envolva atualização sobre o Magento, é necessário manter o Compiler e o Cache desativados
-
Se quiser desativar os módulos da MOZG, renomeie a pasta app/code/local/Mozg
A desativação do módulo pode ser usada para detectar se determinada ocorrência tem relação com o módulo
Como configurar o método de pagamento
Para configurar o método de pagamento, acesse no backend em
STORES -> Configuration -> Sales/Payment Methods -> Bradesco (powered by MOZG)
Você terá os campos a seguir
Bradesco Meios de Pagamentos - Configurações Padrão
Configurações necessárias
• Modo Teste ou Produção
Deve ser informado o ambiente apropriado
• ID do Merchant ou "MID" para o ambiente de teste
Após se logar em
https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp
Na parte superior direita, temos essa informação como MID
• Chave de Segurança para o ambiente de teste
Em
https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/meiopagamento/form
É possível gerar a chave de segurança caso não tenha sido definida
• 生产环境中的商家ID
该信息应由布拉德斯科提供
• 生产环境安全密钥
该信息应由布拉德斯科提供
高级:Magento订单处理
• 订单状态:创建订单
新创建的订单状态,在运营商服务器通知确认支付结果之前
• 订单状态:支付授权
运营商授权通知确认后的订单状态
• 订单状态:支付确认
运营商授权通知确认后的订单状态
• 订单状态:订单取消
运营商取消通知确认后的订单状态
如果订单已开账,则无法取消
• 订单状态:支付捕获(虚拟产品)
仅选择分配给完成状态的属性,留空则使用普通产品相同的设置
• 订单状态:退款
运营商退款通知确认后的订单状态
• 订单状态:部分退款
运营商部分退款通知确认后的订单状态。建议不要定义此状态,让Magento自行决定状态。
• 订单状态:待处理订单
运营商待处理通知后的订单状态
• 捕获类型
需要使用此自动化时,应选择“自动”选项,该自动化应在通过CRON执行的CRON通知处理时执行
需要手动捕获交易时,应选择“手动”选项,此操作通过访问订单账单并点击“捕获”按钮完成
• 创建待处理账单(仅用于手动捕获)
如果收到授权通知,则会创建待处理账单。
注意:这会导致一旦创建账单,Magento将所有订单推送到“处理”状态,忽略所有其他设置。
• 发货时捕获
如果您启用此功能,则在发货时将向运营商发出捕获请求
• 启用取消订单
如果订单因某些原因被取消,但收到支付已授权的通知,则将自动取消订单
• 订单取消时自动退款/退款
启用/禁用取消订单时的自动退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用客户订单状态变更的电子邮件更新
• 启用调试日志
模块过程应存储在var/log/
文件
DATE_mozg.log
这是模块日志,是一个更详细的日志,包含所有过程,包括由模块的外部库执行的操作
文件
payment_METHOD.log
高级:布拉德斯科通知
• 忽略退款通知
如果退款在运营商处完成,并且运营商向Magento发送退款通知,则将自动创建一个贷项通知。如果您将此配置设置为“是”,则不会发生这种情况,因为它不会处理收到的任何退款通知。
高级:结账体验
• 取消后重定向目的地
确定购买者在取消支付后如何被重定向。
• 支付方法渲染方法
确定支付方法是否将使用其标志或仅显示名称显示。
• 本地化语言(可选)
这将替换默认的存储位置。
留空以让Magento自行决定(例如:nl_NL)
• ISO国家代码(可选)
这将替换买家的收货地址国家,以确定显示哪些支付方式。
Bradesco付款通
• 激活
用于“激活”或“禁用”该支付方式
• 显示顺序
这是在订单关闭步骤中显示的送货方式顺序
• 标题
应显示的方法名称
• 适用于国家的支付方式
您可以选择方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择方法应该功能的国家
• 受益人或出让人姓名
受益人或出让人姓名
• 钱包
钱包
• 到期日
到期日
• 徽标
徽标
图片尺寸应为120px宽和80px高
• 在付款单顶部显示的标题信息
在付款单顶部显示的标题信息
• 说明(最多三行)
说明(最多三行)
• 未支付订单状态
使用付款通可以支付少于总金额。如果适用,请在此选择状态。如果您留空,它将默认为已授权支付订单状态
• 支付超出金额的订单状态
使用付款通可以支付多于总金额。如果适用,请在此选择状态。如果您留空,它将默认为已授权支付订单状态
• 可见性
确定此支付方式在前端和/或后端中的可见性
Bradesco电子转账
• 激活
用于“激活”或“禁用”该支付方式
• 显示顺序
这是在订单关闭步骤中显示的送货方式顺序
• 标题
应显示的方法名称
• 适用于国家的支付方式
您可以选择方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择方法应该功能的国家
• 电子转账类型
选择运营商授权的标志
• 未支付订单状态
使用付款通可以支付少于总金额。如果适用,请在此选择状态。如果您留空,它将默认为已授权支付订单状态
• 支付超出金额的订单状态
使用付款通可以支付多于总金额。如果适用,请在此选择状态。如果您留空,它将默认为已授权支付订单状态
• 可见性
确定此支付方式在前端和/或后端中的可见性
常见问题“FAQ”
安装模块后该做什么?
首先应在测试环境中进行测试
访问Bradesco管理员
https://homolog.meiosdepagamentobradesco.com.br/gerenciadorapi/login.jsp
访问:设置 -> 支付方式
并获取信息
merchantId=???
email=???
chaveSeguranca=???
在Magento中的支付方式中更新这些设置
创建一个1.00 R$的测试订单
进行订单完成测试
如果显示订单交易
向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:chaveSeguranca)”资源
我们可以使用以下服务来编码信息
访问
并输入
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 团队
许可
徽章
🐈