README

描述

安装并配置此模块后，您可以在您的商店中提供PagSeguro作为支付选项。该模块利用PagSeguro提供的以下API功能：

• 与支付API集成
• 与通知API集成

要求

• Magento Community 2.0.8 | 2.1.0至2.1.9版本
• PHP 5.5.0+
• SPL
• cURL
• DOM

安装

强烈建议您在更新生产商店之前，在测试环境中验证更改和更新。还建议在执行任何更新/安装程序之前备份商店和重要信息。

导航到您的Magento 2安装的根目录，并按照以下步骤操作

模块的安装是通过Composer完成的。要下载并安装Composer到您的环境，请访问https://composer.php.ac.cn/download/，如有疑问，请参阅Composer官方文档。

1. 通过packagist安装
   • composer require pagseguro/magento2
     • 此时，可能需要您输入Magento的认证凭据。如有疑问，官方文档中有操作说明。
2. 执行以下命令
   • php bin/magento setup:upgrade
   • php bin/magento setup:static-content:deploy 或 php bin/magento setup:static-content:deploy pt_BR，具体取决于您的商店配置。
3. 检查并（如有必要）配置目录的正确权限。例如，为了将var/ pub/目录的权限设置为777，请执行
   • chmod 777 -R var/ pub/
4. 在过程结束时可能需要更新商店的缓存。
5. 通过商店的管理界面访问PagSeguro部分，并配置凭据和支付方式。

更新

强烈建议您在更新生产商店之前，在测试环境中验证更改和更新。还建议在执行任何更新/安装程序之前备份商店和重要信息。

PagSeguro模块的更新是通过composer完成的，并且可以根据您的偏好以多种方式执行。一种方式是使用以下命令：

1. composer update pagseguro/magento2
2. composer update pagseguro/pagseguro-php-sdk
3. php bin/magento setup:upgrade
4. php bin/magento setup:static-content:deploy 或 php bin/magento setup:static-content:deploy pt_BR，具体取决于您的商店配置。
5. 检查并（如有必要）配置目录的正确权限。
6. 在过程结束时可能需要更新商店的缓存。
7. 通过商店的管理界面访问PagSeguro部分，确认信息并配置PagSeguro及其支付方式，然后点击保存按钮。

注意事项

• 在某些情况下，Magento可能不会更新生成的静态文件，可能需要通过管理界面、终端命令或直接删除pub/static/frontend/Magento/seu_tema/seu_idioma/UOL_PagSeguro目录中的内容来更新它们。
• 然后，再次执行以下命令：php bin/magento setup:static-content:deploy 或 bin/magento setup:static-content:deploy pt_BR，具体取决于您的商店配置。

配置

要访问和配置模块，请访问菜单PagSeguro -> 设置。以下列出了可用的选项。

常规设置

• 环境：指定交易将在哪个环境中进行 （生产/沙盒）。
• 电子邮件：在PagSeguro注册的电子邮件。
• 令牌：在PagSeguro注册的令牌。
• 重定向URL：在PagSeguro支付流程结束时，您的客户将被自动重定向到您的商店的确认页面或在此字段中提供的URL。要启用支付结束时的重定向，必须启用通过API进行支付服务。注意：此URL将自动提供，您只有在希望客户被重定向到其他位置时才需要更改它。
• 通知URL：每当交易状态发生变化时，PagSeguro都会向您的商店发送通知。模块应使用以下默认值：http://www.minhaloja.com.br/index.php/pagseguro/notification/response
  • 注意：只有当您希望在其他位置接收通知时，才应更改此URL。
• 字符集：您的系统编码（ISO-8859-1或UTF-8）。
• 启用日志：启用/禁用日志生成。
• 目录：从Magento的安装根目录开始，指定您希望创建日志文件的路径和名称。例如：var/log/pagseguro.log。
  • 默认情况下，模块将配置为将日志文件保存到var/log/pagseguro.log.
• 列出放弃的交易？：启用/禁用对在PagSeguro结账过程中放弃的交易进行搜索。
• 交易 -> 放弃：允许查询在过去10天内放弃的交易，这样您可以发送销售恢复电子邮件。电子邮件将包含一个链接，将买家重定向到支付流程，正好在停止的地方。
• 启用购物车恢复：启用PagSeguro购物车恢复功能。（默认情况下已禁用）
• 列出分期付款：启用在产品查看页面显示分期付款列表。（将在产品查看页面显示该产品的最大分期付款选项）

配置结账类型：在本节中，您将配置您希望在其商店中提供的PagSeguro支付方式。

请查阅您的PagSeguro账户以了解已启用的支付方式。

• PagSeguro（标准或Lightbox）

  • 启用：启用/禁用PagSeguro支付方式（标准或Lightbox）。
  • 结账：指定将使用的结账模型。可以选择标准结账或Lightbox结账。
  • 显示名称：定义结账页面上将使用的支付方式名称。
  • 结账页面上的位置（排序顺序）：配置此支付方式在您的商店中的显示顺序。此顺序相对于您商店中配置的所有其他支付方式。
  • 为...提供折扣：启用/禁用通过支付方式结账（信用卡、支票、在线借记、银行存款和PagSeguro余额）的折扣。
  • 折扣百分比：定义将授予所选支付方式的折扣百分比（接受0.01至99.99的值）

• 透明结账 - 信用卡

  • 启用：启用/禁用透明结账 - 信用卡支付方式。
  • 显示名称：定义结账页面上将使用的此支付方式的名称。
  • 结账页面上的位置（排序顺序）：配置此支付方式在您的商店中的显示顺序。此顺序相对于您商店中配置的所有其他支付方式。

• 透明结账 - 银行支票

  • 启用：启用/禁用透明结账 - 银行支票支付方式。
  • 显示名称：定义结账页面上将使用的此支付方式的名称。
  • 结账页面上的位置（排序顺序）：配置此支付方式在您的商店中的显示顺序。此顺序相对于您商店中配置的所有其他支付方式。

• 透明结账 - 在线借记

  • 启用：启用/禁用透明结账 - 在线借记支付方式。
  • 显示名称：定义结账页面上将使用的此支付方式的名称。
  • 结账页面上的位置（排序顺序）：配置此支付方式在您的商店中的显示顺序。此顺序相对于您商店中配置的所有其他支付方式。

交易

要执行查询和其他操作，请访问PagSeguro菜单 -> 交易，其中交易可以选择以下选项：对账、已取消、取消、退款。以下是对可用选项的描述

• 已取消：允许搜索在指定搜索天数内被取消的交易。
• 取消：此搜索将返回所有状态为“分析中”和“等待支付”的交易，在指定搜索天数内。这样您可以请求取消这些交易。
• 对账：允许查询过去30天内通过PagSeguro完成的交易。搜索将返回与本地数据库中交易状态的比较以及PagSeguro中当前交易状态，这样您可以识别和更新状态不一致的交易。
• 退款：此搜索将返回所有状态为“已支付”、“可用”和“争议”的交易，在指定搜索天数内。这样您可以请求为您的买家退款。

建议在执行退款或取消功能之前，先进行对账以获取最新的状态。

输入

疑问？

如有疑问或需要支持，请访问我们的论坛。

变更日志

要查看变更日志，请访问CHANGELOG.md文件。

许可证

版权所有 2016 PagSeguro Internet LTDA。

根据Apache License，版本2.0（“许可证”）；除非符合许可证规定或书面同意，否则不得使用此文件。您可以在以下位置获得许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分发的软件按“原样”基础分发，不提供任何形式的明示或暗示保证。有关许可证中规定的权限和限制的具体语言，请参阅许可证。

备注

• PagSeguro仅接受使用巴西雷亚尔（BRL）货币进行支付。
• 请确保提供的电子邮件和令牌与具有卖家或企业配置文件的账户相关联。
• 请确保已正确设置系统编码（ISO-8859-1或UTF-8）。这可以防止交易生成错误或中断，或特殊字符以不同方式显示。
• 要正常生成日志，请确保日志目录和文件的读写权限。

贡献

发现了错误或有一些功能想法并想贡献力量？

• 进行分支。
• 添加您的功能或错误修复。
• 在GitHub上发送拉取请求。
• 注意：拉取请求不应发送到master分支，而应发送到对应版本或开发分支。