README

PAGSEGURO 插件

v 2.1.1

该插件方便将 PagSeguro 支付集成到基于 CakePHP 2.x 开发的应用中。该插件仅负责与 PagSeguro 支付 API 进行接口对接，因此插件和 PagSeguro 均不对因不符合 PagSeguro 提供的文档而使用负责。具体信息应严格由创建购物车结账请求的程序员负责，详情请参考 PagSeguro 的集成指南https://pagseguro.uol.com.br/v2/guia-de-integracao/visao-geral.html。

安装

Composer

{
    "require": {
        "andrebian/pag_seguro": "dev-master"
    }
}

或选择特定版本

{
    "require": {
        "andrebian/pag_seguro": "2.0.0"
    }
}

更多

{
    "require": {
        "andrebian/pag_seguro": "*"
    }
}

###非常重要

默认情况下，CakePHP 2.x 在 app/Plugin/ 目录中使用插件，但通过 composer 直接安装时，插件将被安装到应用根目录的 Plugin/ 中，而不是 app/Plugin/。有两种解决方案，第一种是在 composer.json 文件中直接定义，第二种是告知新的插件访问点。下面将分别介绍这两种方法。

###选项 1 - 通过 composer.json 定义

在您的 composer.json 文件中，请输入以下内容

"extra": {
    "installer-paths": {
        "app/Plugin/PagSeguro": ["andrebian/pag_seguro"]
    }
}

###选项 2 - 在 bootstrap.php 中告知

您可以在 bootstrap.php 中告知新的插件访问点，这样 Cake 2.x 将在以下位置查找插件：Plugin/ 和 app/Plugin/。

App::build(array('Plugin' => array(ROOT . '/Plugin/', ROOT . '/app/Plugin/')));

选择此选项后，可以忽略第一种方法。

有关这些选项的更多信息，请参阅我博客上的这篇文章，并查看文末提到的 Debug Kit issue，其中 @markstory, @ADmad 和 @ceeram 解释了 Cake 的原因和结构，并建议使用 bootstrap.php 选项：http://www.andrebian.com/cakephp-e-composer/

##注意

不再提供直接下载或作为子模块使用的支持。由于依赖于 PagSeguro 官方 API，正确安装应通过 composer 进行。如果您想这样做（clone、zip 或子模块），请随意，但请注意，我无法提供支持，因为唯一满足所有依赖的方式是上述方式。

配置

加载插件

在 bootstrap.php 文件中添加对插件的支撑： CakePlugin::load('PagSeguro'); 或 CakePlugin::loadAll();

凭证

您需要在 PagSeguro 上有一个账户，因为您需要设置凭证，这些凭证由您的电子邮件和 PagSeguro 集成部分中设置的 token 组成。

配置可以通过以下两种方式完成：通过 bootstrap 或在所需的控制器中。

bootstrap 文件

Configure::write('PagSeguro', array(
    'email' => 'seu-email-cadastrado@pagseguro',
    'token' => 'seu-token',
    'isSandbox' => true, // true|false
));

任何控制器，其中将设置购买完成

$this->Checkout->defineCredenciais('email cadastrado', 'token gerado');

加载组件

现在您已经配置了凭证，应在 AppController 或将使用组件的控制器中定义。

public $components = array('PagSeguro.PagSeguro', 'PagSeguro.Checkout', 'PagSeguro.Retorno');

如果您已经拥有更多组件，请按以下方式操作

public $components = array('Outros componentes', 'PagSeguro.PagSeguro', 'PagSeguro.Checkout', 'PagSeguro.Retorno');

不要忽略 'PagSeguro.PagSeguro' 的使用。

使用

• 支付请求：请参阅REQUISICAO_PAGAMENTO 文件
• 支付请求返回：请阅读文件 CONSULTA
• 按代码查询：请阅读文件 CONSULTA
• 按时间段查询：请阅读文件 CONSULTA
• 查询已弃置的交易：请阅读文件 CONSULTA
• 通知：请阅读文件 NOTIFICACAO

##TODO

• 测试

##PROBLEMAS

在这里报告它们 https://github.com/andrebian/cake-plugin-pagseguro/issues?state=open

##CONTRIBUIDORES

• Marcelo Siqueira - https://github.com/marcelosiqueira

##注意：许多开发者使用了示例中的个人邮箱进行购买，我恳请各位请使用您的邮箱进行购买测试，我已经帮助了插件，无法再通过检查邮箱和提供报告来帮助。

非常感谢。