README

描述

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

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

要求

• PHP 5.4.27+
• SPL
• cURL
• DOM

安装

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

通过 Composer 安装

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

{
    "require": {
       "perfectpanel/pagseguro": "1.0"
    }
}

配置

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

• environment: 接受 production 和 sandbox 两个值。要使用 sandbox，需要在 https://sandbox.pagseguro.uol.com.br 上创建一个账户。
• email: 在 PagSeguro 上注册的电子邮件。
• token production: PagSeguro 生成的 token。
• token sandbox: Sandbox 生成的 token。
• appId production: PagSeguro 生成的应用。
• appId sandbox: Sandbox 生成的应用。
• appKey production: PagSeguro 中的应用 token。
• appKey sandbox: Sandbox 中的应用 token。
• charset: 您的系统编码（ISO-8859-1 或 UTF-8）。
• log: 启用/禁用日志生成。
• fileLocation: 您希望创建日志文件的路径。例如：/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 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
• 注意：为您的新功能添加示例。如果您的Pull Request与特定版本相关，则不应将Pull Request发送到master分支，而应发送到对应版本的分支。