izapbrasil/pagseguro-php

PagSeguro 集成库

2.7.5 2018-06-14 13:18 UTC

README

Este é um fork da biblioteca original do PagSeguro (pagseguro/php 2.7.1).
O objetivo é apenas a correção de erros críticos até a migração para a nova versão.

该库已过时。请使用可在 https://github.com/pagseguro/php3 找到的新版本。

Code Climate

描述

PHP 版本的 PagSeguro 库是一套域类集合,它简化了 PHP 开发者使用 PagSeguro 提供的 API 功能。安装并配置该库后,您可以轻松集成以下功能:

要求

安装

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

通过 Composer 安装

{
    "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:激活/禁用日志生成。
  • fileLocation:希望创建日志文件的本地。例如:/logs/ps.log。

更多信息请参阅官方文档

疑问?

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

变更日志

2.7.5

  • 添加了对TLS 1.2的支持

2.7.4

  • 改进了类到字符串的转换

2.7.3

  • 修复了地址字段的长度限制
  • 修复了项目描述的长度限制

2.7.2

  • 修复了静态方法调用

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

  • 添加了发送通知请求的处理功能。
  • 新增:为helper处理数据添加新功能。
  • 修正:修正了结账请求中发送者名称的双空格处理。

2.1.4

  • 新增:添加了处理交易中允许货币的类。

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)
  • 发送拉取请求
  • 注意:为您的新的功能添加示例。如果您的拉取请求与特定版本相关,请不要向 master 分支发送拉取请求,而是向对应版本的分支发送。