README

描述

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

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

要求

• Magento Community 2.0.8 | 2.1.0
• 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 部分，并配置您的凭据和付款方式。

更新

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

通过 composer 更新 PagSeguro 模块，可以根据您的喜好使用多种方式。一种方式是使用以下命令：

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 的值）

• 透明结账 - 信用卡

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

• 透明结账 - 银行汇票

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

• 透明支付 - 在线借记

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

交易

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

• 已放弃：允许在指定查询天数内搜索已放弃的交易。
• 取消：此查询将返回所有状态为“待审核”和“待支付”的交易，在指定查询天数内。这样您可以请求取消这些交易。
• 对账：允许查询 PagSeguro 上过去 30 天内完成的交易。查询将返回与本地数据库中交易状态以及 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）。这将防止交易产生错误或中断，或导致特殊字符以不同于常规的方式显示。
• 要正常生成日志，请确保日志目录和文件具有读取和写入权限。

贡献

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

• 进行 fork。
• 添加您的功能或错误修复。
• 在 GitHub 上发送 pull request。
• 注意：Pull Request 不应发送到 master 分支，而应发送到对应版本的分枝或开发分支。