README

Mozg\Userede

简介

集成Userede

动机

满足市场对Magento模块的需求，提供改进和优质的客户支持

演示视频

支持/疑问

要获取必要的支持，请点击这里，尽可能详细地说明发生原因，并附上屏幕截图以便我们理解

价格

点击这里

模块资源

[✓] 交易
[✓] 查询
[✓] 捕获
[✓] 退款
[✓] 取消

技术特性

在结账时进行授权流程

在收到“交易授权”的返回时，将重定向到成功页面

在成功页面上，将信息发送到交易通知资源

通过CRON处理交易通知

在处理通知时，如果确认付款，则应将订单的“状态/状态”更改为“processing”，即“处理中”，以释放处理账单和发货的操作

当订单发货时，状态将更改为“complete”，即“完成”

在发货商品之前，始终检查订单信息，如果显示交易状态已被确认，包括与金融运营商，如果交易已被捕获，如果存在不一致的情况，则必须取消订单直到问题得到纠正

设置Cron

要使用此方法，需要为CRON激活Magento

点击这里查看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”正在读取此类加密

https://raw.githubusercontent.com/mozgbrasil/heroku-magento/master/phpinfo-ioncube-encoder10-x86-64-php_54.php

要使用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-userede-php_54: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-userede-php_54

要禁用模块

在进行任何涉及更新Magento的过程之前，必须保持编译器和缓存处于禁用状态
如果您想禁用MOZG模块，请重命名以下文件夹app/code/local/Mozg

模块禁用可以用来检测特定事件是否与模块相关

如何配置支付方式

要配置支付方式，请在后端访问

STORES -> Configuration -> Sales/Payment Methods -> Userede (powered by MOZG)

您将看到以下字段

Userede API V2 - 默认设置

必要配置

• 测试或生产模式

需要指定相应的环境

• 测试环境的商户ID

在以下环境中进行注册以获取集成数据，如：MerchantId和MerchantKey

https://cadastrosandbox.userede.com.br/

• 测试环境的商户密钥

在以下环境中进行注册以获取集成数据，如：MerchantId和MerchantKey

https://cadastrosandbox.userede.com.br/

• 生产环境的商户ID

该信息应由Userede提供

• 生产环境的商户密钥

该信息应由Userede提供

高级：处理订单的Magento方式

• 订单状态：创建订单

创建的订单状态，在通过运营商服务器通知的支付结果确认之前

• 订单状态：支付授权

运营商确认授权通知后的订单状态

• 订单状态：支付确认

运营商确认授权通知后的订单状态

• 订单状态：取消订单

运营商确认取消通知后的订单状态

如果订单已经开票，则无法取消

• 订单状态：支付捕获（虚拟产品）

仅选择分配给完成状态的订单状态，留空使用普通产品的相同状态

• 订单状态：已退款

运营商确认退款通知后的订单状态

• 订单状态：部分退款

运营商确认部分退款通知后的订单状态。建议不要定义此状态，让Magento决定状态。

• 订单状态：待处理订单

运营商通知待处理状态后的订单状态

• 捕获类型

即时是默认设置

如果您想稍后手动执行资金捕获，请设置为手动

• 创建待处理账单（仅限手动捕获）

如果收到授权通知，将创建一个待处理账单。

注意：一旦创建账单，这将使Magento将所有订单推送到“处理”状态，忽略所有其他设置。

• 订单状态：发货时捕获

如果您启用此功能，在发货时将向运营商发出捕获请求

• 启用取消订单

如果订单因某些原因被取消，但收到支付已授权的通知，则将自动取消订单

• 取消订单时自动退款/退款

启用/禁用取消订单时的自动退款

• 账单电子邮件

启用/禁用电子邮件更新

• 发送订单状态通知电子邮件

启用/禁用订单状态更改的电子邮件更新，通知客户

• 启用调试日志

模块的过程应存储在 var/log/ 中

文件

DATE_mozg.log

这是模块日志，是一个更详细的日志，包含所有进程，包括模块外部库执行的执行

文件

payment_METHOD.log

高级：使用通知

• 忽略退款通知

如果退款在运营商处完成，并且运营商向Magento发送退款通知，则应自动创建一个贷项通知。如果您将此配置设置为“是”，则不会发生这种情况，因为它不会处理收到的任何退款通知。

高级：结账体验

• 取消支付后的重定向目标

确定在取消支付后如何重定向买家。

• 支付方法渲染方式

确定支付方法是否以徽标或仅名称显示。

• 本地语言（可选）

这将替换Magento存储的默认客户位置。

留空以让Magento决定（例如：nl_NL）

• ISO国家代码（可选）

这将替换买家的账单地址国家，以确定显示哪些支付方式。

用户德信用卡

• 启用

用于“启用”或“禁用”方法的使用

• 显示顺序

这是在订单结算步骤中显示的配送方法顺序

• 标题

应显示的方法的名称

• 适用于国家的支付方式

您可以选择该方法是否适用于“所有接受的国家”或“指定国家”。

• 特定国家的付款

您必须选择该方法应适用的国家。

• 信用卡类型

选择运营商批准的标志。

• 可见性

确定此付款方法在Magento前端和/或后端的可见性。

• 验证

定义买家是否将被重定向到发卡行进行信用卡验证。

对于此选项，将发送ReturnUrl参数，不应适用于包含特殊字符的域名，因为这些域名不符合Cielo的规则。

对于在后台完成的订单，请勿启用此选项，因为它不会将重定向到验证URL。

• 激活分期付款

定义使用分期的使用。

• 标准分期

对于“货币”列，请提供货币代码，例如BRL。

对于“总额（含）”列，请提供显示分期的最低金额。

对于“最大分期数”列，请提供显示分期数直到达到显示分期金额的值。

对于“利率（%）”列，请提供使用的利率。

分期显示规则基于价格区间。

模块默认配置如下

至R$ 100.00，1期

至R$ 200.00，2期

至R$ 600.00，3期

至R$ 800.00，4期

至R$ 10,000.00，5期

至R$ 100,000.00，6期

根据您的需求进行修改

• 总金额为零时禁用

当总报价为0时，在结账时禁用此付款方式。

Userede借记卡

• 启用

用于“启用”或“禁用”方法的使用

• 显示顺序

这是在订单结算步骤中显示的配送方法顺序

• 标题

应显示的方法的名称

• 适用于国家的支付方式

您可以选择该方法是否适用于“所有接受的国家”或“指定国家”。

• 特定国家的付款

您必须选择该方法应适用的国家。

• 借记卡类型

选择运营商批准的标志。

• 可见性

确定此付款方法在Magento前端和/或后端的可见性。

• 总金额为零时禁用

当总报价为0时，在结账时禁用此付款方式。

Userede账单

• 启用

用于“启用”或“禁用”方法的使用

• 显示顺序

这是在订单结算步骤中显示的配送方法顺序

• 标题

应显示的方法的名称

• 适用于国家的支付方式

您可以选择该方法是否适用于“所有接受的国家”或“指定国家”。

• 特定国家的付款

您必须选择该方法应适用的国家。

• 账单类型

选择运营商批准的标志。

• 未付款订单状态

使用账单可以支付低于总金额的金额。如果适用，请选择此处状态。如果您将其留空，它将采用默认的付款授权订单状态。

• 超额付款订单状态

使用账单可以支付高于总金额的金额。如果适用，请选择此处状态。如果您将其留空，它将采用默认的付款授权订单状态。

• 可见性

确定此付款方法在Magento前端和/或后端的可见性。

Userede电子转账

• 启用

用于“启用”或“禁用”方法的使用

• 显示顺序

这是在订单结算步骤中显示的配送方法顺序

• 标题

应显示的方法的名称

• 适用于国家的支付方式

您可以选择该方法是否适用于“所有接受的国家”或“指定国家”。

• 特定国家的付款

您必须选择该方法应适用的国家。

• 电子转账类型

选择运营商批准的标志。

• 未付款订单状态

使用账单可以支付低于总金额的金额。如果适用，请选择此处状态。如果您将其留空，它将采用默认的付款授权订单状态。

• 超额付款订单状态

使用账单可以支付高于总金额的金额。如果适用，请选择此处状态。如果您将其留空，它将采用默认的付款授权订单状态。

• 可见性

确定此付款方法在Magento前端和/或后端的可见性。

常见问题解答（FAQ）

401未授权

错误：客户端错误：`POST https://api.userede.com.br/v2/sales/` 导致 `401未授权` 响应

在身份验证失败时应显示“401未授权”返回。

模块安装后做什么？

在

https://cadastrosandbox.userede.com.br/

这里将提供您的MerchantId和MerchantKey

在Magento中配置方法的MerchantId和MerchantKey

为了测试效果，可以使用以下测试卡

http://mozg.com.br/dicas/dicas-magento1#cartões-de-crédito-para-testes

在测试环境中完成订单，该环境将处理交易

如果显示了完成页面，则表示已处理您的交易

与Userede交互，请求对该集成进行测试并请求用于生产环境的数据

https://suporte.userede.com.br

如何取消订单

要取消通过Magento进行的订单，请访问先前创建的账单并单击“取消”按钮，然后访问订单并单击“取消”按钮

如何退款

访问先前创建的账单并单击“退款”按钮

注意。只有在进行了捕获后，“退款”按钮才应显示

在点击“退款”按钮查看订单时，Magento只显示名为“离线退款”的按钮，点击该按钮只会对Magento执行退款操作

在查看订单发票时点击“退款”按钮，Magento应显示名为“离线退款”和“退款”的按钮，点击“退款”按钮会触发“在线”动作，即触发向支付运营商“取消”与订单相关的交易的动作

如何更改方法图像

可以添加包含以下任一名称的图像

method-boleto.png
method-creditcard.png
method-debitcard.png
method-eletronictransfer.png

并将图像添加到您的模板目录中

/skin/frontend//default/images/mozg_userede

如何自定义phtml文件

您可以通过编辑文件并随后将其添加到模板目录结构中来自定义phtml文件

以下我们将对特定模板提供支持

cp -r app/design/frontend/base/default/template/mozg_userede/ app/design/frontend/smartwave/porto/template

联系方式 - Userede

implantacao.operacoes@userede.com.br

罗尔多·德·卢克纳 - rmoreira@userede.com.br - 11 3320-9058

或访问

http://userede.tasker.com.br/

或访问

联系Userede

手册

http://www.userede.com.br/suporte/desenvolvedores/

http://apidocs.userede.com.br/

贡献者

Mozg团队

许可证

商业许可证

徽章

🐈

mozgbrasil / magento-userede-php_54

维护者

详细信息

README

Mozg\Userede

简介

动机

演示视频

支持/疑问

价格

模块资源

技术特性

设置Cron

在Heroku上测试

安装 - 更新 - 卸载 - 禁用

要安装模块，请在服务器的终端中执行以下命令

要更新模块，请在服务器的终端中执行以下命令

要卸载模块，请在服务器的终端中执行以下命令

要禁用模块

如何配置支付方式

Userede API V2 - 默认设置

必要配置

• 测试或生产模式

• 测试环境的商户ID

• 测试环境的商户密钥

• 生产环境的商户ID

• 生产环境的商户密钥

高级：处理订单的Magento方式

• 订单状态：创建订单

• 订单状态：支付授权

• 订单状态：支付确认

• 订单状态：取消订单

• 订单状态：支付捕获（虚拟产品）

• 订单状态：已退款

• 订单状态：部分退款

• 订单状态：待处理订单

• 捕获类型

• 创建待处理账单（仅限手动捕获）

• 订单状态：发货时捕获

• 启用取消订单

• 取消订单时自动退款/退款

• 账单电子邮件

• 发送订单状态通知电子邮件

• 启用调试日志

高级：使用通知

• 忽略退款通知

高级：结账体验

• 取消支付后的重定向目标

• 支付方法渲染方式

• 本地语言（可选）

• ISO国家代码（可选）

用户德信用卡

• 启用

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的付款

• 信用卡类型

• 可见性

• 验证

• 激活分期付款

• 标准分期

• 总金额为零时禁用

Userede借记卡

• 启用

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的付款

• 借记卡类型

• 可见性

• 总金额为零时禁用

Userede账单

• 启用

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的付款

• 账单类型

• 未付款订单状态

错误：客户端错误：`POST https://api.userede.com.br/v2/sales/` 导致 `401未授权` 响应