与PagSeguro集成的库

2.7.1 2016-01-28 20:17 UTC

README

此库已弃用。请使用以下可用的新版本: https://github.com/pagseguro/pagseguro-php-sdk

PHP的PagSeguro集成库

Code Climate

描述

PHP PagSeguro库是一组领域类,它简化了PHP开发人员使用PagSeguro提供的API功能的操作。安装和配置库后,您可以轻松集成以下功能:

要求

安装

  • 将仓库作为zip文件下载或进行克隆;
  • 在您的计算机上解压缩文件;
  • source 目录中存在两个目录:examplesPagSeguroLibrary。目录 examples 包含使用API的调用示例,而目录 PagSeguroLibrary 包含库本身。如果您只想导入库,请上传 PagSeguroLibrary 目录并将 PagSeguroLibrary.php 类包含到您的项目中。该类将负责在其系统中导入库的所有功能。

通过Composer安装

  • 另一种方法是使用 Composer 来加载库 (pagseguro/php)。
    {
      "require": {
         "pagseguro/php": "@stable"
      }
    }
    

配置

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

  • environment:接受值 productionsandbox。要使用 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:启用/禁用日志生成。
  • 文件位置:希望创建日志文件的本地位置。例如:/logs/ps.log。

更多详细信息请参阅官方文档

疑问?

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

变更日志

2.7.1

  • 可以定义无息分期。
  • 整体调整。

2.7.0

  • 通过通知代码集成订阅查询(PreApproval)服务。

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

  • 添加环境变量 sandbox

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发送的支付通知的Controller。
  • 交易查询模块。

许可证

版权所有 2013 PagSeguro Internet LTDA。

根据Apache许可证版本2.0(“许可证”)许可;除非适用法律要求或书面同意,否则不得使用此文件,除非遵守许可证。您可以在以下位置获得许可证副本:

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意,否则在许可证下分发的软件按“原样”基础分发,不提供任何明示或暗示的保证或条件。请参阅许可证了解具体的管理许可和限制。

注意事项

  • PagSeguro 仅接受使用巴西雷亚尔(BRL)货币的支付。
  • 请确保提供的电子邮件和令牌与具有卖家或企业配置文件的账户相关联。
  • 请确保已正确设置字符集,以符合系统的编码(ISO-8859-1 或 UTF-8)。这可以防止交易产生可能的错误或中断,或者特殊字符以不同于常规的方式显示。
  • 为了正常生成日志,请确保日志目录和文件具有读写权限。
  • 要使用透明结账,需要向 PagSeguro 团队提出激活请求,更多信息请参阅 如何通过 PagSeguro 接收支付

疑问?

如有疑问,请访问我们的 论坛

贡献

发现并修复了 bug,或者有某个特性想法,希望贡献力量吗?

  • 进行 fork
  • 添加您的特性或 bug 修复(git checkout -b my-new-feature)
  • 提交您的更改(git commit -am '添加了一些特性')
  • 将更改推送到分支(git push origin my-new-feature)
  • 发送 Pull Request
  • 注意:为您的特性添加示例。如果您的 Pull Request 与特定版本相关,则不应发送到 master 分支,而是发送到对应版本的分支。