搜索mozgbrasil / magento-bradesco-php_54
Bradesco 集成
Requires
This package is auto-updated.
Last update: 2024-09-05 16:51:16 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 existir o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo e adicione o conteúdo acima
Acesse o arquivo pelo browser
Em seguida, pesquise 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
Descompacte 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 utilizar o(s) módulo(s) da MOZG, é necessário aceitar o Acordo de licença do usuário final
--
Recomendo manter um ambiente de testes para efeito de testes e aplicar os procedimentos adequados no ambiente de produção apenas após os devidos testes
--
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 está 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 existir 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 comando a seguir no terminal do seu servidor no diretório do seu projeto
composer require mozgbrasil/magento-bradesco-php_54:dev-master
Você pode verificar se o módulo está instalado, indo ao backend em
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
Para atualizar o módulo, execute o comando a seguir 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 comando a seguir no terminal do seu servidor no diretório do seu projeto
composer remove mozgbrasil/magento-bradesco-php_54
--
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 correspondente
• Merchant ID ou "MID" para o ambiente de teste
Ao 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
• Merchant ID para o ambiente de produção
信息应由Bradesco提供
• 生产环境安全密钥
信息应由Bradesco提供
高级：Magento订单处理
• 订单状态：创建订单
新创建订单的状态，在运营商服务器通知支付结果确认之前
• 订单状态：支付授权
运营商授权通知确认后的订单状态
• 订单状态：支付确认
运营商授权通知确认后的订单状态
• 订单状态：订单取消
运营商取消通知确认后的订单状态
如果订单已经开票，则不能取消
• 订单状态：支付捕获（虚拟产品）
仅选择分配给完成状态的订单状态，为使用与普通产品相同的订单状态留空
• 订单状态：退款
运营商退款通知确认后的订单状态
• 订单状态：部分退款
运营商部分退款通知确认后的订单状态。建议不要定义此状态，让Magento决定状态。
• 订单状态：挂起订单
运营商挂起通知后的订单状态
• 捕获类型
需要使用该自动化执行通过CRON执行的支付通知处理时，应选择“自动”选项
需要手动捕获交易时，应选择“手动”选项，此操作通过访问订单账单并单击“捕获”按钮完成
• 创建挂起账单（仅限手动捕获）
如果收到授权通知，这将创建一个挂起账单。
注意：这将使Magento在创建账单后立即将所有订单推送到“处理”状态，忽略所有其他设置。
• 发货时捕获
如果您启用此功能，则在发货时将向运营商发出捕获请求
• 启用取消订单
如果由于某些原因取消订单，但收到支付授权通知，则将自动取消订单
• 取消订单时自动退款/退款
启用/禁用取消订单时的自动退款/退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用所有订单状态变更的更新电子邮件，供客户使用
• 启用调试日志
模块流程应存储在var/log/中
文件
DATE_mozg.log
这是模块日志，是一个更详细的日志，包含所有流程，包括模块外部库执行的执行
文件
payment_METHOD.log
高级：Bradesco通知
• 忽略退款通知
如果退款在运营商处完成，并且运营商向Magento发送退款通知，则应自动创建一个贷项通知。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理收到的任何退款通知。
高级：结账体验
• 取消后重定向目标
确定在取消支付后买家将被重定向到何处。
• 支付方式渲染方法
确定支付方式是否将显示其徽标或仅显示名称。
• 本地语言（可选）
这将替换 Magento 存储中客户默认的本地语言。
留空以让 Magento 决定（例如：nl_NL）
• ISO 国家代码（可选）
这将在确定显示哪些支付方式时替换买家的收货地址国家。
Bradesco 票据
• 激活
用于“激活”或“禁用”该方法的用途
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
应显示的方法名称
• 适用于国家的支付方式
您可以选择方法是否应适用于“所有接受的国家”或“指定国家”
• 特定国家的支付方式
您必须选择方法应适用的国家
• 受益人/出票人名称
受益人/出票人名称
• 钱包
钱包
• 到期日
到期日
• 徽标
徽标
图片大小应为 120px 宽度，80px 高度
• 在票据顶部显示的标题信息
在票据顶部显示的标题信息
• 说明（最多三行）
说明（最多三行）
• 未付款订单状态
使用票据支付可以支付少于总金额。如果适用，请在此选择状态。如果留空，它将采用默认的已授权支付订单状态
• 支付超额订单状态
使用票据支付可以支付多于总金额。如果适用，请在此选择状态。如果留空，它将采用默认的已授权支付订单状态
• 可见性
确定此支付方式在 Magento 前端和/或后端的可见性
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:chaveSeguranca)”资源
我们可以使用以下服务来编码信息
访问
并输入
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 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团队
许可证
徽章
🐈