README

Mozg\Pagseguro

简介

与Pagseguro API集成

动机

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

演示

支持/疑问

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

价格

点击此处

模块资源

[✓] 交易
[✓] 查询

技术特性

在结账时执行授权过程

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

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

通过CRON应处理交易通知

在处理通知时，如果付款已确认，则应将订单的“状态/状态”更改为“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-pagseguro-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-pagseguro-php_72

要禁用模块：

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

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

如何配置支付方式

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

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

您将看到以下字段：

Pagseguro API V2 - 默认设置

必要设置

• 测试模式或生产模式

应提供相应的环境信息

• 测试环境的电子邮件

测试环境的电子邮件

• 测试环境的token

测试环境用的token

• 生产环境用的邮箱

生产环境用的邮箱

• 生产环境用的token

生产环境用的token

高级：Magento订单处理

• 订单状态：创建订单

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

• 订单状态：支付授权

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

• 订单状态：支付确认

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

• 订单状态：取消订单

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

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

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

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

• 订单状态：退款

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

• 订单状态：部分退款

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

• 订单状态：待处理订单

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

• 捕获类型

需要使用此自动化处理CRON执行的通知时，应选择“自动”选项

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

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

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

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

• 在发货时捕获

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

• 启用取消订单

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

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

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

• 账单邮箱

启用/禁用电子邮件更新

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

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

• 启用调试日志

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

文件

DATE_mozg.log

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

文件

payment_METHOD.log

高级：Pagseguro通知

• 忽略退款通知

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

高级：结账体验

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

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

• 支付方式渲染方式

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

• 本地语言（可选）

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

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

• ISO国家代码（可选）

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

Pagseguro信用卡

• 激活

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

• 显示顺序

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

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 信用卡类型

选择运营商允许的标志

• 可见性

确定在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期

根据您的需求进行更改

• 总金额为零时禁用

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

Pagseguro借记卡

• 激活

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

• 显示顺序

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

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 借记卡类型

选择运营商允许的标志

• 可见性

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

• 激活分期付款

定义分期付款的用法

• 默认分期付款

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

在“金额（含）”列中，输入显示分期付款的金额

在“最大分期数”列中，输入要显示的分期数，直到达到显示分期付款的先前通知的金额

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

• 总金额为零时禁用

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

Pagseguro汇票

• 激活

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

• 显示顺序

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

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 汇票类型

选择运营商允许的标志

• 订单未支付状态

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

• 订单支付超额状态

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

• 可见性

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

Pagseguro电子转账

• 激活

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

• 显示顺序

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

• 标题

要显示的方法名称

• 适用于国家的支付方式

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

• 特定国家的支付方式

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

• 电子转账类型

选择运营商允许的标志

• 订单未支付状态

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

• 订单支付超额状态

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

• 可见性

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

常见问题解答（FAQ）

模块安装后应做什么？

针对测试环境

https://pagseguro.uol.com.br/

然后访问

https://sandbox.pagseguro.uol.com.br/vendedor/configuracoes.html

在此环境中会显示token

然后访问

https://sandbox.pagseguro.uol.com.br/comprador-de-testes.html

始终使用这些买家和信用卡数据用于测试

对于标准方法和lightbox，访问

https://sandbox.pagseguro.uol.com.br/transacoes/configuracoes.html

并设置状态

对于透明方法，访问

https://sandbox.pagseguro.uol.com.br/transacoes/configuracoes.html

并且不要设置您的交易将具有的状态

针对生产环境

https://pagseguro.uol.com.br/

然后访问

https://pagseguro.uol.com.br/preferencias/integracoes.jhtml

在此环境中会显示token

为了测试效果，创建一个价值R$1.00的产品，并使用有效的信用卡完成交易

交易状态：已取消：交易在未完成前被取消。

根据

https://pagseguro.uol.com.br/v2/guia-de-integracao/api-de-notificacoes.html#!rmcl

当买家选择使用信用卡支付而支付未获得PagSeguro或运营商批准时，也会发生这种情况。

如何更改方法图片

可以添加以下任何一种命名的图片

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

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

/skin/frontend//default/images/mozg_pagseguro

联系信息 - Pagseguro

要联系Pagseguro

手册

https://dev.pagseguro.uol.com.br/documentacao

https://dev.pagseguro.uol.com.br/documentacao/pagamento-online/pagamentos

https://dev.pagseguro.uol.com.br/documentacao/pagamento-online/pagamentos/pagamento-transparente

贡献者

Mozg 团队

许可

商业许可

徽章

🐈

mozgbrasil / magento-pagseguro-php_72

维护者

详细信息

README

Mozg\Pagseguro

简介

动机

演示

支持/疑问

价格

模块资源

技术特性

设置Cron

在Heroku上进行测试

安装 - 更新 - 卸载 - 禁用

要安装模块，请在服务器的项目目录中使用以下命令：

要更新模块，请在服务器的项目目录中使用以下命令：

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

要禁用模块：

如何配置支付方式

Pagseguro API V2 - 默认设置

必要设置

• 测试模式或生产模式

• 测试环境的电子邮件

• 测试环境的token

• 生产环境用的邮箱

• 生产环境用的token

高级：Magento订单处理

• 订单状态：创建订单

• 订单状态：支付授权

• 订单状态：支付确认

• 订单状态：取消订单

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

• 订单状态：退款

• 订单状态：部分退款

• 订单状态：待处理订单

• 捕获类型

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

• 在发货时捕获

• 启用取消订单

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

• 账单邮箱

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

• 启用调试日志

高级：Pagseguro通知

• 忽略退款通知

高级：结账体验

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

• 支付方式渲染方式

• 本地语言（可选）

• ISO国家代码（可选）

Pagseguro信用卡

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 信用卡类型

• 可见性

• 认证

• 激活分期付款

• 默认分期付款

• 总金额为零时禁用

Pagseguro借记卡

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式

• 借记卡类型

• 可见性

• 激活分期付款

• 默认分期付款

• 总金额为零时禁用

Pagseguro汇票

• 激活

• 显示顺序

• 标题

• 适用于国家的支付方式

• 特定国家的支付方式