README

Mozg\Redecard

简介

集成到 Redecard

动机

为了满足 Magento 模块市场，提供改进和优秀的支持

演示

支持/疑问

要获得适当的支持，请点击这里，尽可能详细地描述问题原因，并附加屏幕截图以便我们理解

价格

点击这里

模块资源

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

技术特性

在结账时进行授权过程

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

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

通过 CRON 应处理交易通知

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

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

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

已实施自动化，每5分钟查询一次交易状态以更新订单状态

设置 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_71.php

要使用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-redecard-php_71: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-redecard-php_71

要禁用模块：

在涉及更新Magento的任何流程之前，需要保持Compiler和Cache禁用。
如果您想禁用MOZG模块，请重命名以下文件夹app/code/local/Mozg。

禁用模块可以用来检测特定问题是否与模块有关。

如何配置支付方式

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

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

您将看到以下字段：

Redecard - 默认设置

所需设置

• 测试或生产模式

应填写相应环境

• Komerci隶属代码

填写您的隶属代码

• Komerci用户

填写访问Redecard的用户

• Komerci密码

填写访问Redecard的密码

用户名和密码用于手动捕获类型

高级：Magento订单处理

• 订单状态：订单创建

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

• 订单状态：支付授权

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

• 订单状态：支付确认

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

• 订单状态：订单取消

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

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

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

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

• 订单状态：已退款

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

• 订单状态：部分退款

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

• 订单状态：待处理订单

运营商通知后的订单状态

• 捕获类型

需要使用此自动化时，必须选择“自动”选项，该自动化需要在通过CRON执行的通知处理中执行

需要手动捕获交易时，必须选择“手动”选项，该操作通过访问订单账单并单击“捕获”按钮完成

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

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

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

• 在发货时捕获

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

• 启用取消订单

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

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

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

• 账单电子邮件

启用/禁用电子邮件更新

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

启用/禁用所有订单状态变更的客户更新电子邮件

• 启用调试日志

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

文件

DATE_mozg.log

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

文件

payment_METHOD.log

高级：Redecard通知

• 忽略退款通知

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

高级：结账体验

• 取消后重定向目标

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

• 支付方式渲染方法

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

• 本地语言（可选）

这将替换掉Magento存储中的客户默认本地设置。

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

• ISO国家代码（可选）

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

Redecard Komerci Webservice信用卡

• 激活

用于“激活”或“停用”该方法的用法

• 显示顺序

这是在订单关闭步骤中显示的交货方法的顺序

• 标题

应显示的该方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

您必须选择该方法应功能的国家

• 信用卡类型

选择运营商允许的标志

• 可见于

确定在Magento前端和/或后端中显示此支付方法的可见性

• 验证

定义买家是否将被引导到发卡银行进行信用卡验证

对于后端下发的订单，请勿激活此选项，因为它不应将重定向到验证URL

• 激活分期付款

定义分期付款的使用

• 默认分期付款

对于“货币”列，请提供货币的缩写，例如BRL

对于“总额（含）”列，请提供显示分期付款的最小值

对于“最大分期数”列，请提供显示的分期数，直到达到显示分期付款的预定值

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

分期付款的显示规则基于价格范围

该模块已预先配置，使用以下规则

在这个规则中

0.00元至100.00元显示1期，101.00元至200.00元显示2期，201.00元至600.00元显示3期，601.00元至800.00元显示4期，801.00元至10,000.00元显示5期，10,000.00元至100,000.00元显示6期

根据需要修改

• 总金额为零时停用

当总报价为零时，请在结账时停用此支付方式。

常见问题解答“FAQ”

关于Hiper标志

由于没有读取此类卡片的库，因此如果库返回其他类型的卡，则选择此标志。如果该标志出现问题，可能需要删除标志自动选择

如果该标志出现问题，可能需要删除标志自动选择

电子商务联盟 - Redecard

http://www.komerciredecard.com.br

配置产品

在Magento后端，访问菜单：系统 -> 配置 -> Cerebrum -> 支付方式 -> Redecard -> 填写所需字段

依赖关系

要加入Redecard，您的网站必须具有安全页面(SSL128=https)。

默认情况下，Redecard释放Komerci集成，因此要将联盟迁移到Redecard Webservice，只需通过Redecard门户注册支付网关的IP地址或通过以下电子邮件发送请求： pool.credenciamento@redecard.com.br 要求注册服务器的IP地址。

模块安装后做什么？

在方法配置中，选择测试环境并填写以下数据

Código de filiação Komerci 		00000000
Usuário Komerci 				user
Senha Komerci 					pass

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

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

在测试环境中执行订单完成的操作

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

然后，将方法配置为使用生产环境

在 production 环境中完成 0.01 R$ 的订单

测试操作（沙箱）

只有 Komerci Webservice 允许进行测试。

Redecard 建议为了测试 Komerci Integrado，应在生产环境中进行购物，并在同一天执行退款。

认证流程

为了完成 Komerci Webservice 的配置，必须分析该场所是否已启用 WebService "SIM" 捕获功能以及是否已正确注册 IP。

IP 注册可以通过 Redecard 服务门户的受限区域完成，并且可以注册多达 10 个 IP。

最初，只有测试的 web 方法将可用，交易金额为 (1) 分。

为了在生产环境中提供系统，场所必须执行一系列测试，并且测试必须在 Komerci 交易报告中进行分析。

如果交易状态为 "已确认"，则表示测试成功执行。如果状态不同，则必须重新审查开发。

为了确认已完成的集成，客户必须进行 0.01 的测试购买。购买完成后，需要检查该交易是否已在其 Redecard 账户中发布。

交易模拟

https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx

https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap_teste.asmx

取消模拟

https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?op=VoidTransaction

curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'VoidTransaction' --data ' <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> soap:Body string string string string string string string </soap:Body> </soap:Envelope>' https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?wsdl

捕获模拟

https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?op=ConfPreAuthorization

curl --header 'Content-Type: text/xml;charset=UTF-8' --header 'ConfPreAuthorization' --data ' <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> soap:Body string string string string string string string string string string </soap:Body> </soap:Envelope>' https://ecommerce.userede.com.br/pos_virtual/wskomerci/cap.asmx?wsdl

错误代码的含义

请参阅集成手册以了解错误发生的原因

返回代码和消息

银行和运营商的消息是通用的，以下提供了一份包含常见错误和返回值的简短列表，其中错误可能表示的内容与我们所提及的不同。

如果您有任何疑问或错误不在列表中，请通过电话 1140014433 联系 Komerci 支持部门。

23 - 交易未授权。

联系您的托管公司并请求用于您网站的出口 IP。

请在网络门户中检查托管网站的服务器输出IP地址是否配置正确。如果使用母公司的关联访问，请在网络门户登录后，选择“数据登记 > 访问您的分支机构”菜单，并在“我的账户 > 数据登记 > 在数据登记框中点击“查询”按钮 > IP地址”菜单中选择您的Komerci关联。

如果错误持续存在，请通过电话联系Redecard支持，告知情况并请求如果需要的话，联系Redecard技术事件管理团队。

26 - 交易未授权。

此错误消息可能会在以下情况下返回

服务器输出IP地址在“网络门户”中未正确配置，请参考上述检查方法。在Magento管理中，合作伙伴数据、用户和web服务密码不正确。

27 - 无效的卡片。

所提供的卡片号码不正确，以下是一些可能的原因

Mastercard或Visa品牌卡片应为16位数字。Diners品牌卡片应具有14至16位数字。卡片数字不一致。

41 - 交易未授权。

请检查在网络门户中配置的Webservice用户是否与在Magento管理中配置的用户相同。为了在网络门户中检查，请访问“数据登记 > 访问您的分支机构”菜单，并选择您的Komerci关联。定位到“Komerci > Komerci用户 > 添加用户”。如果用户未正确注册，请删除并重新注册。

51 - 无效的场所。请联系进行销售的场所。

我们已识别到错误消息是在以下情况下返回的

场所没有接受国外发行的卡片的授权。为了确认这确实是问题，请联系Komerci Rede支持并告知您的关联。所使用的卡片未启用信用功能。如果此错误消息出现在所有订单中，则可能是场所未启用web服务管理器。管理器负责在运营商处执行取消和预授权支付。您可以通过简单测试来识别这是否是原因：在Magento管理中，在支付方式配置中标记“授权和捕获”选项。之后，进行测试订单。是否成功了？那么请与Komerci支持联系，告知您希望为您的场所启用web服务管理器。

53 - 无效的交易。请联系进行销售的场所。

交易未由发卡银行授权，可能原因：在Magento管理中配置的分期付款未在运营商处启用。缺乏限制。卡片未启用信用功能。卡片号码无效。

56 - 无效数据。请联系进行销售的场所。

支付未由发卡银行授权。

在尝试退款时返回此消息，因为

REDE结算系统理解，小于R$ 0.10的交易是测试销售，因此不进行交易的结算。

58 - 卡片问题。请检查您的卡片信息。如果错误持续存在，请联系您的卡片客户服务中心。