README

描述

安装并配置此模块后，您可以将 PagSeguro 作为支付选项添加到您的店铺。此模块使用以下 PagSeguro API 提供的功能：

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

要求

• Magento Community 2.0 | 2.1

• PHP 5.5+

• SPL

• cURL

• DOM

安装

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

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

模块安装使用 Composer。要下载和安装 Composer 到您的环境，请访问 https://getcomposer.org.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/ 目录设置权限

   • chmod -R 777 var/ pub/

更新

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

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 -> 配置。以下列出了可用的选项。

常规设置

• 环境：指定交易将在哪个环境中进行 (生产/sandbox)。
• 电子邮件：在 PagSeguro 中注册的电子邮件。
• token: 在PagSeguro注册的token。
• 重定向URL: 在PagSeguro支付流程结束后，您的客户将被自动重定向到您的商店确认页面或您在此字段中提供的URL。要启用支付结束时的重定向，需要激活通过API的支付服务。注意：此URL将自动提供，除非您希望客户重定向到其他位置，否则不应更改。
• 通知URL: 每当交易状态改变时，PagSeguro都会向您商店发送通知。模块应使用的默认值是：http://www.minhaloja.com.br/index.php/pagseguro/notification/response
  • 注意：只有在您希望收到通知的另一个位置时，才应更改此URL。
• charset: 您系统的编码（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 许可证 2.0 版（“许可证”）；除非遵守许可证规定或以书面形式达成协议，否则不得使用此文件。您可以在以下位置获取许可证副本：

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

除非适用法律要求或书面同意，否则在许可证下分发的软件按“原样”分发，不提供任何明示或暗示的保证或条件。请参阅许可证以了解管理许可权限和限制的具体语言。

注意

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

贡献

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

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