README

Mozg\Redecard

简介

集成到Redecard

动机

满足市场对Magento模块的需求，提供改进和卓越的支持

演示

支持/疑问

要获取适当的支持，请点击此处，尽可能详细地描述发生的原因，并附上屏幕截图以便我们理解

价格

点击此处

模块资源

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

技术特性

在结账时执行授权流程

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

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

通过CRON应处理交易通知

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

在发货商品之前，始终检查订单信息，如果交易状态显示支付已被确认，包括与金融机构的确认，如果捕获了交易，如果出现任何不一致，则必须取消订单直到问题得到纠正

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

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

设置CRON

为了使用此方法，需要为Magento激活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环境中该扩展是否激活：

请检查您的项目根目录下是否存在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_72.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_72: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_72

为了禁用模块：

在进行任何涉及更新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 信用卡

• 激活

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

• 显示顺序

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

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 信用卡类型

选择运营商允许的标志

• 可见性

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

• 认证

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

对于在后台创建的订单，不要激活此选项，因为不应将重定向到认证 URL

• 激活分期付款

定义分期付款的使用

• 默认分期付款

在“货币”列中，请输入货币缩写，例如 BRL

在“总额（含）”列中，请输入显示分期的最低金额

在“最大分期数”列中，请输入显示分期的最大分期数

在“利率（% 0.0）”列中，请输入使用的利率

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

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

在这个规则中

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

根据您的需求进行修改

• 总金额为零时停用

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

常见问题解答 "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

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

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

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

在生产环境中执行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

错误代码的含义

请在集成手册中查看错误发生的原因

Redecard代码和返回消息

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

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

23 - 交易未授权。

请联系您的托管公司，并索取用于您网站的出口IP地址。

请检查网络门户，确保托管网站的服务器出口IP地址配置正确。如果是通过总部进行关联访问，请登录网络门户，选择“数据登记 > 您的分支机构访问”菜单，然后在“我的账户 > 登记信息 > 在‘数据登记’框中点击‘查询’按钮 > IP地址”菜单中选择您的Komerci分支机构。

如果错误持续存在，请通过电话联系Redecard的客服，告知情况，并要求如果需要，由Redecard的技术事件管理团队打开一个工单。

26 - 交易未授权。

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

服务器出口IP地址在网络门户上配置不正确，请参考上述项目如何检查其正确性。在Magento管理中，合作伙伴协议、用户名和密码的Web服务数据不正确。

27 - 卡片无效。

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

Mastercard或Visa品牌卡必须是16位数字。Diners品牌卡必须包含14到16位数字。卡片数字不一致。

41 - 交易未授权。

请检查网络门户上配置的Webservice用户是否与在Magento管理中配置的一致。要检查网络门户，请访问“数据登记 > 您的分支机构访问”，选择您的Komerci分支机构。在“我的账户 > 登记信息 > 在‘数据登记’框中点击‘查询’按钮 > IP地址”中找到“Komerci > Komerci用户 > 注册用户”。如果用户没有正确注册，请将其删除并重新注册。

51 - 机构无效。请与进行销售交易的机构联系。

我们已识别到当以下情况发生时，该错误信息返回：

该机构没有获得接受国外发行卡片的授权。为了确认问题是否真的是这样，请联系Komerci网络支持并告知您的分支机构。使用的卡片没有启用信用卡功能。如果此错误信息出现在所有订单中，则可能是机构未启用Web服务管理器。管理器负责在运营商处执行取消和预授权支付。您可以通过一个简单的测试来识别这是否是原因：在Magento的管理中，在支付方式配置的Rede设置中标记“授权和捕获”选项。然后执行一个测试订单。它正常工作了吗？然后联系Komerci支持并告知您希望为您的机构启用Web服务管理器。

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

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

56 - 数据无效。请与进行销售交易的机构联系。

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

在尝试退款时返回此信息是因为

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

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