README

Mozg\Redecard

概述

集成到 Redecard

动机

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

演示

支持/疑问

为了获得必要的支持，请点击此处 Clique aqui，尽可能详细地报告发生的原因，并附上屏幕截图以供理解

价格

点击此处

模块资源

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

技术特性

在结账过程中进行授权过程

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

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

通过 CRON 应处理交易通知

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

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

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

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

设置 CRON

使用此方法需要为 Magento 激活 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的环境下查看该扩展是否在您的服务器上激活

请检查您的项目根目录下是否存在phpinfo.php文件

<?php phpinfo(); ?>

如果您的Magento项目根目录下不存在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_56.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_56: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_56

要禁用模块

在执行涉及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 执行的通知处理过程中执行

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

• 创建待处理账单（仅适用于手动捕获）

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

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

• 订单状态：发货时捕获

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

• 启用取消订单

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

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

激活/停用取消订单时的自动退款

• 账单电子邮件

激活/停用电子邮件更新

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

激活/停用订单状态更新电子邮件，通知客户所有更改

• 激活调试日志

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

文件

DATE_mozg.log

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

文件

payment_METHOD.log

高级：Redecard 通知

• 忽略退款通知

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

高级：结账体验

• 取消支付后重定向目标

确定购买者在取消支付后如何被重定向。

• 支付方法渲染方法

确定支付方式是否显示为您的标志或仅显示名称。

• 本地语言（可选）

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

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

• ISO国家代码（可选）

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

Redecard Komerci Webservice信用卡

• 激活

用于“激活”或“禁用”该方法的使用

• 显示顺序

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

• 标题

应显示的该方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

您必须选择该方法应该适用于哪些国家

• 信用卡类型

选择运营商允许的标志

• 可见于

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

• 认证

定义买家是否将被引导到发卡银行进行卡片认证

对于后端制作的订单，不要激活此选项，因为不应将URL重定向到认证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期

根据需要更改

• 禁用总金额为零时

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

常见问题“FAQ”

关于Hiper标志

由于没有库可以读取此类卡片，因此如果库返回其他类型的卡片，则选择此标志。基于hipercard标志的验证器被包括在内

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

电子商务会员 - 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 环境中执行 R$ 0,01 的订单完成操作

测试操作（沙盒）

只有 Komerci Webservice 允许进行测试。

Redecard 建议在测试 Komerci Integrado 时，在 production 环境中进行购买，并确保在同一天内执行退款。

认证流程

为了完成 Komerci Webservice 的配置，需要检查机构是否已启用 WebService 捕获功能“是”以及 IP 是否已正确注册。

IP 注册可以通过 Redecard 服务的门户在受保护区域进行，最多可以注册 10 个 IP。

最初，仅提供测试的 web 方法，交易金额为（1）一分钱。

为了将系统部署到 production，机构必须进行一系列测试，并且必须在 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

错误代码的含义

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

Rede 代码和返回消息

银行和运营商的消息是通用的，以下提供了一份常见错误和返回的简短列表，其中某个错误可能意味着与我们所提到的不同的事情。

如果您有疑问或错误不在列表中，请联系 Komerci 支持电话 1140014433

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网络支持并告知您的分支机构。使用的卡没有启用信用功能。如果此错误消息出现在所有订单中，则机构可能没有启用web服务管理器。管理器负责在运营商处执行取消操作和预先授权支付。您可以通过以下简单测试来确定这是否是原因：在Magento的管理中，在“网络支付方式”配置中标记“授权和捕获”选项。之后进行测试订单。是否成功？然后联系Komerci支持并告知您希望为您的机构启用web服务管理器。

53 - 无效的交易。请联系执行销售的机构。

交易未获得发卡银行授权，可能原因：在Magento管理中配置的分期支付在运营商处未启用。缺少限额。卡未启用信用功能。卡号无效。

56 - 无效数据。请联系执行销售的机构。

支付未获得发卡银行的授权。

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

REDE结算系统认为低于R$ 0.10的交易是测试销售，因此不会执行这些交易的结算。

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