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": {
       "perfectpanel/pagseguro": "1.0"
    }
}

配置

要实际使用该库，需要在'config'目录下的'PagSeguroConfig.php'文件中进行一些配置。下面的选项将进行描述。

• 环境：接受production和sandbox值。要使用sandbox，需要在https://sandbox.pagseguro.uol.com.br创建一个账户。
• 电子邮件：在PagSeguro上注册的电子邮件。
• 生产环境token：PagSeguro生成的token。
• 沙盒token：沙盒生成的token。
• 生产环境appId：PagSeguro生成的应用。
• 沙盒appId：沙盒生成的应用。
• 生产环境appKey：PagSeguro中的应用token。
• 沙盒appKey：沙盒中的应用token。
• 字符集：您的系统编码（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 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分支，而应发送到对应版本的分支。