README

###此库已过时。请使用可用的最新版本，见 https://github.com/pagseguro/pagseguro-php-sdk

PagSeguro for PHP集成库

描述

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

• 创建 支付请求
• 创建 订阅请求
• 取消 订阅
• 查询 订阅
• 查询 交易（按代码）
• 查询 交易（按日期范围）
• 查询 已放弃的交易
• 接收 通知

要求

• PHP 5.4.27+
• SPL
• cURL
• DOM

安装

• 下载仓库作为zip文件或克隆它；
• 在您的计算机上解压缩文件；
• 在 source 目录中存在两个目录： examples 和 PagSeguroLibrary。 examples 目录包含使用API的调用示例，而 PagSeguroLibrary 目录包含实际的库。如果您只想导入库，请上传 PagSeguroLibrary 目录，并在您的项目中包含 PagSeguroLibrary.php 类。这个类将负责在其系统中导入库的所有功能。

通过Composer安装

• 或者，可以使用Composer来加载库 (pagseguro/php)。

{
    "require": {
       "pagseguro/php": "@stable"
    }
}

配置

要真正使用此库，需要在 'config' 目录中的 'PagSeguroConfig.php' 文件中进行一些配置。下面列出了可用的选项。

• environment: 接受 production 和 sandbox 值。要使用 sandbox，需要在 https://sandbox.pagseguro.uol.com.br 创建一个账户。
• 电子邮件：在PagSeguro上注册的电子邮件。
• 令牌生成：在PagSeguro生成的令牌。
• 沙盒令牌：在沙盒中生成的令牌。
• 生产appId：在PagSeguro生成的应用程序。
• 沙盒appId：在沙盒中生成的应用程序。
• 生产appKey：在PagSeguro的应用程序令牌。
• 沙盒appKey：在沙盒中的应用程序令牌。
• 字符集：您系统的编码（ISO-8859-1或UTF-8）。
• 日志：激活/禁用日志生成。
• 文件位置：您希望创建日志文件的本地位置。例如：/logs/ps.log。

更多信息可在官方文档中找到。

疑问？

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

变更日志

2.7.1

• 可定义无息分期付款。
• 一般调整。

2.7.0

• 通过通知代码进行订阅查询（预批准）服务集成。

2.6.0

• Laravel 5集成环境变量 #0a2c2ba
• 配置文件包装器 #c1b0985
• 实施订阅API #7cd8147
• 与取消请求服务集成。
• 一般调整。
• 注意：所描述的一些功能尚未对所有卖家商业上可用。如有疑问，请访问我们的论坛。

2.5.0

• 在请求结账代码时，可以通过支付方式定义折扣 - 请参阅createPaymentRequest.php示例。

2.4.0

• 通过参考代码查询/授权交易服务集成。
• 与应用程序模板服务集成。
• 与退款请求服务集成。
• 一般调整。
• 注意：上述描述的功能尚未对所有卖家商业上可用。如有疑问，请访问我们的论坛。

2.3.0

• 添加了用于使用透明结账的类和方法。
• 通知代码和交易代码的查询现在使用新的API版本。

2.2.4

• 在PagSeguroConfig类中添加了setEnvironment方法。
• 改进了文档/代码注释。
• 各种调整。

2.2.3

• 代码调整。

2.2.2

• 添加环境沙盒。

2.2.1

• 调整了在向PagSeguro发出请求时返回的XML的处理。

2.2.0

• 注册交易时，可以仅获取结账代码以用于结账lightbox（请参阅createPaymentRequestLightbox.php示例）。注意：此功能目前尚未对所有卖家商业上可用。

2.1.9

• 代码的美观改进，如缩进/格式化。

2.1.8

• 更新了支付方式代码。
• 提高了最小要求的功能识别。
• 提高了地址相关数据的处理。

2.1.7

• 添加了用于处理元数据和通用参数的类。

2.1.6

• 添加了用于处理发送者文档的类，例如CPF。

2.1.5

• 添加了通过结账请求发送通知URL的功能。
• 在helper中添加了新的数据处理功能。
• 修复：结账请求中的发送者名称处理了双空格。

2.1.4

• 添加了用于处理与PagSeguro交易相关的货币的类。

2.1.3

• 修复：如果生成日志处于活动状态且用户没有生成日志的文件或没有对文件的读写权限，请求将中止。

2.0.0 - 2.1.2

• 表示支付、通知和交易的域类。
• 通过API创建结账。
• 控制器用于处理由PagSeguro发送的支付通知。
• 交易查询模块。

许可证

版权所有 2013 PagSeguro Internet LTDA。

根据Apache许可证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 'Added some feature'）
• 推送分支（git push origin my-new-feature）
• 发送Pull Request
• 注意：为您的新功能添加示例。如果您的Pull Request与特定版本相关，则不应将Pull Request发送到master分支，而应发送到相应的版本分支。