README

描述

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 上创建一个账户。
• 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

• 在注册交易时，可以仅获取结账代码用于在轻量级结账窗口中使用（请参阅示例 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 '添加了一些功能'）
• 将分支推送到远程（git push origin my-new-feature）
• 发送 Pull Request
• 注意：为您的新功能添加示例。如果您的 Pull Request 与特定版本相关，则不应将 Pull Request 发送到 master 分支，而应发送到对应版本的分支。