mozgbrasil / magento-rede-php_54
网络集成
Requires
- mozgbrasil/magento-payment-php_54: dev-master
This package is auto-updated.
Last update: 2024-09-05 17:42:31 UTC
README
Mozg\Rede
摘要
集成 Rede
演示视频
https://www.useloom.com/share/9432a0a5962941ddbaea895cfcb46077
动机
满足市场对 Magento 模块的改进和优质支持的需求
支持/疑问
要获得适当的支持,请点击此处 Clique aqui,尽可能详细地描述发生的原因并附加屏幕截图以便我们理解
价格
模块资源
- [✓] 交易
- [✓] 查询
- [✓] 捕获
- [✓] 退款
- [✓] 取消
技术特征
在结账时进行授权过程
在收到“交易授权”返回时,将重定向到成功页面
在成功页面上发送信息到交易通知资源
通过 CRON 应处理交易通知
在处理通知时,如果支付已确认,则应将订单的“状态/状态”更改为“processing”,即“处理中”,以释放处理账单和发货的操作
在发货商品之前,始终检查订单信息,如果显示交易状态已确认,包括与金融机构一起确认交易是否已捕获,如果出现任何不一致,则必须取消订单,直到问题得到纠正
当订单发货时,状态将更改为“complete”,即“完整”
设置 CRON
Clique aqui 以查看 MOZG 文档
请确保每分钟执行一次操作
该模块使用 cronjob 处理通知
该模块执行至少 5 分钟前接收到的通知
在 Heroku 上测试
我想展示我在 Heroku 平台上提供的应用程序
只需单击一次,应用程序即可创建使用 Magento 电子商务平台和安装 MOZG 模块的虚拟商店
https://github.com/mozgbrasil/heroku-magento#descrição
安装 - 更新 - 卸载 - 禁用
--
建议“打印”执行的所有步骤的屏幕截图
如有任何困难,请将屏幕截图发送给我们
--
此模块旨在使用 Composer 安装
请在终端中执行以下命令,以查看 Composer 的存在及其版本
composer --version
如果您的环境中没有 Composer,建议阅读以下文章 Clique aqui
--
服务器需要支持 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 arquivo phpinfo.php na raiz do projeto Magento, crie-o adicionando o conteúdo acima
Acesse o arquivo pelo navegador
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 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 ativar a 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, acesse e 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 testes e aplicar os procedimentos devidos no ambiente de produção apenas após os 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 esteja presente na raiz do seu projeto Magento e que ele tenha parâmetros semelhantes ao modelo JSON a seguir
{
"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 arquivo composer.json na raiz do projeto Magento, crie-o adicionando 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-rede-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
Recomendo manter o Compiler e o Cache desativados antes de fazer qualquer processo que envolva atualização no Magento
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-rede-php_54
--
Para desativar o módulo
-
Antes de fazer qualquer processo que envolva atualização no 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 determinado problema está relacionado ao 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 -> Rede (powered by MOZG)
Você terá os seguintes campos
Rede API V2 - Configurações Padrão
Configurações necessárias
• Modo Teste ou Produção
Deve ser informado o ambiente apropriado
• Merchant ID para o ambiente de teste
Realize o cadastro no seguinte ambiente para obter os dados de integração como: MerchantId e MerchantKey
https://cadastrosandbox.rede.com.br/
• Merchant Key Ambiente de teste
Realize o cadastro no seguinte ambiente para obter os dados de integração como: MerchantId e MerchantKey
https://cadastrosandbox.rede.com.br/
• Merchant ID para o ambiente de produção
A informação deve ser fornecida pela Rede
• Merchant Key Ambiente de produção
A informação deve ser fornecida pela Rede
高级:Magento订单处理
• 订单状态:创建订单
新创建订单的状态,在运营商服务器通知的支付结果确认之前
• 订单状态:支付授权
运营商授权通知确认后的订单状态
• 订单状态:支付确认
运营商授权通知确认后的订单状态
• 订单状态:订单取消
运营商取消通知确认后的订单状态
如果订单已开账,则不能取消
• 订单状态:支付抓取(虚拟产品)
仅选择分配给已完成状态的订单状态,留空以使用与普通产品相同的状态
• 订单状态:已退款
运营商退款通知确认后的订单状态
• 订单状态:部分退款
运营商部分退款通知确认后的订单状态。我们建议不要定义此状态,让Magento决定状态。
• 订单状态:待处理订单
运营商待处理通知后的订单状态
• 抓取类型
需要使用此自动化时,应选择“自动”选项,该自动化应在通过CRON执行的订单通知处理中执行
需要手动抓取交易时,应选择“手动”选项,该操作通过访问订单账单并点击“抓取”按钮执行
• 创建待处理账单(仅适用于手动抓取)
如果收到授权通知,这将创建一个待处理账单。
注意:一旦创建账单,这将使Magento将所有订单推送到“处理”状态,忽略所有其他设置。
• 订单状态:发货时抓取
如果您启用此功能,在发货时将向运营商发送抓取请求
• 启用取消订单
如果由于某些原因取消订单,但收到支付已授权的通知,则将自动取消订单
• 订单取消时的自动退款/退款
启用/禁用取消订单时的自动退款
• 账单电子邮件
启用/禁用电子邮件更新
• 发送订单状态通知电子邮件
启用/禁用订单状态更改的所有电子邮件更新以供客户查看
• 启用调试日志
模块过程应存储在var/log/
文件
DATE_mozg.log
这是模块日志,它是一个更详细的日志,包含所有过程,包括由模块的外部库执行的操作
文件
payment_METHOD.log
高级:网络通知
• 忽略退款通知
如果退款在运营商处完成,并且运营商向Magento发送退款通知,则应自动创建一个信用额度。如果您将此配置设置为“是”,则不会发生这种情况,因为它不会处理接收到的任何退款通知。
高级:结账体验
• 取消支付后的重定向目标
确定在取消支付后如何将买家重定向。
• 支付方式渲染方法
确定支付方式是否显示其徽标或仅显示名称。
• 本地语言(可选)
这将替换 Magento 存储默认的客户端语言。
留空以让 Magento 决定(例如:nl_NL)
• ISO 国家代码(可选)
这将替换购买者收货地址的国家,以确定将显示哪些支付方式。
信用卡网络
• 启用
用于“启用”或“禁用”该方法的用法
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
应显示的方法名称
• 适用于国家的支付方式
您可以选择方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 信用卡类型
选择运营商授权的标志
• 可见性
确定在 Magento 前端和/或后端中可见此支付方法
• 认证
定义购买者是否将被重定向到发卡银行进行卡片认证
对于此选项,将发送 ReturnUrl 参数,不应在包含特殊字符的域中使用,如 Cielo 规则所规定
对于后端制作的订单,请勿启用此选项,因为不应将重定向到认证 URL
• 启用分期付款
定义分期付款的使用
• 默认分期付款
对于“货币”列,请输入货币缩写,例如 BRL
对于“总额(含)”列,请输入显示分期付款的最小值
对于“最大分期数”列,请输入将显示的最大分期数,直到达到之前通知显示分期付款的金额
对于“利率(% 0.0)”列,请输入使用的利率
分期付款的显示规则基于价格区间
模块已预先配置,使用以下规则
在这个规则中
R$ 0.00 至 R$ 100.00 显示 1 期
R$ 101.00 至 R$ 200.00 显示 2 期
R$ 201.00 至 R$ 600.00 显示 3 期
R$ 601.00 至 R$ 800.00 显示 4 期
R$ 801.00 至 R$ 10,000.00 显示 5 期
R$ 10,000.00 至 R$ 100,000.00 显示 6 期
根据您的需求进行调整
• 总金额为零时禁用
当总报价为零时,在结账时禁用此支付方式
借记卡网络
• 启用
用于“启用”或“禁用”该方法的用法
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
应显示的方法名称
• 适用于国家的支付方式
您可以选择方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 借记卡类型
选择运营商授权的标志
• 可见性
确定在 Magento 前端和/或后端中可见此支付方法
• 总金额为零时禁用
当总报价为零时,在结账时禁用此支付方式
银行汇票网络
• 启用
用于“启用”或“禁用”该方法的用法
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
应显示的方法名称
• 适用于国家的支付方式
您可以选择方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 汇票类型
选择运营商授权的标志
• 未付款订单状态
使用汇票支付可以支付少于总金额。如果适用,请选择此状态。如果您将其留空,它将采用默认的支付授权订单状态
• 超额付款订单状态
使用汇票支付可以支付多于总金额。如果适用,请选择此状态。如果您将其留空,它将采用默认的支付授权订单状态
• 可见性
确定在 Magento 前端和/或后端中可见此支付方法
电子转账网络
• 启用
用于“启用”或“禁用”该方法的用法
• 显示顺序
这是在订单关闭步骤中显示的交付方法顺序
• 标题
应显示的方法名称
• 适用于国家的支付方式
您可以选择方法是否适用于“接受所有国家”或“指定国家”
• 特定国家的支付方式
您必须选择该方法应功能的国家
• 电子转账类型
选择运营商授权的标志
• 未付款订单状态
使用汇票支付可以支付少于总金额。如果适用,请选择此状态。如果您将其留空,它将采用默认的支付授权订单状态
• 超额付款订单状态
使用汇票支付可以支付多于总金额。如果适用,请选择此状态。如果您将其留空,它将采用默认的支付授权订单状态
• 可见性
确定在 Magento 前端和/或后端中可见此支付方法
常见问题解答“FAQ”
安装模块后做什么?
在
https://www.userede.com.br/desenvolvedores/pt/cadastro
创建一个测试账户
然后
在“我的商店”创建您的商店以开始使用游乐场
在这里提供您的PV和Token
在Magento中配置您的PV和Token
使用以下测试卡进行交易和测试
https://www.userede.com.br/desenvolvedores/pt/produto/e-Rede#tutorial
在测试环境中完成订单,其中将处理交易
如果显示了完成页面,则表示已处理您的交易
与Userede互动,请求对此次集成的认证,并请求用于生产环境的资料
https://www.userede.com.br/desenvolvedores/pt/produto/e-Rede#suporte
执行模拟
接下来我们可以执行模拟
https://demomagento.cerebrum.com.br/testes.html
交易返回是随机的,可能需要尝试几次
交易模拟
归属和Token: PV:TOKEN Base64: Base64
curl --request POST https://api.userede.com.br/desenvolvedores/v1/transactions --header 'Content-Type: application/json' --header 'Authorization: Basic __Base64__' --data '{
"capture": false,
"reference": "pedido123",
"amount": 2099,
"cardholderName": "John Snow",
"cardNumber": "5448280000000007",
"expirationMonth": 12,
"expirationYear": 2020,
"securityCode": "235"
}' --verbose
如何取消订单
要取消订单,请访问之前创建的发票并点击“取消”按钮,然后访问订单并点击“取消”按钮
如何进行退款
访问之前创建的发票并点击“退款”按钮
注意:“退款”按钮仅在已进行扣款时显示
在订单查看中,点击“退款”按钮时,Magento仅显示名为“离线退款”的按钮,点击该按钮只会执行对Magento的退款操作
在订单发票查看中,点击“退款”按钮时,Magento应显示名为“离线退款”和“退款”的按钮,点击“退款”按钮会触发“在线”操作,即触发针对支付运营商的“取消”与订单相关的交易的操作
如何更改方法图片
可以添加包含以下任何一种名称的图片
- method-boleto.png
- method-creditcard.png
- method-debitcard.png
- method-eletronictransfer.png
并将图片添加到您的模板目录中
/skin/frontend//default/images/mozg_rede
联系方式 - 网络
https://www.userede.com.br/desenvolvedores/pt/produto/e-Rede#suporte
手册
https://www.userede.com.br/desenvolvedores/pt/produto/e-Rede
纳税人
Mozg团队
许可
徽章
🐈