README

描述

PHP 中的 PagSeguro 库是一组领域类，它简化了 PHP 开发者使用 PagSeguro 提供的 API 功能。安装并配置该库后，您可以轻松集成以下功能：

• 创建付款请求
• 创建周期性付款请求（透明签名）
• 创建订阅请求
• 取消订阅
• 查询订阅
• 通过代码查询交易
• 通过日期区间查询交易
• 接收通知

要求

• PHP 5.4.27+ || 5.5+ || 5.6+
• SPL
• cURL
• SimpleXml
• Composer

安装

注意：我们建议通过 Composer 安装。您也可以下载 zip 文件 或通过 Git 进行克隆。

通过 Composer 安装

要下载和安装 Composer，请访问 https://composer.php.ac.cn/download/，如果您对如何使用它有疑问，请查阅 Composer 官方文档。

可以通过两种方式通过 Composer 安装 pagseguro-php-sdk(pagseguro/pagseguro-php-sdk)

• 执行命令以自动添加依赖项

  php composer.phar require pagseguro/pagseguro-php-sdk
  

或者

• 将依赖项添加到您的 composer.json 文件中

  {
      "require": {
         "pagseguro/pagseguro-php-sdk" : "*"
      }
  }

手动安装

• 作为 zip 文件 下载存储库或进行克隆；
• 在您的计算机上解压缩文件；
• 在提取文件的位置执行命令 php composer.phar install。

如何使用

public 目录包含使用该库调用 PagSeguro API 的各种示例（支付、订阅、通知），而 source 目录包含库本身（源代码）。

配置

要实际使用该库，需要做一些配置。有关如何配置库的更多信息，请访问 文档。

疑问？

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

变更日志

要查看变更日志，请访问 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）。这可以防止交易产生可能的错误或中断，或者特殊字符以不同方式显示。
• 为了正常生成日志，请确保日志目录和文件具有读写权限。
• 为了使用透明结账，需要向PagSeguro团队请求激活。更多详细信息可以在如何通过PagSeguro接收支付找到。

疑问？

如有疑问，请访问我们的论坛。

贡献

发现并修复了错误，或者有想法想要贡献吗？

• 进行分支（fork）
• 添加您的功能或错误修复（git checkout -b my-new-feature）
• 提交您的更改（git commit -am '添加某些功能'）
• 将分支推送到远程（git push origin my-new-feature）
• 发送拉取请求（Pull Request）
• 注意：为您的全新功能添加示例。如果您的拉取请求与特定版本相关，则不应向master分支发送，而是向对应版本的分支发送。